iPXE
cachedhcp.h File Reference

Cached DHCP packet. More...

#include <stddef.h>

Go to the source code of this file.

Functions

 FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
 FILE_SECBOOT (PERMITTED)
int cachedhcp_record (struct cached_dhcp_packet *cache, unsigned int vlan, const void *data, size_t max_len)
 Record cached DHCP packet.
void cachedhcp_recycle (struct net_device *netdev)
 Recycle cached DHCPACK.

Variables

struct cached_dhcp_packet cached_dhcpack
 Cached DHCPACK.
struct cached_dhcp_packet cached_proxydhcp
 Cached ProxyDHCPOFFER.
struct cached_dhcp_packet cached_pxebs
 Cached PXEBSACK.

Detailed Description

Cached DHCP packet.

Definition in file cachedhcp.h.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ FILE_SECBOOT()

FILE_SECBOOT ( PERMITTED )

◆ cachedhcp_record()

int cachedhcp_record ( struct cached_dhcp_packet * cache,
unsigned int vlan,
const void * data,
size_t max_len )
extern

Record cached DHCP packet.

Parameters
cacheCached DHCP packet
vlanVLAN tag, if any
dataDHCPACK packet buffer
max_lenMaximum possible length
Return values
rcReturn status code

Definition at line 251 of file cachedhcp.c.

252 {
253 struct dhcp_packet *dhcppkt;
254 struct dhcp_packet *tmp;
255 struct dhcphdr *dhcphdr;
256 struct uri *uri;
257 unsigned int i;
258 size_t len;
259
260 /* Free any existing cached packet */
261 cachedhcp_free ( cache );
262
263 /* Allocate and populate DHCP packet */
264 dhcppkt = zalloc ( sizeof ( *dhcppkt ) + max_len );
265 if ( ! dhcppkt ) {
266 DBGC ( colour, "CACHEDHCP %s could not allocate copy\n",
267 cache->name );
268 return -ENOMEM;
269 }
270 dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
271 memcpy ( dhcphdr, data, max_len );
272 dhcppkt_init ( dhcppkt, dhcphdr, max_len );
273
274 /* Shrink packet to required length. If reallocation fails,
275 * just continue to use the original packet and waste the
276 * unused space.
277 */
278 len = dhcppkt_len ( dhcppkt );
279 assert ( len <= max_len );
280 tmp = realloc ( dhcppkt, ( sizeof ( *dhcppkt ) + len ) );
281 if ( tmp )
282 dhcppkt = tmp;
283
284 /* Reinitialise packet at new address */
285 dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
286 dhcppkt_init ( dhcppkt, dhcphdr, len );
287
288 /* Discard duplicate packets, since some PXE stacks (including
289 * iPXE itself) will report the DHCPACK packet as the PXEBSACK
290 * if no separate PXEBSACK exists.
291 */
292 for ( i = 0 ; i < ( sizeof ( cached_packets ) /
293 sizeof ( cached_packets[0] ) ) ; i++ ) {
294 tmp = cached_packets[i]->dhcppkt;
295 if ( tmp && ( dhcppkt_len ( tmp ) == len ) &&
296 ( memcmp ( tmp->dhcphdr, dhcppkt->dhcphdr, len ) == 0 ) ) {
297 DBGC ( colour, "CACHEDHCP %s duplicates %s\n",
298 cache->name, cached_packets[i]->name );
299 dhcppkt_put ( dhcppkt );
300 return -EEXIST;
301 }
302 }
303
304 /* Store as cached packet */
305 DBGC ( colour, "CACHEDHCP %s at %#08lx+%#zx/%#zx\n", cache->name,
306 virt_to_phys ( data ), len, max_len );
307 cache->dhcppkt = dhcppkt;
308 cache->vlan = vlan;
309
310 /* Set current working URI, if defined in this packet */
311 uri = cachedhcp_uri ( cache );
312 if ( uri )
313 churi ( uri );
314 uri_put ( uri );
315
316 return 0;
317}
#define colour
Colour for debug messages.
Definition acpi.c:42
#define assert(condition)
Assert a condition at run-time.
Definition assert.h:50
static struct cached_dhcp_packet * cached_packets[]
List of cached DHCP packets.
Definition cachedhcp.c:80
static void cachedhcp_free(struct cached_dhcp_packet *cache)
Free cached DHCP packet.
Definition cachedhcp.c:94
static struct uri * cachedhcp_uri(struct cached_dhcp_packet *cache)
Get URI from cached DHCP packet.
Definition cachedhcp.c:204
void churi(struct uri *uri)
Change working URI.
Definition cwuri.c:46
void dhcppkt_init(struct dhcp_packet *dhcppkt, struct dhcphdr *data, size_t len)
Initialise DHCP packet.
Definition dhcppkt.c:301
static void dhcppkt_put(struct dhcp_packet *dhcppkt)
Decrement reference count on DHCP packet.
Definition dhcppkt.h:50
static size_t dhcppkt_len(struct dhcp_packet *dhcppkt)
Get used length of DHCP packet.
Definition dhcppkt.h:60
ring len
Length.
Definition dwmac.h:226
uint8_t data[48]
Additional event data.
Definition ena.h:11
#define DBGC(...)
Definition compiler.h:505
#define EEXIST
File exists.
Definition errno.h:389
#define ENOMEM
Not enough space.
Definition errno.h:535
void * memcpy(void *dest, const void *src, size_t len) __nonnull
unsigned long tmp
Definition linux_pci.h:65
void * realloc(void *old_ptr, size_t new_size)
Reallocate memory.
Definition malloc.c:607
void * zalloc(size_t size)
Allocate cleared memory.
Definition malloc.c:662
int memcmp(const void *first, const void *second, size_t len)
Compare memory regions.
Definition string.c:115
struct dhcp_packet * dhcppkt
DHCP packet (if any)
Definition cachedhcp.c:50
unsigned int vlan
VLAN tag (if applicable)
Definition cachedhcp.c:52
const char * name
Settings block name.
Definition cachedhcp.c:48
A DHCP packet.
Definition dhcppkt.h:21
struct dhcphdr * dhcphdr
The DHCP packet contents.
Definition dhcppkt.h:25
A DHCP header.
Definition dhcp.h:616
A Uniform Resource Identifier.
Definition uri.h:65
static void uri_put(struct uri *uri)
Decrement URI reference count.
Definition uri.h:206

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

Referenced by cachedhcp_init(), and efi_cachedhcp_record().

◆ cachedhcp_recycle()

void cachedhcp_recycle ( struct net_device * netdev)
extern

Recycle cached DHCPACK.

Parameters
netdevNetwork device
privPrivate data

Definition at line 410 of file cachedhcp.c.

410 {
411 struct cached_dhcp_packet *cache = &cached_dhcpack;
412 struct settings *settings;
413
414 /* Return DHCPACK to cache, if applicable */
416 cache->name );
417 if ( cache->dhcppkt && ( settings == &cache->dhcppkt->settings ) ) {
418 DBGC ( colour, "CACHEDHCP %s recycled from %s\n",
419 cache->name, netdev->name );
420 assert ( cache->flags & CACHEDHCP_USED );
422 cache->flags &= ~CACHEDHCP_USED;
423 }
424}
#define CACHEDHCP_USED
Cached DHCP packet has been used.
Definition cachedhcp.c:61
struct cached_dhcp_packet cached_dhcpack
Cached DHCPACK.
Definition cachedhcp.c:64
static struct net_device * netdev
Definition gdbudp.c:53
static struct settings * netdev_settings(struct net_device *netdev)
Get per-netdevice configuration settings block.
Definition netdevice.h:590
void unregister_settings(struct settings *settings)
Unregister settings block.
Definition settings.c:515
struct settings * find_child_settings(struct settings *parent, const char *name)
Find child settings block.
Definition settings.c:280
A cached DHCP packet.
Definition cachedhcp.c:46
unsigned int flags
Flags.
Definition cachedhcp.c:54
struct settings settings
Settings interface.
Definition dhcppkt.h:29
A settings block.
Definition settings.h:133

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

Referenced by mnptemp_destroy().

Variable Documentation

◆ cached_dhcpack

struct cached_dhcp_packet cached_dhcpack
extern

Cached DHCPACK.

Definition at line 64 of file cachedhcp.c.

64 {
65 .name = DHCP_SETTINGS_NAME,
66 .flags = CACHEDHCP_RETAIN,
67};
#define CACHEDHCP_RETAIN
Cached DHCP packet should be retained.
Definition cachedhcp.c:58
#define DHCP_SETTINGS_NAME
Settings block name used for DHCP responses.
Definition dhcp.h:711

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

◆ cached_proxydhcp

struct cached_dhcp_packet cached_proxydhcp
extern

Cached ProxyDHCPOFFER.

Definition at line 70 of file cachedhcp.c.

70 {
72};
#define PROXYDHCP_SETTINGS_NAME
Settings block name used for ProxyDHCP responses.
Definition dhcp.h:714

Referenced by cachedhcp_startup_early(), efi_cachedhcp_record(), and FILE_SECBOOT().

◆ cached_pxebs

struct cached_dhcp_packet cached_pxebs
extern

Cached PXEBSACK.

Definition at line 75 of file cachedhcp.c.

75 {
76 .name = PXEBS_SETTINGS_NAME,
77};
#define PXEBS_SETTINGS_NAME
Setting block name used for BootServerDHCP responses.
Definition dhcp.h:717

Referenced by cachedhcp_startup_early(), efi_cachedhcp_record(), and FILE_SECBOOT().