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

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

358 {
359 struct cached_dhcp_packet *cache = &cached_dhcpack;
360 struct settings *settings;
361
362 /* Return DHCPACK to cache, if applicable */
364 cache->name );
365 if ( cache->dhcppkt && ( settings == &cache->dhcppkt->settings ) ) {
366 DBGC ( colour, "CACHEDHCP %s recycled from %s\n",
367 cache->name, netdev->name );
368 assert ( cache->flags & CACHEDHCP_USED );
370 cache->flags &= ~CACHEDHCP_USED;
371 }
372}
#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: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: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().