cachedhcp.c File Reference

Cached DHCP packet. More...

#include <stdint.h>
#include <stdlib.h>
#include <errno.h>
#include <ipxe/dhcppkt.h>
#include <ipxe/init.h>
#include <ipxe/netdevice.h>
#include <ipxe/vlan.h>
#include <ipxe/cachedhcp.h>

Go to the source code of this file.

Data Structures
struct	cached_dhcp_packet
	A cached DHCP packet. More...

Macros
#define	CACHEDHCP_RETAIN   0x0001
	Cached DHCP packet should be retained. More...
#define	CACHEDHCP_USED   0x0002
	Cached DHCP packet has been used. More...
#define	colour   &cached_dhcpack
	Colour for debug messages. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static void	cachedhcp_free (struct cached_dhcp_packet *cache)
	Free cached DHCP packet. More...
static int	cachedhcp_apply (struct cached_dhcp_packet *cache, struct net_device *netdev)
	Apply cached DHCP packet settings. More...
int	cachedhcp_record (struct cached_dhcp_packet *cache, unsigned int vlan, userptr_t data, size_t max_len)
	Record cached DHCP packet. More...
static void	cachedhcp_startup_early (void)
	Cached DHCP packet early startup function. More...
static void	cachedhcp_startup_late (void)
	Cache DHCP packet late startup function. More...
static void	cachedhcp_shutdown (int booting __unused)
	Cached DHCP packet shutdown function. More...
struct startup_fn cachedhcp_early_fn	__startup_fn (STARTUP_EARLY)
	Cached DHCP packet early startup function. More...
struct startup_fn cachedhcp_late_fn	__startup_fn (STARTUP_LATE)
	Cached DHCP packet late startup function. More...
static int	cachedhcp_probe (struct net_device *netdev, void *priv __unused)
	Apply cached DHCPACK to network device, if applicable. More...
void	cachedhcp_recycle (struct net_device *netdev)
	Recycle cached DHCPACK. More...

Variables
struct cached_dhcp_packet	cached_dhcpack
	Cached DHCPACK. More...
struct cached_dhcp_packet	cached_proxydhcp
	Cached ProxyDHCPOFFER. More...
struct cached_dhcp_packet	cached_pxebs
	Cached PXEBSACK. More...
static struct cached_dhcp_packet *	cached_packets []
	List of cached DHCP packets. More...
struct net_driver cachedhcp_driver	__net_driver
	Cached DHCP packet network device driver. More...

Detailed Description

Cached DHCP packet.

Definition in file cachedhcp.c.

Macro Definition Documentation

CACHEDHCP_RETAIN

#define CACHEDHCP_RETAIN   0x0001

Cached DHCP packet should be retained.

Definition at line 54 of file cachedhcp.c.

CACHEDHCP_USED

#define CACHEDHCP_USED   0x0002

Cached DHCP packet has been used.

Definition at line 57 of file cachedhcp.c.

colour

#define colour   &cached_dhcpack

Colour for debug messages.

Definition at line 83 of file cachedhcp.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

cachedhcp_free()

static void cachedhcp_free ( struct cached_dhcp_packet *  cache )

static

Free cached DHCP packet.

Parameters

cache

Cached DHCP packet

Definition at line 90 of file cachedhcp.c.

                                                                {

        dhcppkt_put ( cache->dhcppkt );
        cache->dhcppkt = NULL;
}

References cached_dhcp_packet::dhcppkt, dhcppkt_put(), and NULL.

Referenced by cachedhcp_apply(), cachedhcp_record(), cachedhcp_shutdown(), cachedhcp_startup_early(), and cachedhcp_startup_late().

cachedhcp_apply()

static int cachedhcp_apply ( struct cached_dhcp_packet *  cache, struct net_device *  netdev  )

static

Apply cached DHCP packet settings.

Parameters

cache	Cached DHCP packet
netdev	Network device, or NULL

Return values

rc	Return status code

Definition at line 103 of file cachedhcp.c.

                                                         {
        struct settings *settings = NULL;
        struct ll_protocol *ll_protocol;
        const uint8_t *chaddr;
        uint8_t *hw_addr;
        uint8_t *ll_addr;
        size_t ll_addr_len;
        int rc;

        /* Do nothing if cache is empty or already in use */
        if ( ( ! cache->dhcppkt ) || ( cache->flags & CACHEDHCP_USED ) )
                return 0;
        chaddr = cache->dhcppkt->dhcphdr->chaddr;

        /* Handle association with network device, if specified */
        if ( netdev ) {
                hw_addr = netdev->hw_addr;
                ll_addr = netdev->ll_addr;
                ll_protocol = netdev->ll_protocol;
                ll_addr_len = ll_protocol->ll_addr_len;

                /* If cached packet's MAC address matches the network
                 * device's permanent MAC address, then assume that
                 * the permanent MAC address ought to be the network
                 * device's current link-layer address.
                 *
                 * This situation can arise when the PXE ROM does not
                 * understand the system-specific mechanism for
                 * overriding the MAC address, and so uses the
                 * permanent MAC address instead.  We choose to match
                 * this behaviour in order to minimise surprise.
                 */
                if ( memcmp ( hw_addr, chaddr, ll_addr_len ) == 0 ) {
                        if ( memcmp ( hw_addr, ll_addr, ll_addr_len ) != 0 ) {
                                DBGC ( colour, "CACHEDHCP %s resetting %s MAC "
                                       "%s ", cache->name, netdev->name,
                                       ll_protocol->ntoa ( ll_addr ) );
                                DBGC ( colour, "-> %s\n",
                                       ll_protocol->ntoa ( hw_addr ) );
                        }
                        memcpy ( ll_addr, hw_addr, ll_addr_len );
                }

                /* Do nothing unless cached packet's MAC address
                 * matches this network device.
                 */
                if ( memcmp ( ll_addr, chaddr, ll_addr_len ) != 0 ) {
                        DBGC ( colour, "CACHEDHCP %s %s does not match %s\n",
                               cache->name, ll_protocol->ntoa ( chaddr ),
                               netdev->name );
                        return 0;
                }

                /* Do nothing unless cached packet's VLAN tag matches
                 * this network device.
                 */
                if ( vlan_tag ( netdev ) != cache->vlan ) {
                        DBGC ( colour, "CACHEDHCP %s VLAN %d does not match "
                               "%s\n", cache->name, cache->vlan,
                               netdev->name );
                        return 0;
                }

                /* Use network device's settings block */
                settings = netdev_settings ( netdev );
                DBGC ( colour, "CACHEDHCP %s is for %s\n",
                       cache->name, netdev->name );
        }

        /* Register settings */
        if ( ( rc = register_settings ( &cache->dhcppkt->settings, settings,
                                        cache->name ) ) != 0 ) {
                DBGC ( colour, "CACHEDHCP %s could not register settings: %s\n",
                       cache->name, strerror ( rc ) );
                return rc;
        }

        /* Mark as used */
        cache->flags |= CACHEDHCP_USED;

        /* Free cached DHCP packet, if applicable */
        if ( ! ( cache->flags & CACHEDHCP_RETAIN ) )
                cachedhcp_free ( cache );

        return 0;
}

References cachedhcp_free(), CACHEDHCP_RETAIN, CACHEDHCP_USED, dhcphdr::chaddr, colour, DBGC, dhcp_packet::dhcphdr, cached_dhcp_packet::dhcppkt, cached_dhcp_packet::flags, net_device::hw_addr, net_device::ll_addr, ll_protocol::ll_addr_len, net_device::ll_protocol, memcmp(), memcpy(), cached_dhcp_packet::name, net_device::name, netdev, netdev_settings(), ll_protocol::ntoa, NULL, rc, register_settings(), dhcp_packet::settings, strerror(), cached_dhcp_packet::vlan, and vlan_tag().

Referenced by cachedhcp_probe(), and cachedhcp_startup_early().

cachedhcp_record()

int cachedhcp_record	(	struct cached_dhcp_packet *	cache,
		unsigned int	vlan,
		userptr_t	data,
		size_t	max_len
	)

Record cached DHCP packet.

Parameters

cache	Cached DHCP packet
vlan	VLAN tag, if any
data	DHCPACK packet buffer
max_len	Maximum possible length

Return values

rc	Return status code

Definition at line 200 of file cachedhcp.c.

                                                        {
        struct dhcp_packet *dhcppkt;
        struct dhcp_packet *tmp;
        struct dhcphdr *dhcphdr;
        unsigned int i;
        size_t len;

        /* Free any existing cached packet */
        cachedhcp_free ( cache );

        /* Allocate and populate DHCP packet */
        dhcppkt = zalloc ( sizeof ( *dhcppkt ) + max_len );
        if ( ! dhcppkt ) {
                DBGC ( colour, "CACHEDHCP %s could not allocate copy\n",
                       cache->name );
                return -ENOMEM;
        }
        dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
        copy_from_user ( dhcphdr, data, 0, max_len );
        dhcppkt_init ( dhcppkt, dhcphdr, max_len );

        /* Shrink packet to required length.  If reallocation fails,
         * just continue to use the original packet and waste the
         * unused space.
         */
        len = dhcppkt_len ( dhcppkt );
        assert ( len <= max_len );
        tmp = realloc ( dhcppkt, ( sizeof ( *dhcppkt ) + len ) );
        if ( tmp )
                dhcppkt = tmp;

        /* Reinitialise packet at new address */
        dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
        dhcppkt_init ( dhcppkt, dhcphdr, len );

        /* Discard duplicate packets, since some PXE stacks (including
         * iPXE itself) will report the DHCPACK packet as the PXEBSACK
         * if no separate PXEBSACK exists.
         */
        for ( i = 0 ; i < ( sizeof ( cached_packets ) /
                            sizeof ( cached_packets[0] ) ) ; i++ ) {
                tmp = cached_packets[i]->dhcppkt;
                if ( tmp && ( dhcppkt_len ( tmp ) == len ) &&
                     ( memcmp ( tmp->dhcphdr, dhcppkt->dhcphdr, len ) == 0 ) ) {
                        DBGC ( colour, "CACHEDHCP %s duplicates %s\n",
                               cache->name, cached_packets[i]->name );
                        dhcppkt_put ( dhcppkt );
                        return -EEXIST;
                }
        }

        /* Store as cached packet */
        DBGC ( colour, "CACHEDHCP %s at %#08lx+%#zx/%#zx\n", cache->name,
               user_to_phys ( data, 0 ), len, max_len );
        cache->dhcppkt = dhcppkt;
        cache->vlan = vlan;

        return 0;
}

References assert(), cached_packets, cachedhcp_free(), colour, copy_from_user(), data, DBGC, dhcp_packet::dhcphdr, cached_dhcp_packet::dhcppkt, dhcppkt_init(), dhcppkt_len(), dhcppkt_put(), EEXIST, ENOMEM, len, memcmp(), cached_dhcp_packet::name, realloc(), tmp, user_to_phys(), cached_dhcp_packet::vlan, and zalloc().

Referenced by cachedhcp_init(), and efi_cachedhcp_record().

cachedhcp_startup_early()

static void cachedhcp_startup_early ( void  )

static

Cached DHCP packet early startup function.

Definition at line 265 of file cachedhcp.c.

                                             {

        /* Apply cached ProxyDHCPOFFER, if any */
        cachedhcp_apply ( &cached_proxydhcp, NULL );
        cachedhcp_free ( &cached_proxydhcp );

        /* Apply cached PXEBSACK, if any */
        cachedhcp_apply ( &cached_pxebs, NULL );
        cachedhcp_free ( &cached_pxebs );
}

References cached_proxydhcp, cached_pxebs, cachedhcp_apply(), cachedhcp_free(), and NULL.

cachedhcp_startup_late()

static void cachedhcp_startup_late ( void  )

static

Cache DHCP packet late startup function.

Definition at line 280 of file cachedhcp.c.

                                            {

        /* Clear retention flag */
        cached_dhcpack.flags &= ~CACHEDHCP_RETAIN;

        /* Free cached DHCPACK, if used by a network device */
        if ( cached_dhcpack.flags & CACHEDHCP_USED )
                cachedhcp_free ( &cached_dhcpack );

        /* Report unclaimed DHCPACK, if any.  Do not free yet, since
         * it may still be claimed by a dynamically created device
         * such as a VLAN device.
         */
        if ( cached_dhcpack.dhcppkt ) {
                DBGC ( colour, "CACHEDHCP %s unclaimed\n",
                       cached_dhcpack.name );
        }
}

References cached_dhcpack, cachedhcp_free(), CACHEDHCP_RETAIN, CACHEDHCP_USED, colour, DBGC, cached_dhcp_packet::dhcppkt, cached_dhcp_packet::flags, and cached_dhcp_packet::name.

cachedhcp_shutdown()

static void cachedhcp_shutdown ( int booting  __unused )

static

Cached DHCP packet shutdown function.

Parameters

booting

System is shutting down for OS boot

Definition at line 304 of file cachedhcp.c.

                                                        {

        /* Free cached DHCPACK, if any */
        if ( cached_dhcpack.dhcppkt ) {
                DBGC ( colour, "CACHEDHCP %s never claimed\n",
                       cached_dhcpack.name );
        }
        cachedhcp_free ( &cached_dhcpack );
}

References cached_dhcpack, cachedhcp_free(), colour, DBGC, cached_dhcp_packet::dhcppkt, and cached_dhcp_packet::name.

__startup_fn() [1/2]

struct startup_fn cachedhcp_early_fn __startup_fn

(

STARTUP_EARLY

)

Cached DHCP packet early startup function.

__startup_fn() [2/2]

struct startup_fn cachedhcp_late_fn __startup_fn

(

STARTUP_LATE

)

Cached DHCP packet late startup function.

cachedhcp_probe()

static int cachedhcp_probe ( struct net_device *  netdev, void *priv  __unused  )

static

Apply cached DHCPACK to network device, if applicable.

Parameters

netdev	Network device
priv	Private data

Return values

rc	Return status code

Definition at line 334 of file cachedhcp.c.

                                                                              {

        /* Apply cached DHCPACK to network device, if applicable */
        return cachedhcp_apply ( &cached_dhcpack, netdev );
}

References cached_dhcpack, cachedhcp_apply(), and netdev.

cachedhcp_recycle()

void cachedhcp_recycle

(

struct net_device *

netdev

)

Recycle cached DHCPACK.

Parameters

netdev	Network device
priv	Private data

Definition at line 352 of file cachedhcp.c.

                                                     {
        struct cached_dhcp_packet *cache = &cached_dhcpack;
        struct settings *settings;

        /* Return DHCPACK to cache, if applicable */
        settings = find_child_settings ( netdev_settings ( netdev ),
                                         cache->name );
        if ( cache->dhcppkt && ( settings == &cache->dhcppkt->settings ) ) {
                DBGC ( colour, "CACHEDHCP %s recycled from %s\n",
                       cache->name, netdev->name );
                assert ( cache->flags & CACHEDHCP_USED );
                unregister_settings ( settings );
                cache->flags &= ~CACHEDHCP_USED;
        }
}

References assert(), cached_dhcpack, CACHEDHCP_USED, colour, DBGC, cached_dhcp_packet::dhcppkt, find_child_settings(), cached_dhcp_packet::flags, cached_dhcp_packet::name, net_device::name, netdev, netdev_settings(), dhcp_packet::settings, and unregister_settings().

Referenced by mnptemp_destroy().

Variable Documentation

cached_dhcpack

struct cached_dhcp_packet cached_dhcpack

Initial value:

= {
        .name = DHCP_SETTINGS_NAME,
        .flags = CACHEDHCP_RETAIN,
}

Cached DHCPACK.

Definition at line 60 of file cachedhcp.c.

Referenced by cachedhcp_init(), cachedhcp_probe(), cachedhcp_recycle(), cachedhcp_shutdown(), cachedhcp_startup_late(), and efi_cachedhcp_record().

cached_proxydhcp

struct cached_dhcp_packet cached_proxydhcp

Initial value:

= {
        .name = PROXYDHCP_SETTINGS_NAME,
}

Cached ProxyDHCPOFFER.

Definition at line 66 of file cachedhcp.c.

Referenced by cachedhcp_startup_early(), and efi_cachedhcp_record().

cached_pxebs

struct cached_dhcp_packet cached_pxebs

Initial value:

= {
        .name = PXEBS_SETTINGS_NAME,
}

Cached PXEBSACK.

Definition at line 71 of file cachedhcp.c.

Referenced by cachedhcp_startup_early(), and efi_cachedhcp_record().

cached_packets

struct cached_dhcp_packet* cached_packets[]

static

Initial value:

= {
        &cached_dhcpack,
        &cached_proxydhcp,
        &cached_pxebs,
}

List of cached DHCP packets.

Definition at line 76 of file cachedhcp.c.

Referenced by cachedhcp_record().

__net_driver

struct net_driver cachedhcp_driver __net_driver

Initial value:

= {
        .name = "cachedhcp",
        .probe = cachedhcp_probe,
}

Cached DHCP packet network device driver.

Definition at line 341 of file cachedhcp.c.