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 203 of file cachedhcp.c.

204 {
205 struct dhcp_packet *dhcppkt;
206 struct dhcp_packet *tmp;
207 struct dhcphdr *dhcphdr;
208 unsigned int i;
209 size_t len;
210
211 /* Free any existing cached packet */
212 cachedhcp_free ( cache );
213
214 /* Allocate and populate DHCP packet */
215 dhcppkt = zalloc ( sizeof ( *dhcppkt ) + max_len );
216 if ( ! dhcppkt ) {
217 DBGC ( colour, "CACHEDHCP %s could not allocate copy\n",
218 cache->name );
219 return -ENOMEM;
220 }
221 dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
222 memcpy ( dhcphdr, data, max_len );
223 dhcppkt_init ( dhcppkt, dhcphdr, max_len );
224
225 /* Shrink packet to required length. If reallocation fails,
226 * just continue to use the original packet and waste the
227 * unused space.
228 */
229 len = dhcppkt_len ( dhcppkt );
230 assert ( len <= max_len );
231 tmp = realloc ( dhcppkt, ( sizeof ( *dhcppkt ) + len ) );
232 if ( tmp )
233 dhcppkt = tmp;
234
235 /* Reinitialise packet at new address */
236 dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
237 dhcppkt_init ( dhcppkt, dhcphdr, len );
238
239 /* Discard duplicate packets, since some PXE stacks (including
240 * iPXE itself) will report the DHCPACK packet as the PXEBSACK
241 * if no separate PXEBSACK exists.
242 */
243 for ( i = 0 ; i < ( sizeof ( cached_packets ) /
244 sizeof ( cached_packets[0] ) ) ; i++ ) {
245 tmp = cached_packets[i]->dhcppkt;
246 if ( tmp && ( dhcppkt_len ( tmp ) == len ) &&
247 ( memcmp ( tmp->dhcphdr, dhcppkt->dhcphdr, len ) == 0 ) ) {
248 DBGC ( colour, "CACHEDHCP %s duplicates %s\n",
249 cache->name, cached_packets[i]->name );
250 dhcppkt_put ( dhcppkt );
251 return -EEXIST;
252 }
253 }
254
255 /* Store as cached packet */
256 DBGC ( colour, "CACHEDHCP %s at %#08lx+%#zx/%#zx\n", cache->name,
257 virt_to_phys ( data ), len, max_len );
258 cache->dhcppkt = dhcppkt;
259 cache->vlan = vlan;
260
261 return 0;
262}
#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:79
static void cachedhcp_free(struct cached_dhcp_packet *cache)
Free cached DHCP packet.
Definition cachedhcp.c:93
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:49
unsigned int vlan
VLAN tag (if applicable)
Definition cachedhcp.c:51
const char * name
Settings block name.
Definition cachedhcp.c:47
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

References assert, cached_packets, cachedhcp_free(), 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, 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 355 of file cachedhcp.c.

355 {
356 struct cached_dhcp_packet *cache = &cached_dhcpack;
357 struct settings *settings;
358
359 /* Return DHCPACK to cache, if applicable */
361 cache->name );
362 if ( cache->dhcppkt && ( settings == &cache->dhcppkt->settings ) ) {
363 DBGC ( colour, "CACHEDHCP %s recycled from %s\n",
364 cache->name, netdev->name );
365 assert ( cache->flags & CACHEDHCP_USED );
367 cache->flags &= ~CACHEDHCP_USED;
368 }
369}
#define CACHEDHCP_USED
Cached DHCP packet has been used.
Definition cachedhcp.c:60
struct cached_dhcp_packet cached_dhcpack
Cached DHCPACK.
Definition cachedhcp.c:63
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:587
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:45
unsigned int flags
Flags.
Definition cachedhcp.c:53
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 63 of file cachedhcp.c.

63 {
64 .name = DHCP_SETTINGS_NAME,
65 .flags = CACHEDHCP_RETAIN,
66};
#define CACHEDHCP_RETAIN
Cached DHCP packet should be retained.
Definition cachedhcp.c:57
#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 69 of file cachedhcp.c.

69 {
71};
#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 74 of file cachedhcp.c.

74 {
75 .name = PXEBS_SETTINGS_NAME,
76};
#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().