mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
1048d67c76
This implements a client for DHCPv6 IA_PD (Identity Association for Prefix Delegation). Goal was to have a IETF-compliant alternative to UHCP. The implementation was based on RFC 8415.
223 lines
7.5 KiB
C
223 lines
7.5 KiB
C
/*
|
|
* Copyright (C) 2018 Freie Universität Berlin
|
|
*
|
|
* This file is subject to the terms and conditions of the GNU Lesser
|
|
* General Public License v2.1. See the file LICENSE in the top level
|
|
* directory for more details.
|
|
*/
|
|
|
|
/**
|
|
* @ingroup net_dhcpv6
|
|
* @{
|
|
*
|
|
* @file
|
|
* @brief Internal DHCPv6 definitions
|
|
* @note This header is based on [RFC 8415](https://tools.ietf.org/html/rfc8415)
|
|
*
|
|
* @author Martine Lenders <m.lenders@fu-berlin.de>
|
|
*/
|
|
#ifndef PRIV_DHCPV6_H
|
|
#define PRIV_DHCPV6_H
|
|
|
|
#include <stdint.h>
|
|
|
|
#include "byteorder.h"
|
|
#include "net/ipv6/addr.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
/**
|
|
* @name DHCPv6 multicast addresses
|
|
* @see [RFC 8415, section 7.1]
|
|
* (https://tools.ietf.org/html/rfc8415#section-7.1)
|
|
* @{
|
|
*/
|
|
/**
|
|
* @brief Multicast address used by clients to communicate with neighboring
|
|
* relay agents and servers
|
|
*
|
|
* @note Corresponds with `All_DHCP_Relay_Agents_and_Servers` in the draft.
|
|
*
|
|
*/
|
|
#define DHCPV6_ALL_RELAY_AGENTS_AND_SERVERS { 0xff, 0x02, 0x00, 0x00, \
|
|
0x00, 0x00, 0x00, 0x00, \
|
|
0x00, 0x00, 0x00, 0x00, \
|
|
0x00, 0x01, 0x00, 0x02 \
|
|
}
|
|
/** @} */
|
|
|
|
/**
|
|
* @name DHCPv6 transmission and retransmission parameters
|
|
* @see [RFC 8415, section 7.6]
|
|
* (https://tools.ietf.org/html/rfc8415#section-7.6)
|
|
* @{
|
|
*/
|
|
#define DHCPV6_SOL_MAX_DELAY (1U) /**< SOL_MAX_DELAY (in sec) */
|
|
#define DHCPV6_SOL_TIMEOUT (1U) /**< SOL_TIMEOUT (in sec) */
|
|
#define DHCPV6_SOL_MAX_RT (3600U) /**< SOL_MAX_RT (in sec) */
|
|
|
|
#define DHCPV6_REQ_TIMEOUT (1U) /**< REQ_TIMEOUT (in sec) */
|
|
#define DHCPV6_REQ_MAX_RT (30U) /**< REQ_MAX_RT (in sec) */
|
|
#define DHCPV6_REQ_MAX_RC (10U) /**< REQ_MAX_RC */
|
|
|
|
#define DHCPV6_REN_TIMEOUT (10U) /**< REN_TIMEOUT (in sec) */
|
|
#define DHCPV6_REN_MAX_RT (600U) /**< REN_MAX_RT (in sec) */
|
|
|
|
#define DHCPV6_REB_TIMEOUT (10U) /**< REB_TIMEOUT (in sec) */
|
|
#define DHCPV6_REB_MAX_RT (600U) /**< REB_MAX_RT (in sec) */
|
|
/** @} */
|
|
|
|
#define DHCPV6_DUID_MAX_LEN (128U) /**< maximum length of DUID */
|
|
|
|
/**
|
|
* @name DHCPv6 message formats
|
|
* @{
|
|
*/
|
|
/**
|
|
* @brief Client/Server message header
|
|
* @see [RFC 8415, section 8]
|
|
* (https://tools.ietf.org/html/rfc8415#section-8)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
uint8_t type; /**< message type (see [DHCPv6 messeg types ](@ref net_dhcp6_msg_types)) */
|
|
uint8_t tid[3]; /**< transaction ID */
|
|
} dhcpv6_msg_t;
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief Generic storage DUID
|
|
*/
|
|
typedef union {
|
|
uint8_t u8[DHCPV6_DUID_MAX_LEN]; /**< array representation */
|
|
dhcpv6_duid_l2_t duid_l2; /**< DUID-L2 type */
|
|
} dhcpv6_duid_t;
|
|
/** @} */
|
|
|
|
/**
|
|
* @name DHCPv6 options
|
|
* @{
|
|
*/
|
|
/**
|
|
* @brief General DHCPv6 option format
|
|
* @see [RFC 8415, section 21.1]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.1)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
network_uint16_t type; /**< [option code](@ref net_dhcp6_opt_codes) */
|
|
network_uint16_t len; /**< length of dhcpv6_opt_t::data in byte */
|
|
uint8_t data[]; /**< option data */
|
|
} dhcpv6_opt_t;
|
|
|
|
/**
|
|
* @brief DHCPv6 client or server identifier option format
|
|
* @see [RFC 8415, section 21.2]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.2)
|
|
* @see [RFC 8415, section 21.3]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.3)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
network_uint16_t type; /**< @ref DHCPV6_OPT_CID or DHCPV6_OPT_SID */
|
|
network_uint16_t len; /**< length of dhcpv6_opt_t::duid in byte */
|
|
uint8_t duid[]; /**< the DUID of the client or server */
|
|
} dhcpv6_opt_duid_t;
|
|
|
|
/**
|
|
* @brief DHCPv6 option request option format
|
|
* @see [RFC 8415, section 21.7]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.7)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
network_uint16_t type; /**< @ref DHCPV6_OPT_ORO */
|
|
network_uint16_t len; /**< 2 * number of dhcpv6_opt_oro_t::opt_codes */
|
|
network_uint16_t opt_codes[]; /**< option-code for an option requested by the client */
|
|
} dhcpv6_opt_oro_t;
|
|
|
|
/**
|
|
* @brief DHCPv6 preference option format
|
|
* @see [RFC 8415, section 21.8]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.8)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
network_uint16_t type; /**< @ref DHCPV6_OPT_PREF */
|
|
network_uint16_t len; /**< always 1 */
|
|
uint8_t value; /**< preference value for the server */
|
|
} dhcpv6_opt_pref_t;
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief DHCPv6 elapsed time option format
|
|
* @see [RFC 8415, section 21.9]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.9)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
network_uint16_t type; /**< @ref DHCPV6_OPT_ELAPSED_TIME */
|
|
network_uint16_t len; /**< always 2 */
|
|
/**
|
|
* @brief amount of time since client began current DHCPv6 transaction
|
|
* (in cs) */
|
|
network_uint16_t elapsed_time;
|
|
} dhcpv6_opt_elapsed_time_t;
|
|
|
|
/**
|
|
* @brief DHCPv6 status code option format
|
|
* @see [RFC 8415, section 21.13]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.13)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
network_uint16_t type; /**< @ref DHCPV6_OPT_STATUS */
|
|
network_uint16_t len; /**< 2 + length of dhcpv6_opt_status_t::msg in byte */
|
|
network_uint16_t code; /**< [status code](@ref net_dhcp6_status_codes) */
|
|
char msg[]; /**< UTF-8 encoded text string (not 0-terminated!) */
|
|
} dhcpv6_opt_status_t;
|
|
|
|
/**
|
|
* @brief DHCPv6 identity association for prefix delegation option (IA_PD)
|
|
* format
|
|
* @see [RFC 8415, section 21.21]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.21)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
network_uint16_t type; /**< @ref DHCPV6_OPT_IA_PD */
|
|
network_uint16_t len; /**< 12 + length of dhcpv6_opt_ia_pd_t::opts in byte */
|
|
network_uint32_t ia_id; /**< Unique ID for this IA_PD */
|
|
network_uint32_t t1; /**< DHCPv6 T1 time (in sec) */
|
|
network_uint32_t t2; /**< DHCPv6 T2 time (in sec) */
|
|
uint8_t opts[]; /**< IA_PD options */
|
|
} dhcpv6_opt_ia_pd_t;
|
|
|
|
/**
|
|
* @brief DHCPv6 IA prefix option format
|
|
* @see [RFC 8415, section 21.22]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.22)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
network_uint16_t type; /**< @ref DHCPV6_OPT_IAPFX */
|
|
network_uint16_t len; /**< 25 + length of dhcpv6_opt_iapfx_t::opts in byte */
|
|
network_uint32_t pref; /**< preferred lifetime (in sec) */
|
|
network_uint32_t valid; /**< valid lifetime (in sec) */
|
|
uint8_t pfx_len; /**< length of dhcpv6_opt_iapfx_t::pfx in bits */
|
|
ipv6_addr_t pfx; /**< the prefix */
|
|
uint8_t opts[]; /**< IAprefix options */
|
|
} dhcpv6_opt_iapfx_t;
|
|
|
|
/**
|
|
* @brief DHCPv6 SOL_MAX_RT option format
|
|
* @see [RFC 8415, section 21.24]
|
|
* (https://tools.ietf.org/html/rfc8415#section-21.24)
|
|
*/
|
|
typedef struct __attribute__((packed)) {
|
|
network_uint16_t type; /**< @ref DHCPV6_OPT_SMR */
|
|
network_uint16_t len; /**< always 4 */
|
|
network_uint32_t value; /**< overriding value for SOL_MAX_RT (in sec) */
|
|
} dhcpv6_opt_smr_t;
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* PRIV_DHCPV6_H */
|
|
/** @} */
|