iPXE
Functions | Variables
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)
 
int cachedhcp_record (struct cached_dhcp_packet *cache, unsigned int vlan, const void *data, size_t max_len)
 Record cached DHCP packet. 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...
 

Detailed Description

Cached DHCP packet.

Definition in file cachedhcp.h.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL  )

◆ cachedhcp_record()

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

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

203  {
204  struct dhcp_packet *dhcppkt;
205  struct dhcp_packet *tmp;
206  struct dhcphdr *dhcphdr;
207  unsigned int i;
208  size_t len;
209 
210  /* Free any existing cached packet */
211  cachedhcp_free ( cache );
212 
213  /* Allocate and populate DHCP packet */
214  dhcppkt = zalloc ( sizeof ( *dhcppkt ) + max_len );
215  if ( ! dhcppkt ) {
216  DBGC ( colour, "CACHEDHCP %s could not allocate copy\n",
217  cache->name );
218  return -ENOMEM;
219  }
220  dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
221  memcpy ( dhcphdr, data, max_len );
222  dhcppkt_init ( dhcppkt, dhcphdr, max_len );
223 
224  /* Shrink packet to required length. If reallocation fails,
225  * just continue to use the original packet and waste the
226  * unused space.
227  */
228  len = dhcppkt_len ( dhcppkt );
229  assert ( len <= max_len );
230  tmp = realloc ( dhcppkt, ( sizeof ( *dhcppkt ) + len ) );
231  if ( tmp )
232  dhcppkt = tmp;
233 
234  /* Reinitialise packet at new address */
235  dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
236  dhcppkt_init ( dhcppkt, dhcphdr, len );
237 
238  /* Discard duplicate packets, since some PXE stacks (including
239  * iPXE itself) will report the DHCPACK packet as the PXEBSACK
240  * if no separate PXEBSACK exists.
241  */
242  for ( i = 0 ; i < ( sizeof ( cached_packets ) /
243  sizeof ( cached_packets[0] ) ) ; i++ ) {
244  tmp = cached_packets[i]->dhcppkt;
245  if ( tmp && ( dhcppkt_len ( tmp ) == len ) &&
246  ( memcmp ( tmp->dhcphdr, dhcppkt->dhcphdr, len ) == 0 ) ) {
247  DBGC ( colour, "CACHEDHCP %s duplicates %s\n",
248  cache->name, cached_packets[i]->name );
249  dhcppkt_put ( dhcppkt );
250  return -EEXIST;
251  }
252  }
253 
254  /* Store as cached packet */
255  DBGC ( colour, "CACHEDHCP %s at %#08lx+%#zx/%#zx\n", cache->name,
256  virt_to_phys ( data ), len, max_len );
257  cache->dhcppkt = dhcppkt;
258  cache->vlan = vlan;
259 
260  return 0;
261 }
#define colour
Colour for debug messages.
Definition: cachedhcp.c:85
A DHCP packet.
Definition: dhcppkt.h:20
unsigned int vlan
VLAN tag (if applicable)
Definition: cachedhcp.c:50
#define EEXIST
File exists.
Definition: errno.h:388
#define DBGC(...)
Definition: compiler.h:505
static struct cached_dhcp_packet * cached_packets[]
List of cached DHCP packets.
Definition: cachedhcp.c:78
struct dhcp_packet * dhcppkt
DHCP packet (if any)
Definition: cachedhcp.c:48
static void cachedhcp_free(struct cached_dhcp_packet *cache)
Free cached DHCP packet.
Definition: cachedhcp.c:92
unsigned long tmp
Definition: linux_pci.h:64
#define ENOMEM
Not enough space.
Definition: errno.h:534
void * memcpy(void *dest, const void *src, size_t len) __nonnull
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
ring len
Length.
Definition: dwmac.h:231
void * zalloc(size_t size)
Allocate cleared memory.
Definition: malloc.c:661
A DHCP header.
Definition: dhcp.h:615
void dhcppkt_init(struct dhcp_packet *dhcppkt, struct dhcphdr *data, size_t len)
Initialise DHCP packet.
Definition: dhcppkt.c:300
struct dhcphdr * dhcphdr
The DHCP packet contents.
Definition: dhcppkt.h:24
static void dhcppkt_put(struct dhcp_packet *dhcppkt)
Decrement reference count on DHCP packet.
Definition: dhcppkt.h:49
static size_t dhcppkt_len(struct dhcp_packet *dhcppkt)
Get used length of DHCP packet.
Definition: dhcppkt.h:59
const char * name
Settings block name.
Definition: cachedhcp.c:46
uint8_t data[48]
Additional event data.
Definition: ena.h:22
void * realloc(void *old_ptr, size_t new_size)
Reallocate memory.
Definition: malloc.c:606
int memcmp(const void *first, const void *second, size_t len)
Compare memory regions.
Definition: string.c:114

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)

Recycle cached DHCPACK.

Parameters
netdevNetwork device
privPrivate data

Definition at line 354 of file cachedhcp.c.

354  {
355  struct cached_dhcp_packet *cache = &cached_dhcpack;
356  struct settings *settings;
357 
358  /* Return DHCPACK to cache, if applicable */
360  cache->name );
361  if ( cache->dhcppkt && ( settings == &cache->dhcppkt->settings ) ) {
362  DBGC ( colour, "CACHEDHCP %s recycled from %s\n",
363  cache->name, netdev->name );
364  assert ( cache->flags & CACHEDHCP_USED );
366  cache->flags &= ~CACHEDHCP_USED;
367  }
368 }
#define colour
Colour for debug messages.
Definition: cachedhcp.c:85
void unregister_settings(struct settings *settings)
Unregister settings block.
Definition: settings.c:514
#define DBGC(...)
Definition: compiler.h:505
static struct settings * netdev_settings(struct net_device *netdev)
Get per-netdevice configuration settings block.
Definition: netdevice.h:586
struct dhcp_packet * dhcppkt
DHCP packet (if any)
Definition: cachedhcp.c:48
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
static struct net_device * netdev
Definition: gdbudp.c:52
A cached DHCP packet.
Definition: cachedhcp.c:44
A settings block.
Definition: settings.h:132
struct cached_dhcp_packet cached_dhcpack
Cached DHCPACK.
Definition: cachedhcp.c:62
unsigned int flags
Flags.
Definition: cachedhcp.c:52
struct settings settings
Settings interface.
Definition: dhcppkt.h:28
char name[NETDEV_NAME_LEN]
Name of this network device.
Definition: netdevice.h:362
const char * name
Settings block name.
Definition: cachedhcp.c:46
struct settings * find_child_settings(struct settings *parent, const char *name)
Find child settings block.
Definition: settings.c:279
#define CACHEDHCP_USED
Cached DHCP packet has been used.
Definition: cachedhcp.c:59

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

◆ cached_proxydhcp

struct cached_dhcp_packet cached_proxydhcp

Cached ProxyDHCPOFFER.

Definition at line 68 of file cachedhcp.c.

Referenced by cachedhcp_startup_early(), and efi_cachedhcp_record().

◆ cached_pxebs

struct cached_dhcp_packet cached_pxebs

Cached PXEBSACK.

Definition at line 73 of file cachedhcp.c.

Referenced by cachedhcp_startup_early(), and efi_cachedhcp_record().