iPXE
Functions | Variables
cachedhcp.h File Reference

Cached DHCP packet. More...

#include <stddef.h>
#include <ipxe/uaccess.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, userptr_t 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,
userptr_t  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 200 of file cachedhcp.c.

201  {
202  struct dhcp_packet *dhcppkt;
203  struct dhcp_packet *tmp;
204  struct dhcphdr *dhcphdr;
205  unsigned int i;
206  size_t len;
207 
208  /* Free any existing cached packet */
209  cachedhcp_free ( cache );
210 
211  /* Allocate and populate DHCP packet */
212  dhcppkt = zalloc ( sizeof ( *dhcppkt ) + max_len );
213  if ( ! dhcppkt ) {
214  DBGC ( colour, "CACHEDHCP %s could not allocate copy\n",
215  cache->name );
216  return -ENOMEM;
217  }
218  dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
220  dhcppkt_init ( dhcppkt, dhcphdr, max_len );
221 
222  /* Shrink packet to required length. If reallocation fails,
223  * just continue to use the original packet and waste the
224  * unused space.
225  */
226  len = dhcppkt_len ( dhcppkt );
227  assert ( len <= max_len );
228  tmp = realloc ( dhcppkt, ( sizeof ( *dhcppkt ) + len ) );
229  if ( tmp )
230  dhcppkt = tmp;
231 
232  /* Reinitialise packet at new address */
233  dhcphdr = ( ( ( void * ) dhcppkt ) + sizeof ( *dhcppkt ) );
234  dhcppkt_init ( dhcppkt, dhcphdr, len );
235 
236  /* Discard duplicate packets, since some PXE stacks (including
237  * iPXE itself) will report the DHCPACK packet as the PXEBSACK
238  * if no separate PXEBSACK exists.
239  */
240  for ( i = 0 ; i < ( sizeof ( cached_packets ) /
241  sizeof ( cached_packets[0] ) ) ; i++ ) {
242  tmp = cached_packets[i]->dhcppkt;
243  if ( tmp && ( dhcppkt_len ( tmp ) == len ) &&
244  ( memcmp ( tmp->dhcphdr, dhcppkt->dhcphdr, len ) == 0 ) ) {
245  DBGC ( colour, "CACHEDHCP %s duplicates %s\n",
246  cache->name, cached_packets[i]->name );
247  dhcppkt_put ( dhcppkt );
248  return -EEXIST;
249  }
250  }
251 
252  /* Store as cached packet */
253  DBGC ( colour, "CACHEDHCP %s at %#08lx+%#zx/%#zx\n", cache->name,
254  user_to_phys ( data, 0 ), len, max_len );
255  cache->dhcppkt = dhcppkt;
256  cache->vlan = vlan;
257 
258  return 0;
259 }
#define colour
Colour for debug messages.
Definition: cachedhcp.c:83
A DHCP packet.
Definition: dhcppkt.h:20
unsigned int vlan
VLAN tag (if applicable)
Definition: cachedhcp.c:48
#define EEXIST
File exists.
Definition: errno.h:388
uint16_t max_len
Maximum length (in bytes)
Definition: ntlm.h:18
static __always_inline void copy_from_user(void *dest, userptr_t src, off_t src_off, size_t len)
Copy data from user buffer.
Definition: uaccess.h:337
unsigned long user_to_phys(userptr_t userptr, off_t offset)
Convert user pointer to physical address.
#define DBGC(...)
Definition: compiler.h:505
static struct cached_dhcp_packet * cached_packets[]
List of cached DHCP packets.
Definition: cachedhcp.c:76
struct dhcp_packet * dhcppkt
DHCP packet (if any)
Definition: cachedhcp.c:46
static void cachedhcp_free(struct cached_dhcp_packet *cache)
Free cached DHCP packet.
Definition: cachedhcp.c:90
unsigned long tmp
Definition: linux_pci.h:53
#define ENOMEM
Not enough space.
Definition: errno.h:534
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
void * zalloc(size_t size)
Allocate cleared memory.
Definition: malloc.c:624
A DHCP header.
Definition: dhcp.h:613
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
uint32_t len
Length.
Definition: ena.h:14
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:44
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:521
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, copy_from_user(), data, DBGC, dhcp_packet::dhcphdr, cached_dhcp_packet::dhcppkt, dhcppkt_init(), dhcppkt_len(), dhcppkt_put(), EEXIST, ENOMEM, len, max_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_recycle()

void cachedhcp_recycle ( struct net_device netdev)

Recycle cached DHCPACK.

Parameters
netdevNetwork device
privPrivate data

Definition at line 352 of file cachedhcp.c.

352  {
353  struct cached_dhcp_packet *cache = &cached_dhcpack;
354  struct settings *settings;
355 
356  /* Return DHCPACK to cache, if applicable */
358  cache->name );
359  if ( cache->dhcppkt && ( settings == &cache->dhcppkt->settings ) ) {
360  DBGC ( colour, "CACHEDHCP %s recycled from %s\n",
361  cache->name, netdev->name );
362  assert ( cache->flags & CACHEDHCP_USED );
364  cache->flags &= ~CACHEDHCP_USED;
365  }
366 }
#define colour
Colour for debug messages.
Definition: cachedhcp.c:83
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:583
struct dhcp_packet * dhcppkt
DHCP packet (if any)
Definition: cachedhcp.c:46
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:42
A settings block.
Definition: settings.h:132
struct cached_dhcp_packet cached_dhcpack
Cached DHCPACK.
Definition: cachedhcp.c:60
unsigned int flags
Flags.
Definition: cachedhcp.c:50
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:44
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:57

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

Referenced by cachedhcp_startup_early(), and efi_cachedhcp_record().