Dynamic Host Configuration Protocol for IPv6. More...

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <errno.h>
#include <byteswap.h>
#include <ipxe/interface.h>
#include <ipxe/xfer.h>
#include <ipxe/iobuf.h>
#include <ipxe/open.h>
#include <ipxe/netdevice.h>
#include <ipxe/settings.h>
#include <ipxe/retry.h>
#include <ipxe/timer.h>
#include <ipxe/in.h>
#include <ipxe/crc32.h>
#include <ipxe/errortab.h>
#include <ipxe/ipv6.h>
#include <ipxe/dhcparch.h>
#include <ipxe/dhcpv6.h>

Data Structures
struct	dhcpv6_option_list
	A DHCPv6 option list. More...

struct	dhcpv6_settings
	A DHCPv6 settings block. More...

struct	dhcpv6_address_operation
	A DHCPv6 address setting operation. More...

struct	dhcpv6_session_state
	A DHCPv6 session state. More...

struct	dhcpv6_session
	A DHCPv6 session. More...

Macros
#define	EPROTO_UNSPECFAIL __einfo_error ( EINFO_EPROTO_UNSPECFAIL )

#define	EINFO_EPROTO_UNSPECFAIL __einfo_uniqify ( EINFO_EPROTO, 1, "Unspecified server failure" )

#define	EPROTO_NOADDRSAVAIL __einfo_error ( EINFO_EPROTO_NOADDRSAVAIL )

#define	EINFO_EPROTO_NOADDRSAVAIL __einfo_uniqify ( EINFO_EPROTO, 2, "No addresses available" )

#define	EPROTO_NOBINDING __einfo_error ( EINFO_EPROTO_NOBINDING )

#define	EINFO_EPROTO_NOBINDING __einfo_uniqify ( EINFO_EPROTO, 3, "Client record unavailable" )

#define	EPROTO_NOTONLINK __einfo_error ( EINFO_EPROTO_NOTONLINK )

#define	EINFO_EPROTO_NOTONLINK __einfo_uniqify ( EINFO_EPROTO, 4, "Prefix not on link" )

#define	EPROTO_USEMULTICAST __einfo_error ( EINFO_EPROTO_USEMULTICAST )

#define	EINFO_EPROTO_USEMULTICAST __einfo_uniqify ( EINFO_EPROTO, 5, "Use multicast address" )

#define	EPROTO_STATUS(status)

Enumerations
enum	dhcpv6_session_state_flags { DHCPV6_TX_IA_NA = 0x01, DHCPV6_TX_IAADDR = 0x02, DHCPV6_RX_RECORD_SERVER_ID = 0x04, DHCPV6_RX_RECORD_IAADDR = 0x08 }
	DHCPv6 session state flags. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)

static const union dhcpv6_any_option *	dhcpv6_option (struct dhcpv6_option_list *options, unsigned int code)
	Find DHCPv6 option. More...

static int	dhcpv6_check_duid (struct dhcpv6_option_list options, unsigned int code, const void expected, size_t len)
	Check DHCPv6 client or server identifier. More...

static int	dhcpv6_status_code (struct dhcpv6_option_list *options)
	Get DHCPv6 status code. More...

static int	dhcpv6_iaaddr (struct dhcpv6_option_list options, uint32_t iaid, struct in6_addr address)
	Get DHCPv6 identity association address. More...

static int	dhcpv6_applies (struct settings settings __unused, const struct setting setting)
	Check applicability of DHCPv6 setting. More...

static int	dhcpv6_fetch_ip6 (struct dhcpv6_settings dhcpv6set, void data, size_t len)
	Fetch value of DHCPv6 leased address. More...

static int	dhcpv6_fetch_len6 (struct dhcpv6_settings dhcpv6set __unused, void data, size_t len)
	Fetch value of DHCPv6 implicit address prefix length. More...

static int	dhcpv6_fetch_gateway6 (struct dhcpv6_settings dhcpv6set, void data, size_t len)
	Fetch value of DHCPv6 router address. More...

static int	dhcpv6_fetch (struct settings settings, struct setting setting, void *data, size_t len)
	Fetch value of DHCPv6 setting. More...

static int	dhcpv6_register (struct in6_addr lease, struct in6_addr router, struct dhcpv6_option_list options, struct settings parent)
	Register DHCPv6 options as network device settings. More...

static const char *	dhcpv6_type_name (unsigned int type)
	Name a DHCPv6 packet type. More...

static void	dhcpv6_free (struct refcnt *refcnt)
	Free DHCPv6 session. More...

static void	dhcpv6_finished (struct dhcpv6_session *dhcpv6, int rc)
	Terminate DHCPv6 session. More...

static void	dhcpv6_set_state (struct dhcpv6_session dhcpv6, struct dhcpv6_session_state state)
	Transition to new DHCPv6 session state. More...

static size_t	dhcpv6_user_class (void *data, size_t len)
	Get DHCPv6 user class. More...

static int	dhcpv6_tx (struct dhcpv6_session *dhcpv6)
	Transmit current request. More...

static void	dhcpv6_timer_expired (struct retry_timer *timer, int fail)
	Handle timer expiry. More...

static int	dhcpv6_rx (struct dhcpv6_session dhcpv6, struct io_buffer iobuf, struct xfer_metadata *meta)
	Receive new data. More...

int	start_dhcpv6 (struct interface job, struct net_device netdev, struct in6_addr *router, int stateful)
	Start DHCPv6. More...

const struct setting filename6_setting	__setting (SETTING_BOOT, filename)
	Boot filename setting. More...

const struct setting dnssl6_setting	__setting (SETTING_IP_EXTRA, dnssl)
	DNS search list setting. More...

Variables
struct errortab dhcpv6_errors []	__errortab
	Human-readable error messages. More...

static struct dhcpv6_address_operation	dhcpv6_address_operations []
	DHCPv6 address settings operations. More...

static struct settings_operations	dhcpv6_settings_operations
	DHCPv6 settings operations. More...

static uint8_t	dhcpv6_request_options_data []
	Raw option data for options common to all DHCPv6 requests. More...

static struct dhcpv6_session_state	dhcpv6_request
	DHCPv6 request state. More...

static struct dhcpv6_session_state	dhcpv6_solicit
	DHCPv6 solicitation state. More...

static struct dhcpv6_session_state	dhcpv6_information_request
	DHCPv6 information request state. More...

static struct interface_operation	dhcpv6_job_op []
	DHCPv6 job control interface operations. More...

static struct interface_descriptor	dhcpv6_job_desc
	DHCPv6 job control interface descriptor. More...

static struct interface_operation	dhcpv6_xfer_op []
	DHCPv6 data transfer interface operations. More...

static struct interface_descriptor	dhcpv6_xfer_desc
	DHCPv6 data transfer interface descriptor. More...

Detailed Description

Dynamic Host Configuration Protocol for IPv6.

Definition in file dhcpv6.c.

Macro Definition Documentation

◆ EPROTO_UNSPECFAIL

#define EPROTO_UNSPECFAIL __einfo_error ( EINFO_EPROTO_UNSPECFAIL )

Definition at line 53 of file dhcpv6.c.

◆ EINFO_EPROTO_UNSPECFAIL

#define EINFO_EPROTO_UNSPECFAIL __einfo_uniqify ( EINFO_EPROTO, 1, "Unspecified server failure" )

Definition at line 54 of file dhcpv6.c.

◆ EPROTO_NOADDRSAVAIL

#define EPROTO_NOADDRSAVAIL __einfo_error ( EINFO_EPROTO_NOADDRSAVAIL )

Definition at line 56 of file dhcpv6.c.

◆ EINFO_EPROTO_NOADDRSAVAIL

#define EINFO_EPROTO_NOADDRSAVAIL __einfo_uniqify ( EINFO_EPROTO, 2, "No addresses available" )

Definition at line 57 of file dhcpv6.c.

◆ EPROTO_NOBINDING

#define EPROTO_NOBINDING __einfo_error ( EINFO_EPROTO_NOBINDING )

Definition at line 59 of file dhcpv6.c.

◆ EINFO_EPROTO_NOBINDING

#define EINFO_EPROTO_NOBINDING __einfo_uniqify ( EINFO_EPROTO, 3, "Client record unavailable" )

Definition at line 60 of file dhcpv6.c.

◆ EPROTO_NOTONLINK

#define EPROTO_NOTONLINK __einfo_error ( EINFO_EPROTO_NOTONLINK )

Definition at line 62 of file dhcpv6.c.

◆ EINFO_EPROTO_NOTONLINK

#define EINFO_EPROTO_NOTONLINK __einfo_uniqify ( EINFO_EPROTO, 4, "Prefix not on link" )

Definition at line 63 of file dhcpv6.c.

◆ EPROTO_USEMULTICAST

#define EPROTO_USEMULTICAST __einfo_error ( EINFO_EPROTO_USEMULTICAST )

Definition at line 65 of file dhcpv6.c.

◆ EINFO_EPROTO_USEMULTICAST

#define EINFO_EPROTO_USEMULTICAST __einfo_uniqify ( EINFO_EPROTO, 5, "Use multicast address" )

Definition at line 66 of file dhcpv6.c.

◆ EPROTO_STATUS

#define EPROTO_STATUS ( status )

Value:

EUNIQ ( EINFO_EPROTO, ( (status) & 0x0f ), EPROTO_UNSPECFAIL,   \
                EPROTO_NOADDRSAVAIL, EPROTO_NOBINDING,                  \
                EPROTO_NOTONLINK, EPROTO_USEMULTICAST )

Definition at line 68 of file dhcpv6.c.

Enumeration Type Documentation

◆ dhcpv6_session_state_flags

enum dhcpv6_session_state_flags

DHCPv6 session state flags.

Enumerator
DHCPV6_TX_IA_NA	Include identity association within request.
DHCPV6_TX_IAADDR	Include leased IPv6 address within request.
DHCPV6_RX_RECORD_SERVER_ID	Record received server ID.
DHCPV6_RX_RECORD_IAADDR	Record received IPv6 address.

Definition at line 531 of file dhcpv6.c.

                                 {
         /** Include identity association within request */
         DHCPV6_TX_IA_NA = 0x01,
         /** Include leased IPv6 address within request */
         DHCPV6_TX_IAADDR = 0x02,
         /** Record received server ID */
         DHCPV6_RX_RECORD_SERVER_ID = 0x04,
         /** Record received IPv6 address */
         DHCPV6_RX_RECORD_IAADDR = 0x08,
 };

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ dhcpv6_option()

static const union dhcpv6_any_option* dhcpv6_option	(	struct dhcpv6_option_list *	options,
		unsigned int	code
	)

static

Find DHCPv6 option.

Parameters

options	DHCPv6 option list
code	Option code

Return values

option DHCPv6 option, or NULL if not found

Definition at line 100 of file dhcpv6.c.

                                                                         {
         const union dhcpv6_any_option *option = options->data;
         size_t remaining = options->len;
         size_t data_len;
 
         /* Scan through list of options */
         while ( remaining >= sizeof ( option->header ) ) {
 
                 /* Calculate and validate option length */
                 remaining -= sizeof ( option->header );
                 data_len = ntohs ( option->header.len );
                 if ( data_len > remaining ) {
                         /* Malformed option list */
                         return NULL;
                 }
 
                 /* Return if we have found the specified option */
                 if ( option->header.code == htons ( code ) )
                         return option;
 
                 /* Otherwise, move to the next option */
                 option = ( ( ( void * ) option->header.data ) + data_len );
                 remaining -= data_len;
         }
 
         return NULL;
 }

References code, data_len, htons, ntohs, NULL, and options.

Referenced by dhcpv6_check_duid(), dhcpv6_fetch(), dhcpv6_iaaddr(), dhcpv6_rx(), and dhcpv6_status_code().

◆ dhcpv6_check_duid()

static int dhcpv6_check_duid	(	struct dhcpv6_option_list *	options,
		unsigned int	code,
		const void *	expected,
		size_t	len
	)

static

Check DHCPv6 client or server identifier.

Parameters

options	DHCPv6 option list
code	Option code
expected	Expected value
len	Length of expected value

Return values

rc	Return status code

Definition at line 137 of file dhcpv6.c.

                                             {
         const union dhcpv6_any_option *option;
         const struct dhcpv6_duid_option *duid;
 
         /* Find option */
         option = dhcpv6_option ( options, code );
         if ( ! option )
                 return -ENOENT;
         duid = &option->duid;
 
         /* Check option length */
         if ( ntohs ( duid->header.len ) != len )
                 return -EINVAL;
 
         /* Compare option value */
         if ( memcmp ( duid->duid, expected, len ) != 0 )
                 return -EINVAL;
 
         return 0;
 }

References code, dhcpv6_option(), dhcpv6_duid_option::duid, EINVAL, ENOENT, len, memcmp(), ntohs, and options.

Referenced by dhcpv6_rx().

◆ dhcpv6_status_code()

static int dhcpv6_status_code ( struct dhcpv6_option_list * options )

static

Get DHCPv6 status code.

Parameters

options DHCPv6 option list

Return values

rc	Return status code

Definition at line 166 of file dhcpv6.c.

                                                                      {
         const union dhcpv6_any_option *option;
         const struct dhcpv6_status_code_option *status_code;
         unsigned int status;
 
         /* Find status code option, if present */
         option = dhcpv6_option ( options, DHCPV6_STATUS_CODE );
         if ( ! option ) {
                 /* Omitted status code should be treated as "success" */
                 return 0;
         }
         status_code = &option->status_code;
 
         /* Sanity check */
         if ( ntohs ( status_code->header.len ) <
              ( sizeof ( *status_code ) - sizeof ( status_code->header ) ) ) {
                 return -EINVAL;
         }
 
         /* Calculate iPXE error code from DHCPv6 status code */
         status = ntohs ( status_code->status );
         return ( status ? -EPROTO_STATUS ( status ) : 0 );
 }

References dhcpv6_option(), DHCPV6_STATUS_CODE, EINVAL, EPROTO_STATUS, dhcpv6_status_code_option::header, dhcpv6_option::len, ntohs, options, status, and dhcpv6_status_code_option::status.

Referenced by dhcpv6_iaaddr(), and dhcpv6_rx().

◆ dhcpv6_iaaddr()

static int dhcpv6_iaaddr	(	struct dhcpv6_option_list *	options,
		uint32_t	iaid,
		struct in6_addr *	address
	)

static

Get DHCPv6 identity association address.

Parameters

options	DHCPv6 option list
iaid	Identity association ID
address	IPv6 address to fill in

Return values

rc	Return status code

Definition at line 198 of file dhcpv6.c.

                                                       {
         const union dhcpv6_any_option *option;
         const struct dhcpv6_ia_na_option *ia_na;
         const struct dhcpv6_iaaddr_option *iaaddr;
         struct dhcpv6_option_list suboptions;
         size_t len;
         int rc;
 
         /* Find identity association option, if present */
         option = dhcpv6_option ( options, DHCPV6_IA_NA );
         if ( ! option )
                 return -ENOENT;
         ia_na = &option->ia_na;
 
         /* Sanity check */
         len = ntohs ( ia_na->header.len );
         if ( len < ( sizeof ( *ia_na ) - sizeof ( ia_na->header ) ) )
                 return -EINVAL;
 
         /* Check identity association ID */
         if ( ia_na->iaid != htonl ( iaid ) )
                 return -EINVAL;
 
         /* Construct IA_NA sub-options list */
         suboptions.data = ia_na->options;
         suboptions.len = ( len + sizeof ( ia_na->header ) -
                            offsetof ( typeof ( *ia_na ), options ) );
 
         /* Check IA_NA status code */
         if ( ( rc = dhcpv6_status_code ( &suboptions ) ) != 0 )
                 return rc;
 
         /* Find identity association address, if present */
         option = dhcpv6_option ( &suboptions, DHCPV6_IAADDR );
         if ( ! option )
                 return -ENOENT;
         iaaddr = &option->iaaddr;
 
         /* Sanity check */
         len = ntohs ( iaaddr->header.len );
         if ( len < ( sizeof ( *iaaddr ) - sizeof ( iaaddr->header ) ) )
                 return -EINVAL;
 
         /* Construct IAADDR sub-options list */
         suboptions.data = iaaddr->options;
         suboptions.len = ( len + sizeof ( iaaddr->header ) -
                            offsetof ( typeof ( *iaaddr ), options ) );
 
         /* Check IAADDR status code */
         if ( ( rc = dhcpv6_status_code ( &suboptions ) ) != 0 )
                 return rc;
 
         /* Extract IPv6 address */
         memcpy ( address, &iaaddr->address, sizeof ( *address ) );
 
         return 0;
 }

References address, dhcpv6_iaaddr_option::address, dhcpv6_option_list::data, DHCPV6_IA_NA, DHCPV6_IAADDR, dhcpv6_option(), dhcpv6_status_code(), EINVAL, ENOENT, dhcpv6_ia_na_option::header, dhcpv6_iaaddr_option::header, htonl, dhcpv6_ia_na_option::iaid, len, dhcpv6_option::len, dhcpv6_option_list::len, memcpy(), ntohs, offsetof, dhcpv6_ia_na_option::options, dhcpv6_iaaddr_option::options, options, rc, and typeof().

Referenced by dhcpv6_rx().

◆ dhcpv6_applies()

static int dhcpv6_applies	(	struct settings *settings	__unused,
		const struct setting *	setting
	)

static

Check applicability of DHCPv6 setting.

Parameters

settings	Settings block
setting	Setting

Return values

applies Setting applies within this settings block

Definition at line 284 of file dhcpv6.c.

                                                             {
 
         return ( ( setting->scope == &dhcpv6_scope ) ||
                  ( setting->scope == &ipv6_settings_scope ) );
 }

References dhcpv6_scope, ipv6_settings_scope, and setting::scope.

◆ dhcpv6_fetch_ip6()

static int dhcpv6_fetch_ip6	(	struct dhcpv6_settings *	dhcpv6set,
		void *	data,
		size_t	len
	)

static

Fetch value of DHCPv6 leased address.

Parameters

dhcpv6set	DHCPv6 settings
data	Buffer to fill with setting data
len	Length of buffer

Return values

len	Length of setting data, or negative error

Definition at line 299 of file dhcpv6.c.

                                                        {
         struct in6_addr *lease = &dhcpv6set->lease;
 
         /* Copy leased address */
         if ( len > sizeof ( *lease ) )
                 len = sizeof ( *lease );
         memcpy ( data, lease, len );
 
         return sizeof ( *lease );
 }

References data, lease, dhcpv6_settings::lease, len, and memcpy().

◆ dhcpv6_fetch_len6()

static int dhcpv6_fetch_len6	(	struct dhcpv6_settings *dhcpv6set	__unused,
		void *	data,
		size_t	len
	)

static

Fetch value of DHCPv6 implicit address prefix length.

Parameters

dhcpv6set	DHCPv6 settings
data	Buffer to fill with setting data
len	Length of buffer

Return values

len	Length of setting data, or negative error

Definition at line 319 of file dhcpv6.c.

                                                         {
         uint8_t *len6 = data;
 
         /* Default to assuming this is the only address on the link.
          * If the address falls within a known prefix, then the IPv6
          * routing table construction logic will match it against that
          * prefix.
          */
         if ( len )
                 *len6 = IPV6_MAX_PREFIX_LEN;
 
         return sizeof ( *len6 );
 }

References data, IPV6_MAX_PREFIX_LEN, and len.

◆ dhcpv6_fetch_gateway6()

static int dhcpv6_fetch_gateway6	(	struct dhcpv6_settings *	dhcpv6set,
		void *	data,
		size_t	len
	)

static

Fetch value of DHCPv6 router address.

Parameters

dhcpv6set	DHCPv6 settings
data	Buffer to fill with setting data
len	Length of buffer

Return values

len	Length of setting data, or negative error

Definition at line 342 of file dhcpv6.c.

                                                             {
         struct in6_addr *router = &dhcpv6set->router;
 
         /* Copy router address */
         if ( len > sizeof ( *router ) )
                 len = sizeof ( *router );
         memcpy ( data, router, len );
 
         return sizeof ( *router );
 }

References data, len, memcpy(), and dhcpv6_settings::router.

◆ dhcpv6_fetch()

static int dhcpv6_fetch	(	struct settings *	settings,
		struct setting *	setting,
		void *	data,
		size_t	len
	)

static

Fetch value of DHCPv6 setting.

Parameters

settings	Settings block
setting	Setting to fetch
data	Buffer to fill with setting data
len	Length of buffer

Return values

len	Length of setting data, or negative error

Definition at line 386 of file dhcpv6.c.

                                                    {
         struct dhcpv6_settings *dhcpv6set =
                 container_of ( settings, struct dhcpv6_settings, settings );
         const union dhcpv6_any_option *option;
         struct dhcpv6_address_operation *op;
         size_t option_len;
         unsigned int i;
 
         /* Handle address settings */
         for ( i = 0 ; i < ( sizeof ( dhcpv6_address_operations ) /
                             sizeof ( dhcpv6_address_operations[0] ) ) ; i++ ) {
                 op = &dhcpv6_address_operations[i];
                 if ( setting_cmp ( setting, op->setting ) != 0 )
                         continue;
                 if ( IN6_IS_ADDR_UNSPECIFIED ( &dhcpv6set->lease ) )
                         return -ENOENT;
                 return op->fetch ( dhcpv6set, data, len );
         }
 
         /* Find option */
         option = dhcpv6_option ( &dhcpv6set->options, setting->tag );
         if ( ! option )
                 return -ENOENT;
 
         /* Copy option to data buffer */
         option_len = ntohs ( option->header.len );
         if ( len > option_len )
                 len = option_len;
         memcpy ( data, option->header.data, len );
         return option_len;
 }

References container_of, data, dhcpv6_address_operations, dhcpv6_option(), ENOENT, IN6_IS_ADDR_UNSPECIFIED, dhcpv6_settings::lease, len, memcpy(), ntohs, op, dhcpv6_settings::options, setting_cmp(), and setting::tag.

◆ dhcpv6_register()

static int dhcpv6_register	(	struct in6_addr *	lease,
		struct in6_addr *	router,
		struct dhcpv6_option_list *	options,
		struct settings *	parent
	)

static

Register DHCPv6 options as network device settings.

Parameters

lease	DHCPv6 leased address
router	DHCPv6 router address
options	DHCPv6 option list
parent	Parent settings block

Return values

rc	Return status code

Definition at line 435 of file dhcpv6.c.

                                                        {
         struct dhcpv6_settings *dhcpv6set;
         void *data;
         size_t len;
         int rc;
 
         /* Allocate and initialise structure */
         dhcpv6set = zalloc ( sizeof ( *dhcpv6set ) + options->len );
         if ( ! dhcpv6set ) {
                 rc = -ENOMEM;
                 goto err_alloc;
         }
         ref_init ( &dhcpv6set->refcnt, NULL );
         settings_init ( &dhcpv6set->settings, &dhcpv6_settings_operations,
                         &dhcpv6set->refcnt, &dhcpv6_scope );
         dhcpv6set->settings.order = IPV6_ORDER_DHCPV6;
         data = ( ( ( void * ) dhcpv6set ) + sizeof ( *dhcpv6set ) );
         len = options->len;
         memcpy ( data, options->data, len );
         dhcpv6set->options.data = data;
         dhcpv6set->options.len = len;
         memcpy ( &dhcpv6set->lease, lease, sizeof ( dhcpv6set->lease ) );
         memcpy ( &dhcpv6set->router, router, sizeof ( dhcpv6set->router ) );
 
         /* Register settings */
         if ( ( rc = register_settings ( &dhcpv6set->settings, parent,
                                         DHCPV6_SETTINGS_NAME ) ) != 0 )
                 goto err_register;
 
  err_register:
         ref_put ( &dhcpv6set->refcnt );
  err_alloc:
         return rc;
 }

References data, dhcpv6_option_list::data, dhcpv6_scope, DHCPV6_SETTINGS_NAME, dhcpv6_settings_operations, ENOMEM, IPV6_ORDER_DHCPV6, lease, dhcpv6_settings::lease, len, dhcpv6_option_list::len, memcpy(), NULL, dhcpv6_settings::options, options, settings::order, rc, ref_init, ref_put, dhcpv6_settings::refcnt, register_settings(), dhcpv6_settings::router, dhcpv6_settings::settings, settings_init(), and zalloc().

Referenced by dhcpv6_rx().

◆ dhcpv6_type_name()

static const char* dhcpv6_type_name ( unsigned int type )

static

Name a DHCPv6 packet type.

Parameters

type	DHCPv6 packet type

Return values

name	DHCPv6 packet type name

Definition at line 503 of file dhcpv6.c.

                                        {
         static char buf[ 12 /* "UNKNOWN-xxx" + NUL */ ];
 
         switch ( type ) {
         case DHCPV6_SOLICIT:                    return "SOLICIT";
         case DHCPV6_ADVERTISE:                  return "ADVERTISE";
         case DHCPV6_REQUEST:                    return "REQUEST";
         case DHCPV6_REPLY:                      return "REPLY";
         case DHCPV6_INFORMATION_REQUEST:        return "INFORMATION-REQUEST";
         default:
                 snprintf ( buf, sizeof ( buf ), "UNKNOWN-%d", type );
                 return buf;
         }
 }

References DHCPV6_ADVERTISE, DHCPV6_INFORMATION_REQUEST, DHCPV6_REPLY, DHCPV6_REQUEST, DHCPV6_SOLICIT, snprintf(), and type.

Referenced by dhcpv6_rx(), and dhcpv6_set_state().

◆ dhcpv6_free()

static void dhcpv6_free ( struct refcnt * refcnt )

static

Free DHCPv6 session.

Parameters

refcnt Reference count

Definition at line 610 of file dhcpv6.c.

                                                   {
         struct dhcpv6_session *dhcpv6 =
                 container_of ( refcnt, struct dhcpv6_session, refcnt );
 
         netdev_put ( dhcpv6->netdev );
         free ( dhcpv6->server_duid );
         free ( dhcpv6 );
 }

References container_of, free, dhcpv6_session::netdev, netdev_put(), and dhcpv6_session::server_duid.

Referenced by start_dhcpv6().

◆ dhcpv6_finished()

static void dhcpv6_finished	(	struct dhcpv6_session *	dhcpv6,
		int	rc
	)

static

Terminate DHCPv6 session.

Parameters

dhcpv6	DHCPv6 session
rc	Reason for close

Definition at line 625 of file dhcpv6.c.

                                                                       {
 
         /* Stop timer */
         stop_timer ( &dhcpv6->timer );
 
         /* Shut down interfaces */
         intf_shutdown ( &dhcpv6->xfer, rc );
         intf_shutdown ( &dhcpv6->job, rc );
 }

References intf_shutdown(), dhcpv6_session::job, rc, stop_timer(), dhcpv6_session::timer, and dhcpv6_session::xfer.

Referenced by dhcpv6_rx(), dhcpv6_timer_expired(), and start_dhcpv6().

◆ dhcpv6_set_state()

static void dhcpv6_set_state	(	struct dhcpv6_session *	dhcpv6,
		struct dhcpv6_session_state *	state
	)

static

Transition to new DHCPv6 session state.

Parameters

dhcpv6	DHCPv6 session
state	New session state

Definition at line 641 of file dhcpv6.c.

                                                                     {
 
         DBGC ( dhcpv6, "DHCPv6 %s entering %s state\n", dhcpv6->netdev->name,
                dhcpv6_type_name ( state->tx_type ) );
 
         /* Record state */
         dhcpv6->state = state;
 
         /* Default to -ETIMEDOUT if no more specific error is recorded */
         dhcpv6->rc = -ETIMEDOUT;
 
         /* Start timer to trigger transmission */
         start_timer_nodelay ( &dhcpv6->timer );
 }

References DBGC, dhcpv6_type_name(), ETIMEDOUT, net_device::name, dhcpv6_session::netdev, dhcpv6_session::rc, start_timer_nodelay(), state, dhcpv6_session::state, and dhcpv6_session::timer.

Referenced by dhcpv6_rx(), and start_dhcpv6().

◆ dhcpv6_user_class()

static size_t dhcpv6_user_class	(	void *	data,
		size_t	len
	)

static

Get DHCPv6 user class.

Parameters

data	Data buffer
len	Length of data buffer

Return values

len	Length of user class

Definition at line 664 of file dhcpv6.c.

                                                            {
         static const char default_user_class[4] = { 'i', 'P', 'X', 'E' };
         int actual_len;
 
         /* Fetch user-class setting, if defined */
         actual_len = fetch_raw_setting ( NULL, &user_class_setting, data, len );
         if ( actual_len >= 0 )
                 return actual_len;
 
         /* Otherwise, use the default user class ("iPXE") */
         if ( len > sizeof ( default_user_class ) )
                 len = sizeof ( default_user_class );
         memcpy ( data, default_user_class, len );
         return sizeof ( default_user_class );
 }

References data, fetch_raw_setting(), len, memcpy(), and NULL.

Referenced by dhcpv6_tx().

◆ dhcpv6_tx()

static int dhcpv6_tx ( struct dhcpv6_session * dhcpv6 )

static

Transmit current request.

Parameters

dhcpv6 DHCPv6 session

Return values

rc	Return status code

Definition at line 686 of file dhcpv6.c.

                                                        {
         struct dhcpv6_duid_option *client_id;
         struct dhcpv6_duid_option *server_id;
         struct dhcpv6_ia_na_option *ia_na;
         struct dhcpv6_iaaddr_option *iaaddr;
         struct dhcpv6_user_class_option *user_class;
         struct dhcpv6_elapsed_time_option *elapsed;
         struct dhcpv6_header *dhcphdr;
         struct io_buffer *iobuf;
         void *options;
         size_t client_id_len;
         size_t server_id_len;
         size_t ia_na_len;
         size_t user_class_string_len;
         size_t user_class_len;
         size_t elapsed_len;
         size_t total_len;
         int rc;
 
         /* Calculate lengths */
         client_id_len = ( sizeof ( *client_id ) +
                           sizeof ( dhcpv6->client_duid ) );
         server_id_len = ( dhcpv6->server_duid ? ( sizeof ( *server_id ) +
                                                   dhcpv6->server_duid_len ) :0);
         if ( dhcpv6->state->flags & DHCPV6_TX_IA_NA ) {
                 ia_na_len = sizeof ( *ia_na );
                 if ( dhcpv6->state->flags & DHCPV6_TX_IAADDR )
                         ia_na_len += sizeof ( *iaaddr );
         } else {
                 ia_na_len = 0;
         }
         user_class_string_len = dhcpv6_user_class ( NULL, 0 );
         user_class_len = ( sizeof ( *user_class ) +
                            sizeof ( user_class->user_class[0] ) +
                            user_class_string_len );
         elapsed_len = sizeof ( *elapsed );
         total_len = ( sizeof ( *dhcphdr ) + client_id_len + server_id_len +
                       ia_na_len + sizeof ( dhcpv6_request_options_data ) +
                       user_class_len + elapsed_len );
 
         /* Allocate packet */
         iobuf = xfer_alloc_iob ( &dhcpv6->xfer, total_len );
         if ( ! iobuf )
                 return -ENOMEM;
 
         /* Construct header */
         dhcphdr = iob_put ( iobuf, sizeof ( *dhcphdr ) );
         dhcphdr->type = dhcpv6->state->tx_type;
         memcpy ( dhcphdr->xid, dhcpv6->xid, sizeof ( dhcphdr->xid ) );
 
         /* Construct client identifier */
         client_id = iob_put ( iobuf, client_id_len );
         client_id->header.code = htons ( DHCPV6_CLIENT_ID );
         client_id->header.len = htons ( client_id_len -
                                         sizeof ( client_id->header ) );
         memcpy ( client_id->duid, &dhcpv6->client_duid,
                  sizeof ( dhcpv6->client_duid ) );
 
         /* Construct server identifier, if applicable */
         if ( server_id_len ) {
                 server_id = iob_put ( iobuf, server_id_len );
                 server_id->header.code = htons ( DHCPV6_SERVER_ID );
                 server_id->header.len = htons ( server_id_len -
                                                 sizeof ( server_id->header ) );
                 memcpy ( server_id->duid, dhcpv6->server_duid,
                          dhcpv6->server_duid_len );
         }
 
         /* Construct identity association, if applicable */
         if ( ia_na_len ) {
                 ia_na = iob_put ( iobuf, ia_na_len );
                 ia_na->header.code = htons ( DHCPV6_IA_NA );
                 ia_na->header.len = htons ( ia_na_len -
                                             sizeof ( ia_na->header ) );
                 ia_na->iaid = htonl ( dhcpv6->iaid );
                 ia_na->renew = htonl ( 0 );
                 ia_na->rebind = htonl ( 0 );
                 if ( dhcpv6->state->flags & DHCPV6_TX_IAADDR ) {
                         iaaddr = ( ( void * ) ia_na->options );
                         iaaddr->header.code = htons ( DHCPV6_IAADDR );
                         iaaddr->header.len = htons ( sizeof ( *iaaddr ) -
                                                      sizeof ( iaaddr->header ));
                         memcpy ( &iaaddr->address, &dhcpv6->lease,
                                  sizeof ( iaaddr->address ) );
                         iaaddr->preferred = htonl ( 0 );
                         iaaddr->valid = htonl ( 0 );
                 }
         }
 
         /* Construct fixed request options */
         options = iob_put ( iobuf, sizeof ( dhcpv6_request_options_data ) );
         memcpy ( options, dhcpv6_request_options_data,
                  sizeof ( dhcpv6_request_options_data ) );
 
         /* Construct user class */
         user_class = iob_put ( iobuf, user_class_len );
         user_class->header.code = htons ( DHCPV6_USER_CLASS );
         user_class->header.len = htons ( user_class_len -
                                          sizeof ( user_class->header ) );
         user_class->user_class[0].len = htons ( user_class_string_len );
         dhcpv6_user_class ( user_class->user_class[0].string,
                             user_class_string_len );
 
         /* Construct elapsed time */
         elapsed = iob_put ( iobuf, elapsed_len );
         elapsed->header.code = htons ( DHCPV6_ELAPSED_TIME );
         elapsed->header.len = htons ( elapsed_len -
                                       sizeof ( elapsed->header ) );
         elapsed->elapsed = htons ( ( ( currticks() - dhcpv6->start ) * 100 ) /
                                    TICKS_PER_SEC );
 
         /* Sanity check */
         assert ( iob_len ( iobuf ) == total_len );
 
         /* Transmit packet */
         if ( ( rc = xfer_deliver_iob ( &dhcpv6->xfer, iobuf ) ) != 0 ) {
                 DBGC ( dhcpv6, "DHCPv6 %s could not transmit: %s\n",
                        dhcpv6->netdev->name, strerror ( rc ) );
                 return rc;
         }
 
         return 0;
 }

References dhcpv6_iaaddr_option::address, assert(), dhcpv6_session::client_duid, dhcpv6_option::code, currticks(), DBGC, DHCPV6_CLIENT_ID, DHCPV6_ELAPSED_TIME, DHCPV6_IA_NA, DHCPV6_IAADDR, dhcpv6_request_options_data, DHCPV6_SERVER_ID, DHCPV6_TX_IA_NA, DHCPV6_TX_IAADDR, DHCPV6_USER_CLASS, dhcpv6_user_class(), dhcpv6_duid_option::duid, dhcpv6_elapsed_time_option::elapsed, ENOMEM, dhcpv6_session_state::flags, dhcpv6_duid_option::header, dhcpv6_ia_na_option::header, dhcpv6_iaaddr_option::header, dhcpv6_elapsed_time_option::header, dhcpv6_user_class_option::header, htonl, htons, dhcpv6_ia_na_option::iaid, dhcpv6_session::iaid, iob_len(), iob_put, dhcpv6_session::lease, dhcpv6_option::len, dhcpv6_user_class::len, memcpy(), net_device::name, dhcpv6_session::netdev, NULL, dhcpv6_ia_na_option::options, options, dhcpv6_iaaddr_option::preferred, rc, dhcpv6_ia_na_option::rebind, dhcpv6_ia_na_option::renew, dhcpv6_session::server_duid, dhcpv6_session::server_duid_len, dhcpv6_session::start, dhcpv6_session::state, strerror(), dhcpv6_user_class::string, TICKS_PER_SEC, dhcpv6_session_state::tx_type, dhcpv6_user_class_option::user_class, dhcpv6_iaaddr_option::valid, dhcpv6_session::xfer, xfer_alloc_iob(), xfer_deliver_iob(), dhcpv6_session::xid, and dhcphdr::xid.

Referenced by dhcpv6_timer_expired().

◆ dhcpv6_timer_expired()

static void dhcpv6_timer_expired	(	struct retry_timer *	timer,
		int	fail
	)

static

Handle timer expiry.

Parameters

timer	Retransmission timer
fail	Failure indicator

Definition at line 816 of file dhcpv6.c.

                                                                          {
         struct dhcpv6_session *dhcpv6 =
                 container_of ( timer, struct dhcpv6_session, timer );
 
         /* If we have failed, terminate DHCPv6 */
         if ( fail ) {
                 dhcpv6_finished ( dhcpv6, dhcpv6->rc );
                 return;
         }
 
         /* Restart timer */
         start_timer ( &dhcpv6->timer );
 
         /* (Re)transmit current request */
         dhcpv6_tx ( dhcpv6 );
 }

References container_of, dhcpv6_finished(), dhcpv6_tx(), dhcpv6_session::rc, start_timer(), and dhcpv6_session::timer.

Referenced by start_dhcpv6().

◆ dhcpv6_rx()

static int dhcpv6_rx	(	struct dhcpv6_session *	dhcpv6,
		struct io_buffer *	iobuf,
		struct xfer_metadata *	meta
	)

static

Receive new data.

Parameters

dhcpv6	DHCPv6 session
iobuf	I/O buffer
meta	Data transfer metadata

Return values

rc	Return status code

Definition at line 841 of file dhcpv6.c.

                                                     {
         struct settings *parent = netdev_settings ( dhcpv6->netdev );
         struct sockaddr_in6 *src = ( ( struct sockaddr_in6 * ) meta->src );
         struct dhcpv6_header *dhcphdr = iobuf->data;
         struct dhcpv6_option_list options;
         const union dhcpv6_any_option *option;
         int rc;
 
         /* Sanity checks */
         if ( iob_len ( iobuf ) < sizeof ( *dhcphdr ) ) {
                 DBGC ( dhcpv6, "DHCPv6 %s received packet too short (%zd "
                        "bytes, min %zd bytes)\n", dhcpv6->netdev->name,
                        iob_len ( iobuf ), sizeof ( *dhcphdr ) );
                 rc = -EINVAL;
                 goto done;
         }
         assert ( src != NULL );
         assert ( src->sin6_family == AF_INET6 );
         DBGC ( dhcpv6, "DHCPv6 %s received %s from %s\n",
                dhcpv6->netdev->name, dhcpv6_type_name ( dhcphdr->type ),
                inet6_ntoa ( &src->sin6_addr ) );
 
         /* Construct option list */
         options.data = dhcphdr->options;
         options.len = ( iob_len ( iobuf ) -
                         offsetof ( typeof ( *dhcphdr ), options ) );
 
         /* Verify client identifier */
         if ( ( rc = dhcpv6_check_duid ( &options, DHCPV6_CLIENT_ID,
                                         &dhcpv6->client_duid,
                                         sizeof ( dhcpv6->client_duid ) ) ) !=0){
                 DBGC ( dhcpv6, "DHCPv6 %s received %s without correct client "
                        "ID: %s\n", dhcpv6->netdev->name,
                        dhcpv6_type_name ( dhcphdr->type ), strerror ( rc ) );
                 goto done;
         }
 
         /* Verify server identifier, if applicable */
         if ( dhcpv6->server_duid &&
              ( ( rc = dhcpv6_check_duid ( &options, DHCPV6_SERVER_ID,
                                           dhcpv6->server_duid,
                                           dhcpv6->server_duid_len ) ) != 0 ) ) {
                 DBGC ( dhcpv6, "DHCPv6 %s received %s without correct server "
                        "ID: %s\n", dhcpv6->netdev->name,
                        dhcpv6_type_name ( dhcphdr->type ), strerror ( rc ) );
                 goto done;
         }
 
         /* Check message type */
         if ( dhcphdr->type != dhcpv6->state->rx_type ) {
                 DBGC ( dhcpv6, "DHCPv6 %s received %s while expecting %s\n",
                        dhcpv6->netdev->name, dhcpv6_type_name ( dhcphdr->type ),
                        dhcpv6_type_name ( dhcpv6->state->rx_type ) );
                 rc = -ENOTTY;
                 goto done;
         }
 
         /* Fetch status code, if present */
         if ( ( rc = dhcpv6_status_code ( &options ) ) != 0 ) {
                 DBGC ( dhcpv6, "DHCPv6 %s received %s with error status: %s\n",
                        dhcpv6->netdev->name, dhcpv6_type_name ( dhcphdr->type ),
                        strerror ( rc ) );
                 /* This is plausibly the error we want to return */
                 dhcpv6->rc = rc;
                 goto done;
         }
 
         /* Record identity association address, if applicable */
         if ( dhcpv6->state->flags & DHCPV6_RX_RECORD_IAADDR ) {
                 if ( ( rc = dhcpv6_iaaddr ( &options, dhcpv6->iaid,
                                             &dhcpv6->lease ) ) != 0 ) {
                         DBGC ( dhcpv6, "DHCPv6 %s received %s with unusable "
                                "IAADDR: %s\n", dhcpv6->netdev->name,
                                dhcpv6_type_name ( dhcphdr->type ),
                                strerror ( rc ) );
                         /* This is plausibly the error we want to return */
                         dhcpv6->rc = rc;
                         goto done;
                 }
                 DBGC ( dhcpv6, "DHCPv6 %s received %s is for %s\n",
                        dhcpv6->netdev->name, dhcpv6_type_name ( dhcphdr->type ),
                        inet6_ntoa ( &dhcpv6->lease ) );
         }
 
         /* Record server ID, if applicable */
         if ( dhcpv6->state->flags & DHCPV6_RX_RECORD_SERVER_ID ) {
                 assert ( dhcpv6->server_duid == NULL );
                 option = dhcpv6_option ( &options, DHCPV6_SERVER_ID );
                 if ( ! option ) {
                         DBGC ( dhcpv6, "DHCPv6 %s received %s missing server "
                                "ID\n", dhcpv6->netdev->name,
                                dhcpv6_type_name ( dhcphdr->type ) );
                         rc = -EINVAL;
                         goto done;
                 }
                 dhcpv6->server_duid_len = ntohs ( option->duid.header.len );
                 dhcpv6->server_duid = malloc ( dhcpv6->server_duid_len );
                 if ( ! dhcpv6->server_duid ) {
                         rc = -ENOMEM;
                         goto done;
                 }
                 memcpy ( dhcpv6->server_duid, option->duid.duid,
                          dhcpv6->server_duid_len );
         }
 
         /* Transition to next state, if applicable */
         if ( dhcpv6->state->next ) {
                 dhcpv6_set_state ( dhcpv6, dhcpv6->state->next );
                 rc = 0;
                 goto done;
         }
 
         /* Register settings */
         if ( ( rc = dhcpv6_register ( &dhcpv6->lease, &dhcpv6->router,
                                       &options, parent ) ) != 0 ) {
                 DBGC ( dhcpv6, "DHCPv6 %s could not register settings: %s\n",
                        dhcpv6->netdev->name, strerror ( rc ) );
                 goto done;
         }
 
         /* Mark as complete */
         dhcpv6_finished ( dhcpv6, 0 );
         DBGC ( dhcpv6, "DHCPv6 %s complete\n", dhcpv6->netdev->name );
 
  done:
         free_iob ( iobuf );
         return rc;
 }

References AF_INET6, assert(), dhcpv6_session::client_duid, io_buffer::data, DBGC, dhcpv6_check_duid(), DHCPV6_CLIENT_ID, dhcpv6_finished(), dhcpv6_iaaddr(), dhcpv6_option(), dhcpv6_register(), DHCPV6_RX_RECORD_IAADDR, DHCPV6_RX_RECORD_SERVER_ID, DHCPV6_SERVER_ID, dhcpv6_set_state(), dhcpv6_status_code(), dhcpv6_type_name(), done, EINVAL, ENOMEM, ENOTTY, dhcpv6_session_state::flags, free_iob(), dhcpv6_session::iaid, inet6_ntoa(), iob_len(), dhcpv6_session::lease, malloc(), memcpy(), meta(), net_device::name, dhcpv6_session::netdev, netdev_settings(), dhcpv6_session_state::next, ntohs, NULL, offsetof, options, dhcphdr::options, settings::parent, rc, dhcpv6_session::rc, dhcpv6_session::router, dhcpv6_session_state::rx_type, dhcpv6_session::server_duid, dhcpv6_session::server_duid_len, src, dhcpv6_session::state, strerror(), and typeof().

◆ start_dhcpv6()

int start_dhcpv6	(	struct interface *	job,
		struct net_device *	netdev,
		struct in6_addr *	router,
		int	stateful
	)

Start DHCPv6.

Parameters

job	Job control interface
netdev	Network device
router	Router address
stateful	Perform stateful address autoconfiguration

Return values

rc	Return status code

Definition at line 999 of file dhcpv6.c.

                                                            {
         struct ll_protocol *ll_protocol = netdev->ll_protocol;
         struct dhcpv6_session *dhcpv6;
         struct {
                 union {
                         struct sockaddr_in6 sin6;
                         struct sockaddr sa;
                 } client;
                 union {
                         struct sockaddr_in6 sin6;
                         struct sockaddr sa;
                 } server;
         } addresses;
         uint32_t xid;
         int len;
         int rc;
 
         /* Allocate and initialise structure */
         dhcpv6 = zalloc ( sizeof ( *dhcpv6 ) );
         if ( ! dhcpv6 )
                 return -ENOMEM;
         ref_init ( &dhcpv6->refcnt, dhcpv6_free );
         intf_init ( &dhcpv6->job, &dhcpv6_job_desc, &dhcpv6->refcnt );
         intf_init ( &dhcpv6->xfer, &dhcpv6_xfer_desc, &dhcpv6->refcnt );
         dhcpv6->netdev = netdev_get ( netdev );
         memcpy ( &dhcpv6->router, router, sizeof ( dhcpv6->router ) );
         xid = random();
         memcpy ( dhcpv6->xid, &xid, sizeof ( dhcpv6->xid ) );
         dhcpv6->start = currticks();
         timer_init ( &dhcpv6->timer, dhcpv6_timer_expired, &dhcpv6->refcnt );
 
         /* Construct client and server addresses */
         memset ( &addresses, 0, sizeof ( addresses ) );
         addresses.client.sin6.sin6_family = AF_INET6;
         addresses.client.sin6.sin6_port = htons ( DHCPV6_CLIENT_PORT );
         addresses.server.sin6.sin6_family = AF_INET6;
         ipv6_all_dhcp_relay_and_servers ( &addresses.server.sin6.sin6_addr );
         addresses.server.sin6.sin6_scope_id = netdev->scope_id;
         addresses.server.sin6.sin6_port = htons ( DHCPV6_SERVER_PORT );
 
         /* Construct client DUID from system UUID */
         dhcpv6->client_duid.type = htons ( DHCPV6_DUID_UUID );
         if ( ( len = fetch_uuid_setting ( NULL, &uuid_setting,
                                           &dhcpv6->client_duid.uuid ) ) < 0 ) {
                 rc = len;
                 DBGC ( dhcpv6, "DHCPv6 %s could not create DUID-UUID: %s\n",
                        dhcpv6->netdev->name, strerror ( rc ) );
                 goto err_client_duid;
         }
 
         /* Construct IAID from link-layer address */
         dhcpv6->iaid = crc32_le ( 0, netdev->ll_addr, ll_protocol->ll_addr_len);
         DBGC ( dhcpv6, "DHCPv6 %s has XID %02x%02x%02x\n", dhcpv6->netdev->name,
                dhcpv6->xid[0], dhcpv6->xid[1], dhcpv6->xid[2] );
 
         /* Enter initial state */
         dhcpv6_set_state ( dhcpv6, ( stateful ? &dhcpv6_solicit :
                                      &dhcpv6_information_request ) );
 
         /* Open socket */
         if ( ( rc = xfer_open_socket ( &dhcpv6->xfer, SOCK_DGRAM,
                                        &addresses.server.sa,
                                        &addresses.client.sa ) ) != 0 ) {
                 DBGC ( dhcpv6, "DHCPv6 %s could not open socket: %s\n",
                        dhcpv6->netdev->name, strerror ( rc ) );
                 goto err_open_socket;
         }
 
         /* Attach parent interface, mortalise self, and return */
         intf_plug_plug ( &dhcpv6->job, job );
         ref_put ( &dhcpv6->refcnt );
         return 0;
 
  err_open_socket:
         dhcpv6_finished ( dhcpv6, rc );
  err_client_duid:
         ref_put ( &dhcpv6->refcnt );
         return rc;
 }

References AF_INET6, dhcpv6_session::client_duid, crc32_le(), currticks(), DBGC, DHCPV6_CLIENT_PORT, DHCPV6_DUID_UUID, dhcpv6_finished(), dhcpv6_free(), dhcpv6_information_request, dhcpv6_job_desc, DHCPV6_SERVER_PORT, dhcpv6_set_state(), dhcpv6_solicit, dhcpv6_timer_expired(), dhcpv6_xfer_desc, ENOMEM, fetch_uuid_setting(), htons, dhcpv6_session::iaid, intf_init(), intf_plug_plug(), ipv6_all_dhcp_relay_and_servers(), dhcpv6_session::job, len, net_device::ll_addr, ll_protocol::ll_addr_len, net_device::ll_protocol, memcpy(), memset(), net_device::name, netdev, dhcpv6_session::netdev, netdev_get(), NULL, random(), rc, ref_init, ref_put, dhcpv6_session::refcnt, dhcpv6_session::router, sa, net_device::scope_id, sin6, SOCK_DGRAM, dhcpv6_session::start, strerror(), dhcpv6_session::timer, dhcpv6_duid_uuid::type, dhcpv6_duid_uuid::uuid, dhcpv6_session::xfer, xfer_open_socket(), dhcpv6_session::xid, and zalloc().

Referenced by ipv6conf_rx_router_advertisement().

◆ __setting() [1/2]

const struct setting filename6_setting __setting	(	SETTING_BOOT	,
		filename
	)

Boot filename setting.

◆ __setting() [2/2]

const struct setting dnssl6_setting __setting	(	SETTING_IP_EXTRA	,
		dnssl
	)

DNS search list setting.

Variable Documentation

◆ __errortab

struct errortab dhcpv6_errors [] __errortab

Initial value:

= {
        __einfo_errortab ( EINFO_EPROTO_NOADDRSAVAIL ),
}

Human-readable error messages.

Definition at line 74 of file dhcpv6.c.

◆ dhcpv6_address_operations

struct dhcpv6_address_operation dhcpv6_address_operations[]

static

Initial value:

= {
        { &ip6_setting, dhcpv6_fetch_ip6 },
        { &len6_setting, dhcpv6_fetch_len6 },
        { &gateway6_setting, dhcpv6_fetch_gateway6 },
}

DHCPv6 address settings operations.

Definition at line 371 of file dhcpv6.c.

Referenced by dhcpv6_fetch().

◆ dhcpv6_settings_operations

struct settings_operations dhcpv6_settings_operations

static

Initial value:

= {
        .applies = dhcpv6_applies,
        .fetch = dhcpv6_fetch,
}

DHCPv6 settings operations.

Definition at line 421 of file dhcpv6.c.

Referenced by dhcpv6_register().

◆ dhcpv6_request_options_data

uint8_t dhcpv6_request_options_data[]

static

Initial value:

= {
        DHCPV6_CODE ( DHCPV6_OPTION_REQUEST ),
        DHCPV6_OPTION ( DHCPV6_CODE ( DHCPV6_DNS_SERVERS ),
                        DHCPV6_CODE ( DHCPV6_DOMAIN_LIST ),
                        DHCPV6_CODE ( DHCPV6_BOOTFILE_URL ),
                        DHCPV6_CODE ( DHCPV6_BOOTFILE_PARAM ) ),
        DHCPV6_CODE ( DHCPV6_VENDOR_CLASS ),
        DHCPV6_OPTION ( DHCPV6_DWORD_VALUE ( DHCPV6_VENDOR_CLASS_PXE ),
                        DHCPV6_STRING (
                          DHCP_VENDOR_PXECLIENT ( DHCP_ARCH_CLIENT_ARCHITECTURE,
                                                  DHCP_ARCH_CLIENT_NDI ) ) ),
        DHCPV6_CODE ( DHCPV6_CLIENT_ARCHITECTURE ),
        DHCPV6_WORD ( DHCP_ARCH_CLIENT_ARCHITECTURE ),
        DHCPV6_CODE ( DHCPV6_CLIENT_NDI ),
}

Raw option data for options common to all DHCPv6 requests.

Definition at line 479 of file dhcpv6.c.

Referenced by dhcpv6_tx().

◆ dhcpv6_request

struct dhcpv6_session_state dhcpv6_request

static

Initial value:

= {
        .tx_type = DHCPV6_REQUEST,
        .rx_type = DHCPV6_REPLY,
        .flags = ( DHCPV6_TX_IA_NA | DHCPV6_TX_IAADDR |
                   DHCPV6_RX_RECORD_IAADDR ),
        .next = NULL,
}

DHCPv6 request state.

Definition at line 543 of file dhcpv6.c.

◆ dhcpv6_solicit

struct dhcpv6_session_state dhcpv6_solicit

static

Initial value:

= {
        .tx_type = DHCPV6_SOLICIT,
        .rx_type = DHCPV6_ADVERTISE,
        .flags = ( DHCPV6_TX_IA_NA | DHCPV6_RX_RECORD_SERVER_ID |
                   DHCPV6_RX_RECORD_IAADDR ),
        .next = &dhcpv6_request,
}

DHCPv6 solicitation state.

Definition at line 552 of file dhcpv6.c.

Referenced by start_dhcpv6().

◆ dhcpv6_information_request

struct dhcpv6_session_state dhcpv6_information_request

static

Initial value:

= {
        .tx_type = DHCPV6_INFORMATION_REQUEST,
        .rx_type = DHCPV6_REPLY,
        .flags = 0,
        .next = NULL,
}

DHCPv6 information request state.

Definition at line 561 of file dhcpv6.c.

Referenced by start_dhcpv6().

◆ dhcpv6_job_op

struct interface_operation dhcpv6_job_op[]

static

Initial value:

= {
        INTF_OP ( intf_close, struct dhcpv6_session *, dhcpv6_finished ),
}

DHCPv6 job control interface operations.

Definition at line 973 of file dhcpv6.c.

◆ dhcpv6_job_desc

struct interface_descriptor dhcpv6_job_desc

static

Initial value:

=

INTF_DESC ( struct dhcpv6_session, job, dhcpv6_job_op )

dhcpv6_session

A DHCPv6 session.

Definition: dhcpv6.c:569

dhcpv6_job_op

static struct interface_operation dhcpv6_job_op[]

DHCPv6 job control interface operations.

Definition: dhcpv6.c:973

INTF_DESC

#define INTF_DESC(object_type, intf, operations)

Define an object interface descriptor.

Definition: interface.h:80

DHCPv6 job control interface descriptor.

Definition at line 978 of file dhcpv6.c.

Referenced by start_dhcpv6().

◆ dhcpv6_xfer_op

struct interface_operation dhcpv6_xfer_op[]

static

Initial value:

= {
        INTF_OP ( xfer_deliver, struct dhcpv6_session *, dhcpv6_rx ),
}

DHCPv6 data transfer interface operations.

Definition at line 982 of file dhcpv6.c.

◆ dhcpv6_xfer_desc

struct interface_descriptor dhcpv6_xfer_desc

static

Initial value:

=

INTF_DESC ( struct dhcpv6_session, xfer, dhcpv6_xfer_op )

dhcpv6_session

A DHCPv6 session.

Definition: dhcpv6.c:569

dhcpv6_xfer_op

static struct interface_operation dhcpv6_xfer_op[]

DHCPv6 data transfer interface operations.

Definition: dhcpv6.c:982

INTF_DESC

#define INTF_DESC(object_type, intf, operations)

Define an object interface descriptor.

Definition: interface.h:80

DHCPv6 data transfer interface descriptor.

Definition at line 987 of file dhcpv6.c.

Referenced by start_dhcpv6().

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ EPROTO_UNSPECFAIL

◆ EINFO_EPROTO_UNSPECFAIL

◆ EPROTO_NOADDRSAVAIL

◆ EINFO_EPROTO_NOADDRSAVAIL

◆ EPROTO_NOBINDING

◆ EINFO_EPROTO_NOBINDING

◆ EPROTO_NOTONLINK

◆ EINFO_EPROTO_NOTONLINK

◆ EPROTO_USEMULTICAST

◆ EINFO_EPROTO_USEMULTICAST

◆ EPROTO_STATUS

Enumeration Type Documentation

◆ dhcpv6_session_state_flags

Function Documentation

◆ FILE_LICENCE()

◆ dhcpv6_option()

◆ dhcpv6_check_duid()

◆ dhcpv6_status_code()

◆ dhcpv6_iaaddr()

◆ dhcpv6_applies()

◆ dhcpv6_fetch_ip6()

◆ dhcpv6_fetch_len6()

◆ dhcpv6_fetch_gateway6()

◆ dhcpv6_fetch()

◆ dhcpv6_register()

◆ dhcpv6_type_name()

◆ dhcpv6_free()

◆ dhcpv6_finished()

◆ dhcpv6_set_state()

◆ dhcpv6_user_class()

◆ dhcpv6_tx()

◆ dhcpv6_timer_expired()

◆ dhcpv6_rx()

◆ start_dhcpv6()

◆ __setting() [1/2]

◆ __setting() [2/2]

Variable Documentation

◆ __errortab

◆ dhcpv6_address_operations

◆ dhcpv6_settings_operations

◆ dhcpv6_request_options_data

◆ dhcpv6_request

◆ dhcpv6_solicit

◆ dhcpv6_information_request

◆ dhcpv6_job_op

◆ dhcpv6_job_desc

◆ dhcpv6_xfer_op

◆ dhcpv6_xfer_desc