iPXE
Functions | Variables
pxe_undi.c File Reference

PXE UNDI API. More...

#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include <byteswap.h>
#include <basemem_packet.h>
#include <ipxe/netdevice.h>
#include <ipxe/iobuf.h>
#include <ipxe/device.h>
#include <ipxe/pci.h>
#include <ipxe/if_ether.h>
#include <ipxe/ip.h>
#include <ipxe/arp.h>
#include <ipxe/rarp.h>
#include <ipxe/profile.h>
#include "pxe.h"

Go to the source code of this file.

Functions

 FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
 
void pxe_set_netdev (struct net_device *netdev)
 Set network device as current PXE network device. More...
 
static int pxe_netdev_open (void)
 Open PXE network device. More...
 
static void pxe_netdev_close (void)
 Close PXE network device. More...
 
static void pxe_dump_mcast_list (struct s_PXENV_UNDI_MCAST_ADDRESS *mcast)
 Dump multicast address list. More...
 
static PXENV_EXIT_t pxenv_undi_startup (struct s_PXENV_UNDI_STARTUP *undi_startup)
 
static PXENV_EXIT_t pxenv_undi_cleanup (struct s_PXENV_UNDI_CLEANUP *undi_cleanup)
 
static PXENV_EXIT_t pxenv_undi_initialize (struct s_PXENV_UNDI_INITIALIZE *undi_initialize)
 
static PXENV_EXIT_t pxenv_undi_reset_adapter (struct s_PXENV_UNDI_RESET *undi_reset_adapter)
 
static PXENV_EXIT_t pxenv_undi_shutdown (struct s_PXENV_UNDI_SHUTDOWN *undi_shutdown)
 
static PXENV_EXIT_t pxenv_undi_open (struct s_PXENV_UNDI_OPEN *undi_open)
 
static PXENV_EXIT_t pxenv_undi_close (struct s_PXENV_UNDI_CLOSE *undi_close)
 
static PXENV_EXIT_t pxenv_undi_transmit (struct s_PXENV_UNDI_TRANSMIT *undi_transmit)
 
static PXENV_EXIT_t pxenv_undi_set_mcast_address (struct s_PXENV_UNDI_SET_MCAST_ADDRESS *undi_set_mcast_address)
 
static PXENV_EXIT_t pxenv_undi_set_station_address (struct s_PXENV_UNDI_SET_STATION_ADDRESS *undi_set_station_address)
 
static PXENV_EXIT_t pxenv_undi_set_packet_filter (struct s_PXENV_UNDI_SET_PACKET_FILTER *undi_set_packet_filter)
 
static PXENV_EXIT_t pxenv_undi_get_information (struct s_PXENV_UNDI_GET_INFORMATION *undi_get_information)
 
static PXENV_EXIT_t pxenv_undi_get_statistics (struct s_PXENV_UNDI_GET_STATISTICS *undi_get_statistics)
 
static PXENV_EXIT_t pxenv_undi_clear_statistics (struct s_PXENV_UNDI_CLEAR_STATISTICS *undi_clear_statistics)
 
static PXENV_EXIT_t pxenv_undi_initiate_diags (struct s_PXENV_UNDI_INITIATE_DIAGS *undi_initiate_diags)
 
static PXENV_EXIT_t pxenv_undi_force_interrupt (struct s_PXENV_UNDI_FORCE_INTERRUPT *undi_force_interrupt)
 
static PXENV_EXIT_t pxenv_undi_get_mcast_address (struct s_PXENV_UNDI_GET_MCAST_ADDRESS *undi_get_mcast_address)
 
static PXENV_EXIT_t pxenv_undi_get_nic_type (struct s_PXENV_UNDI_GET_NIC_TYPE *undi_get_nic_type)
 
static PXENV_EXIT_t pxenv_undi_get_iface_info (struct s_PXENV_UNDI_GET_IFACE_INFO *undi_get_iface_info)
 
static PXENV_EXIT_t pxenv_undi_isr (struct s_PXENV_UNDI_ISR *undi_isr)
 

Variables

static int undi_tx_count = 0
 Count of outstanding transmitted packets. More...
 
struct net_devicepxe_netdev = NULL
 
static struct profiler undi_tx_profiler __profiler = { .name = "undi.tx" }
 Transmit profiler. More...
 
struct pxe_api_call pxe_undi_api [] __pxe_api_call
 PXE UNDI API. More...
 

Detailed Description

PXE UNDI API.

Definition in file pxe_undi.c.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL  )

◆ pxe_set_netdev()

void pxe_set_netdev ( struct net_device netdev)

Set network device as current PXE network device.

Parameters
netdevNetwork device, or NULL

Definition at line 69 of file pxe_undi.c.

69  {
70 
71  if ( pxe_netdev ) {
74  }
75 
76  pxe_netdev = NULL;
77 
78  if ( netdev )
80 }
static void netdev_put(struct net_device *netdev)
Drop reference to network device.
Definition: netdevice.h:555
static struct net_device * netdev
Definition: gdbudp.c:52
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
static struct net_device * netdev_get(struct net_device *netdev)
Get reference to network device.
Definition: netdevice.h:544
void netdev_rx_unfreeze(struct net_device *netdev)
Unfreeze network device receive queue processing.
Definition: netdevice.c:148
#define NULL
NULL pointer (VOID *)
Definition: Base.h:362

References netdev, netdev_get(), netdev_put(), netdev_rx_unfreeze(), NULL, and pxe_netdev.

Referenced by pxe_activate(), and pxe_deactivate().

◆ pxe_netdev_open()

static int pxe_netdev_open ( void  )
static

Open PXE network device.

Return values
rcReturn status code

Definition at line 87 of file pxe_undi.c.

87  {
88  int rc;
89 
90  assert ( pxe_netdev != NULL );
91 
92  if ( ( rc = netdev_open ( pxe_netdev ) ) != 0 )
93  return rc;
94 
96  netdev_irq ( pxe_netdev, 1 );
97 
98  return 0;
99 }
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
void netdev_irq(struct net_device *netdev, int enable)
Enable or disable interrupts.
Definition: netdevice.c:875
void netdev_rx_freeze(struct net_device *netdev)
Freeze network device receive queue processing.
Definition: netdevice.c:134
#define NULL
NULL pointer (VOID *)
Definition: Base.h:362
int netdev_open(struct net_device *netdev)
Open network device.
Definition: netdevice.c:767

References assert(), netdev_irq(), netdev_open(), netdev_rx_freeze(), NULL, pxe_netdev, and rc.

Referenced by pxenv_undi_open(), and pxenv_undi_reset_adapter().

◆ pxe_netdev_close()

static void pxe_netdev_close ( void  )
static

Close PXE network device.

Definition at line 105 of file pxe_undi.c.

105  {
106 
107  assert ( pxe_netdev != NULL );
109  netdev_irq ( pxe_netdev, 0 );
111  undi_tx_count = 0;
112 }
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
void netdev_irq(struct net_device *netdev, int enable)
Enable or disable interrupts.
Definition: netdevice.c:875
void netdev_close(struct net_device *netdev)
Close network device.
Definition: netdevice.c:801
void netdev_rx_unfreeze(struct net_device *netdev)
Unfreeze network device receive queue processing.
Definition: netdevice.c:148
static int undi_tx_count
Count of outstanding transmitted packets.
Definition: pxe_undi.c:57
#define NULL
NULL pointer (VOID *)
Definition: Base.h:362

References assert(), netdev_close(), netdev_irq(), netdev_rx_unfreeze(), NULL, pxe_netdev, and undi_tx_count.

Referenced by pxenv_undi_cleanup(), pxenv_undi_close(), pxenv_undi_reset_adapter(), and pxenv_undi_shutdown().

◆ pxe_dump_mcast_list()

static void pxe_dump_mcast_list ( struct s_PXENV_UNDI_MCAST_ADDRESS mcast)
static

Dump multicast address list.

Parameters
mcastPXE multicast address list

Definition at line 119 of file pxe_undi.c.

119  {
121  unsigned int i;
122 
123  for ( i = 0 ; i < mcast->MCastAddrCount ; i++ ) {
124  DBGC ( &pxe_netdev, " %s",
125  ll_protocol->ntoa ( mcast->McastAddr[i] ) );
126  }
127 }
#define DBGC(...)
Definition: compiler.h:505
A link-layer protocol.
Definition: netdevice.h:114
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
MAC_ADDR_t McastAddr[MAXNUM_MCADDR]
List of up to MAXNUM_MCADDR multicast MAC addresses.
Definition: pxe_api.h:898
const char *(* ntoa)(const void *ll_addr)
Transcribe link-layer address.
Definition: netdevice.h:163
struct ll_protocol * ll_protocol
Link-layer protocol.
Definition: netdevice.h:366
UINT16_t MCastAddrCount
Number of multicast MAC addresses.
Definition: pxe_api.h:896

References DBGC, net_device::ll_protocol, s_PXENV_UNDI_MCAST_ADDRESS::McastAddr, s_PXENV_UNDI_MCAST_ADDRESS::MCastAddrCount, ll_protocol::ntoa, and pxe_netdev.

Referenced by pxenv_undi_open(), pxenv_undi_reset_adapter(), and pxenv_undi_set_mcast_address().

◆ pxenv_undi_startup()

static PXENV_EXIT_t pxenv_undi_startup ( struct s_PXENV_UNDI_STARTUP undi_startup)
static

Definition at line 134 of file pxe_undi.c.

134  {
135  DBGC ( &pxe_netdev, "PXENV_UNDI_STARTUP\n" );
136 
137  /* Sanity check */
138  if ( ! pxe_netdev ) {
139  DBGC ( &pxe_netdev, "PXENV_UNDI_STARTUP called with no "
140  "network device\n" );
141  undi_startup->Status = PXENV_STATUS_UNDI_INVALID_STATE;
142  return PXENV_EXIT_FAILURE;
143  }
144 
145  undi_startup->Status = PXENV_STATUS_SUCCESS;
146  return PXENV_EXIT_SUCCESS;
147 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define DBGC(...)
Definition: compiler.h:505
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:826
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, and s_PXENV_UNDI_STARTUP::Status.

◆ pxenv_undi_cleanup()

static PXENV_EXIT_t pxenv_undi_cleanup ( struct s_PXENV_UNDI_CLEANUP undi_cleanup)
static

Definition at line 154 of file pxe_undi.c.

154  {
155  DBGC ( &pxe_netdev, "PXENV_UNDI_CLEANUP\n" );
156 
157  /* Sanity check */
158  if ( ! pxe_netdev ) {
159  DBGC ( &pxe_netdev, "PXENV_UNDI_CLEANUP called with no "
160  "network device\n" );
161  undi_cleanup->Status = PXENV_STATUS_UNDI_INVALID_STATE;
162  return PXENV_EXIT_FAILURE;
163  }
164 
165  /* Close network device */
167 
168  undi_cleanup->Status = PXENV_STATUS_SUCCESS;
169  return PXENV_EXIT_SUCCESS;
170 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:845
#define DBGC(...)
Definition: compiler.h:505
static void pxe_netdev_close(void)
Close PXE network device.
Definition: pxe_undi.c:105
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, pxe_netdev, pxe_netdev_close(), PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, and s_PXENV_UNDI_CLEANUP::Status.

◆ pxenv_undi_initialize()

static PXENV_EXIT_t pxenv_undi_initialize ( struct s_PXENV_UNDI_INITIALIZE undi_initialize)
static

Definition at line 177 of file pxe_undi.c.

177  {
178  DBGC ( &pxe_netdev, "PXENV_UNDI_INITIALIZE protocolini %08x\n",
179  undi_initialize->ProtocolIni );
180 
181  /* Sanity check */
182  if ( ! pxe_netdev ) {
183  DBGC ( &pxe_netdev, "PXENV_UNDI_INITIALIZE called with no "
184  "network device\n" );
185  undi_initialize->Status = PXENV_STATUS_UNDI_INVALID_STATE;
186  return PXENV_EXIT_FAILURE;
187  }
188 
189  undi_initialize->Status = PXENV_STATUS_SUCCESS;
190  return PXENV_EXIT_SUCCESS;
191 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define DBGC(...)
Definition: compiler.h:505
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
ADDR32_t ProtocolIni
NDIS 2.0 configuration information, or NULL.
Definition: pxe_api.h:872
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:864
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, s_PXENV_UNDI_INITIALIZE::ProtocolIni, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, and s_PXENV_UNDI_INITIALIZE::Status.

◆ pxenv_undi_reset_adapter()

static PXENV_EXIT_t pxenv_undi_reset_adapter ( struct s_PXENV_UNDI_RESET undi_reset_adapter)
static

Definition at line 198 of file pxe_undi.c.

198  {
199  int rc;
200 
201  DBGC ( &pxe_netdev, "PXENV_UNDI_RESET_ADAPTER" );
202  pxe_dump_mcast_list ( &undi_reset_adapter->R_Mcast_Buf );
203  DBGC ( &pxe_netdev, "\n" );
204 
205  /* Sanity check */
206  if ( ! pxe_netdev ) {
207  DBGC ( &pxe_netdev, "PXENV_UNDI_RESET_ADAPTER called with no "
208  "network device\n" );
209  undi_reset_adapter->Status = PXENV_STATUS_UNDI_INVALID_STATE;
210  return PXENV_EXIT_FAILURE;
211  }
212 
213  /* Close and reopen network device */
215  if ( ( rc = pxe_netdev_open() ) != 0 ) {
216  DBGC ( &pxe_netdev, "PXENV_UNDI_RESET_ADAPTER could not "
217  "reopen %s: %s\n", pxe_netdev->name, strerror ( rc ) );
218  undi_reset_adapter->Status = PXENV_STATUS ( rc );
219  return PXENV_EXIT_FAILURE;
220  }
221 
222  undi_reset_adapter->Status = PXENV_STATUS_SUCCESS;
223  return PXENV_EXIT_SUCCESS;
224 }
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
struct s_PXENV_UNDI_MCAST_ADDRESS R_Mcast_Buf
Multicast MAC addresses.
Definition: pxe_api.h:907
#define DBGC(...)
Definition: compiler.h:505
static void pxe_netdev_close(void)
Close PXE network device.
Definition: pxe_undi.c:105
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
static void pxe_dump_mcast_list(struct s_PXENV_UNDI_MCAST_ADDRESS *mcast)
Dump multicast address list.
Definition: pxe_undi.c:119
char name[NETDEV_NAME_LEN]
Name of this network device.
Definition: netdevice.h:358
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:905
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
static int pxe_netdev_open(void)
Open PXE network device.
Definition: pxe_undi.c:87
#define PXENV_STATUS(rc)
Derive PXENV_STATUS code from iPXE error number.
Definition: pxe_error.h:121
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, net_device::name, pxe_dump_mcast_list(), pxe_netdev, pxe_netdev_close(), pxe_netdev_open(), PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, s_PXENV_UNDI_RESET::R_Mcast_Buf, rc, s_PXENV_UNDI_RESET::Status, and strerror().

◆ pxenv_undi_shutdown()

static PXENV_EXIT_t pxenv_undi_shutdown ( struct s_PXENV_UNDI_SHUTDOWN undi_shutdown)
static

Definition at line 231 of file pxe_undi.c.

231  {
232  DBGC ( &pxe_netdev, "PXENV_UNDI_SHUTDOWN\n" );
233 
234  /* Sanity check */
235  if ( ! pxe_netdev ) {
236  DBGC ( &pxe_netdev, "PXENV_UNDI_SHUTDOWN called with no "
237  "network device\n" );
238  undi_shutdown->Status = PXENV_STATUS_UNDI_INVALID_STATE;
239  return PXENV_EXIT_FAILURE;
240  }
241 
242  /* Close network device */
244 
245  undi_shutdown->Status = PXENV_STATUS_SUCCESS;
246  return PXENV_EXIT_SUCCESS;
247 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:926
#define DBGC(...)
Definition: compiler.h:505
static void pxe_netdev_close(void)
Close PXE network device.
Definition: pxe_undi.c:105
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, pxe_netdev, pxe_netdev_close(), PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, and s_PXENV_UNDI_SHUTDOWN::Status.

◆ pxenv_undi_open()

static PXENV_EXIT_t pxenv_undi_open ( struct s_PXENV_UNDI_OPEN undi_open)
static

Definition at line 253 of file pxe_undi.c.

253  {
254  int rc;
255 
256  DBGC ( &pxe_netdev, "PXENV_UNDI_OPEN flag %04x filter %04x",
257  undi_open->OpenFlag, undi_open->PktFilter );
258  pxe_dump_mcast_list ( &undi_open->R_Mcast_Buf );
259  DBGC ( &pxe_netdev, "\n" );
260 
261  /* Sanity check */
262  if ( ! pxe_netdev ) {
263  DBGC ( &pxe_netdev, "PXENV_UNDI_OPEN called with no "
264  "network device\n" );
266  return PXENV_EXIT_FAILURE;
267  }
268 
269  /* Open network device */
270  if ( ( rc = pxe_netdev_open() ) != 0 ) {
271  DBGC ( &pxe_netdev, "PXENV_UNDI_OPEN could not open %s: %s\n",
272  pxe_netdev->name, strerror ( rc ) );
273  undi_open->Status = PXENV_STATUS ( rc );
274  return PXENV_EXIT_FAILURE;
275  }
276 
277  undi_open->Status = PXENV_STATUS_SUCCESS;
278  return PXENV_EXIT_SUCCESS;
279 }
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define DBGC(...)
Definition: compiler.h:505
UINT16_t PktFilter
Receive packet filter.
Definition: pxe_api.h:973
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:959
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
static void pxe_dump_mcast_list(struct s_PXENV_UNDI_MCAST_ADDRESS *mcast)
Dump multicast address list.
Definition: pxe_undi.c:119
char name[NETDEV_NAME_LEN]
Name of this network device.
Definition: netdevice.h:358
UINT16_t OpenFlag
Open flags as defined in NDIS 2.0.
Definition: pxe_api.h:966
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
static int pxe_netdev_open(void)
Open PXE network device.
Definition: pxe_undi.c:87
#define PXENV_STATUS(rc)
Derive PXENV_STATUS code from iPXE error number.
Definition: pxe_error.h:121
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81
struct s_PXENV_UNDI_MCAST_ADDRESS R_Mcast_Buf
Multicast MAC addresses.
Definition: pxe_api.h:975

References DBGC, net_device::name, s_PXENV_UNDI_OPEN::OpenFlag, s_PXENV_UNDI_OPEN::PktFilter, pxe_dump_mcast_list(), pxe_netdev, pxe_netdev_open(), PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, s_PXENV_UNDI_OPEN::R_Mcast_Buf, rc, s_PXENV_UNDI_OPEN::Status, and strerror().

◆ pxenv_undi_close()

static PXENV_EXIT_t pxenv_undi_close ( struct s_PXENV_UNDI_CLOSE undi_close)
static

Definition at line 285 of file pxe_undi.c.

285  {
286  DBGC ( &pxe_netdev, "PXENV_UNDI_CLOSE\n" );
287 
288  /* Sanity check */
289  if ( ! pxe_netdev ) {
290  DBGC ( &pxe_netdev, "PXENV_UNDI_CLOSE called with no "
291  "network device\n" );
293  return PXENV_EXIT_FAILURE;
294  }
295 
296  /* Close network device */
298 
299  undi_close->Status = PXENV_STATUS_SUCCESS;
300  return PXENV_EXIT_SUCCESS;
301 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define DBGC(...)
Definition: compiler.h:505
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:994
static void pxe_netdev_close(void)
Close PXE network device.
Definition: pxe_undi.c:105
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, pxe_netdev, pxe_netdev_close(), PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, and s_PXENV_UNDI_CLOSE::Status.

◆ pxenv_undi_transmit()

static PXENV_EXIT_t pxenv_undi_transmit ( struct s_PXENV_UNDI_TRANSMIT undi_transmit)
static

Definition at line 308 of file pxe_undi.c.

308  {
309  struct s_PXENV_UNDI_TBD tbd;
310  struct DataBlk *datablk;
311  struct io_buffer *iobuf;
312  struct net_protocol *net_protocol;
313  struct ll_protocol *ll_protocol;
314  char destaddr[MAX_LL_ADDR_LEN];
315  const void *ll_dest;
316  size_t len;
317  unsigned int i;
318  int rc;
319 
320  /* Start profiling */
321  profile_start ( &undi_tx_profiler );
322 
323  /* Sanity check */
324  if ( ! pxe_netdev ) {
325  DBGC ( &pxe_netdev, "PXENV_UNDI_TRANSMIT called with no "
326  "network device\n" );
327  undi_transmit->Status = PXENV_STATUS_UNDI_INVALID_STATE;
328  return PXENV_EXIT_FAILURE;
329  }
330 
331  DBGC2 ( &pxe_netdev, "PXENV_UNDI_TRANSMIT" );
332 
333  /* Forcibly enable interrupts and freeze receive queue
334  * processing at this point, to work around callers that never
335  * call PXENV_UNDI_OPEN before attempting to use the UNDI API.
336  */
337  if ( ! netdev_rx_frozen ( pxe_netdev ) ) {
339  netdev_irq ( pxe_netdev, 1 );
340  }
341 
342  /* Identify network-layer protocol */
343  switch ( undi_transmit->Protocol ) {
344  case P_IP: net_protocol = &ipv4_protocol; break;
345  case P_ARP: net_protocol = &arp_protocol; break;
346  case P_RARP: net_protocol = &rarp_protocol; break;
347  case P_UNKNOWN:
348  net_protocol = NULL;
349  break;
350  default:
351  DBGC2 ( &pxe_netdev, " %02x invalid protocol\n",
352  undi_transmit->Protocol );
354  return PXENV_EXIT_FAILURE;
355  }
356  DBGC2 ( &pxe_netdev, " %s",
357  ( net_protocol ? net_protocol->name : "RAW" ) );
358 
359  /* Calculate total packet length */
360  copy_from_real ( &tbd, undi_transmit->TBD.segment,
361  undi_transmit->TBD.offset, sizeof ( tbd ) );
362  len = tbd.ImmedLength;
363  DBGC2 ( &pxe_netdev, " %04x:%04x+%x", tbd.Xmit.segment, tbd.Xmit.offset,
364  tbd.ImmedLength );
365  for ( i = 0 ; i < tbd.DataBlkCount ; i++ ) {
366  datablk = &tbd.DataBlock[i];
367  len += datablk->TDDataLen;
368  DBGC2 ( &pxe_netdev, " %04x:%04x+%x",
369  datablk->TDDataPtr.segment, datablk->TDDataPtr.offset,
370  datablk->TDDataLen );
371  }
372 
373  /* Allocate and fill I/O buffer */
374  iobuf = alloc_iob ( MAX_LL_HEADER_LEN +
375  ( ( len > IOB_ZLEN ) ? len : IOB_ZLEN ) );
376  if ( ! iobuf ) {
377  DBGC2 ( &pxe_netdev, " could not allocate iobuf\n" );
378  undi_transmit->Status = PXENV_STATUS_OUT_OF_RESOURCES;
379  return PXENV_EXIT_FAILURE;
380  }
381  iob_reserve ( iobuf, MAX_LL_HEADER_LEN );
382  copy_from_real ( iob_put ( iobuf, tbd.ImmedLength ), tbd.Xmit.segment,
383  tbd.Xmit.offset, tbd.ImmedLength );
384  for ( i = 0 ; i < tbd.DataBlkCount ; i++ ) {
385  datablk = &tbd.DataBlock[i];
386  copy_from_real ( iob_put ( iobuf, datablk->TDDataLen ),
387  datablk->TDDataPtr.segment,
388  datablk->TDDataPtr.offset,
389  datablk->TDDataLen );
390  }
391 
392  /* Add link-layer header, if required to do so */
393  if ( net_protocol != NULL ) {
394 
395  /* Calculate destination address */
397  if ( undi_transmit->XmitFlag == XMT_DESTADDR ) {
398  copy_from_real ( destaddr,
399  undi_transmit->DestAddr.segment,
400  undi_transmit->DestAddr.offset,
402  ll_dest = destaddr;
403  DBGC2 ( &pxe_netdev, " DEST %s",
404  ll_protocol->ntoa ( ll_dest ) );
405  } else {
406  ll_dest = pxe_netdev->ll_broadcast;
407  DBGC2 ( &pxe_netdev, " BCAST" );
408  }
409 
410  /* Add link-layer header */
411  if ( ( rc = ll_protocol->push ( pxe_netdev, iobuf, ll_dest,
413  net_protocol->net_proto ))!=0){
414  DBGC2 ( &pxe_netdev, " could not add link-layer "
415  "header: %s\n", strerror ( rc ) );
416  free_iob ( iobuf );
417  undi_transmit->Status = PXENV_STATUS ( rc );
418  return PXENV_EXIT_FAILURE;
419  }
420  }
421 
422  /* Flag transmission as in-progress. Do this before starting
423  * to transmit the packet, because the ISR may trigger before
424  * we return from netdev_tx().
425  */
426  undi_tx_count++;
427 
428  /* Transmit packet */
429  DBGC2 ( &pxe_netdev, "\n" );
430  if ( ( rc = netdev_tx ( pxe_netdev, iobuf ) ) != 0 ) {
431  DBGC2 ( &pxe_netdev, "PXENV_UNDI_TRANSMIT could not transmit: "
432  "%s\n", strerror ( rc ) );
433  undi_tx_count--;
434  undi_transmit->Status = PXENV_STATUS ( rc );
435  return PXENV_EXIT_FAILURE;
436  }
437 
438  profile_stop ( &undi_tx_profiler );
439  undi_transmit->Status = PXENV_STATUS_SUCCESS;
440  return PXENV_EXIT_SUCCESS;
441 }
#define PXENV_STATUS_OUT_OF_RESOURCES
Definition: pxe_error.h:25
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
const char * name
Protocol name.
Definition: netdevice.h:66
UINT16_t TDDataLen
Length of this transmit buffer.
Definition: pxe_api.h:72
#define iob_put(iobuf, len)
Definition: iobuf.h:116
A transmit buffer descriptor, as pointed to by s_PXENV_UNDI_TRANSMIT::TBD.
Definition: pxe_api.h:1025
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
uint8_t ll_addr_len
Link-layer address length.
Definition: netdevice.h:198
#define P_IP
IP protocol.
Definition: pxe_api.h:1012
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1050
void free_iob(struct io_buffer *iobuf)
Free I/O buffer.
Definition: iobuf.c:145
#define DBGC(...)
Definition: compiler.h:505
#define PXENV_STATUS_UNDI_INVALID_PARAMETER
Definition: pxe_error.h:83
const uint8_t * ll_broadcast
Link-layer broadcast address.
Definition: netdevice.h:383
static void profile_stop(struct profiler *profiler)
Stop profiling.
Definition: profile.h:171
struct io_buffer * alloc_iob(size_t len)
Allocate I/O buffer.
Definition: iobuf.c:128
A link-layer protocol.
Definition: netdevice.h:114
int(* push)(struct net_device *netdev, struct io_buffer *iobuf, const void *ll_dest, const void *ll_source, uint16_t net_proto)
Add link-layer header.
Definition: netdevice.h:127
#define MAX_LL_ADDR_LEN
Maximum length of a link-layer address.
Definition: netdevice.h:36
SEGOFF16_t TDDataPtr
Address of this transmit buffer.
Definition: pxe_api.h:73
UINT8_t Protocol
Protocol.
Definition: pxe_api.h:1057
SEGOFF16_t DestAddr
Destination MAC address.
Definition: pxe_api.h:1063
UINT8_t XmitFlag
Unicast/broadcast flag.
Definition: pxe_api.h:1062
#define MAX_LL_HEADER_LEN
Maximum length of a link-layer header.
Definition: netdevice.h:45
static void profile_start(struct profiler *profiler)
Start profiling.
Definition: profile.h:158
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
void netdev_irq(struct net_device *netdev, int enable)
Enable or disable interrupts.
Definition: netdevice.c:875
int netdev_tx(struct net_device *netdev, struct io_buffer *iobuf)
Transmit raw packet via network device.
Definition: netdevice.c:290
#define XMT_DESTADDR
Unicast packet.
Definition: pxe_api.h:1017
uint16_t net_proto
Network-layer protocol.
Definition: netdevice.h:99
void netdev_rx_freeze(struct net_device *netdev)
Freeze network device receive queue processing.
Definition: netdevice.c:134
A network-layer protocol.
Definition: netdevice.h:64
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
#define copy_from_real
Definition: libkir.h:79
#define iob_reserve(iobuf, len)
Definition: iobuf.h:63
uint32_t len
Length.
Definition: ena.h:14
#define DBGC2(...)
Definition: compiler.h:522
SEGOFF16_t TBD
Address of the Transmit Buffer Descriptor.
Definition: pxe_api.h:1068
#define IOB_ZLEN
Minimum I/O buffer length.
Definition: iobuf.h:23
Array of up to MAX_DATA_BLKS additional transmit buffers.
Definition: pxe_api.h:61
const char *(* ntoa)(const void *ll_addr)
Transcribe link-layer address.
Definition: netdevice.h:163
#define P_RARP
RARP protocol.
Definition: pxe_api.h:1014
uint8_t ll_addr[MAX_LL_ADDR_LEN]
Link-layer address.
Definition: netdevice.h:381
#define P_ARP
ARP protocol.
Definition: pxe_api.h:1013
static int undi_tx_count
Count of outstanding transmitted packets.
Definition: pxe_undi.c:57
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define P_UNKNOWN
Media header already filled in.
Definition: pxe_api.h:1011
static int netdev_rx_frozen(struct net_device *netdev)
Check whether or not network device receive queue processing is frozen.
Definition: netdevice.h:686
#define NULL
NULL pointer (VOID *)
Definition: Base.h:362
#define PXENV_STATUS(rc)
Derive PXENV_STATUS code from iPXE error number.
Definition: pxe_error.h:121
struct ll_protocol * ll_protocol
Link-layer protocol.
Definition: netdevice.h:366
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81
A persistent I/O buffer.
Definition: iobuf.h:32

References alloc_iob(), copy_from_real, s_PXENV_UNDI_TBD::DataBlkCount, s_PXENV_UNDI_TBD::DataBlock, DBGC, DBGC2, s_PXENV_UNDI_TRANSMIT::DestAddr, free_iob(), s_PXENV_UNDI_TBD::ImmedLength, iob_put, iob_reserve, IOB_ZLEN, len, net_device::ll_addr, ll_protocol::ll_addr_len, net_device::ll_broadcast, net_device::ll_protocol, MAX_LL_ADDR_LEN, MAX_LL_HEADER_LEN, net_protocol::name, net_protocol::net_proto, netdev_irq(), netdev_rx_freeze(), netdev_rx_frozen(), netdev_tx(), ll_protocol::ntoa, NULL, P_ARP, P_IP, P_RARP, P_UNKNOWN, profile_start(), profile_stop(), s_PXENV_UNDI_TRANSMIT::Protocol, ll_protocol::push, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS, PXENV_STATUS_OUT_OF_RESOURCES, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_PARAMETER, PXENV_STATUS_UNDI_INVALID_STATE, rc, s_PXENV_UNDI_TRANSMIT::Status, strerror(), s_PXENV_UNDI_TRANSMIT::TBD, DataBlk::TDDataLen, DataBlk::TDDataPtr, undi_tx_count, s_PXENV_UNDI_TBD::Xmit, s_PXENV_UNDI_TRANSMIT::XmitFlag, and XMT_DESTADDR.

◆ pxenv_undi_set_mcast_address()

static PXENV_EXIT_t pxenv_undi_set_mcast_address ( struct s_PXENV_UNDI_SET_MCAST_ADDRESS undi_set_mcast_address)
static

Definition at line 448 of file pxe_undi.c.

449  {
450  DBGC ( &pxe_netdev, "PXENV_UNDI_SET_MCAST_ADDRESS" );
451  pxe_dump_mcast_list ( &undi_set_mcast_address->R_Mcast_Buf );
452  DBGC ( &pxe_netdev, "\n" );
453 
454  /* Sanity check */
455  if ( ! pxe_netdev ) {
456  DBGC ( &pxe_netdev, "PXENV_UNDI_SET_MCAST_ADDRESS called with "
457  "no network device\n" );
458  undi_set_mcast_address->Status =
460  return PXENV_EXIT_FAILURE;
461  }
462 
463  undi_set_mcast_address->Status = PXENV_STATUS_SUCCESS;
464  return PXENV_EXIT_SUCCESS;
465 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1088
#define DBGC(...)
Definition: compiler.h:505
struct s_PXENV_UNDI_MCAST_ADDRESS R_Mcast_Buf
List of multicast addresses.
Definition: pxe_api.h:1090
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
static void pxe_dump_mcast_list(struct s_PXENV_UNDI_MCAST_ADDRESS *mcast)
Dump multicast address list.
Definition: pxe_undi.c:119
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, pxe_dump_mcast_list(), pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, s_PXENV_UNDI_SET_MCAST_ADDRESS::R_Mcast_Buf, and s_PXENV_UNDI_SET_MCAST_ADDRESS::Status.

◆ pxenv_undi_set_station_address()

static PXENV_EXIT_t pxenv_undi_set_station_address ( struct s_PXENV_UNDI_SET_STATION_ADDRESS undi_set_station_address)
static

Definition at line 472 of file pxe_undi.c.

473  {
474  struct ll_protocol *ll_protocol;
475 
476  /* Sanity check */
477  if ( ! pxe_netdev ) {
478  DBGC ( &pxe_netdev, "PXENV_UNDI_SET_STATION_ADDRESS called "
479  "with no network device\n" );
480  undi_set_station_address->Status =
482  return PXENV_EXIT_FAILURE;
483  }
484 
486  DBGC ( &pxe_netdev, "PXENV_UNDI_SET_STATION_ADDRESS %s",
487  ll_protocol->ntoa ( undi_set_station_address->StationAddress ) );
488 
489  /* If adapter is open, the change will have no effect; return
490  * an error
491  */
492  if ( netdev_is_open ( pxe_netdev ) ) {
493  DBGC ( &pxe_netdev, " failed: netdev is open\n" );
494  undi_set_station_address->Status =
496  return PXENV_EXIT_FAILURE;
497  }
498 
499  /* Update MAC address */
501  &undi_set_station_address->StationAddress,
503 
504  DBGC ( &pxe_netdev, "\n" );
505  undi_set_station_address->Status = PXENV_STATUS_SUCCESS;
506  return PXENV_EXIT_SUCCESS;
507 }
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1109
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
uint8_t ll_addr_len
Link-layer address length.
Definition: netdevice.h:198
#define DBGC(...)
Definition: compiler.h:505
A link-layer protocol.
Definition: netdevice.h:114
void * memcpy(void *dest, const void *src, size_t len) __nonnull
static int netdev_is_open(struct net_device *netdev)
Check whether or not network device is open.
Definition: netdevice.h:652
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
MAC_ADDR_t StationAddress
Station MAC address.
Definition: pxe_api.h:1110
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
const char *(* ntoa)(const void *ll_addr)
Transcribe link-layer address.
Definition: netdevice.h:163
uint8_t ll_addr[MAX_LL_ADDR_LEN]
Link-layer address.
Definition: netdevice.h:381
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
struct ll_protocol * ll_protocol
Link-layer protocol.
Definition: netdevice.h:366
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, net_device::ll_addr, ll_protocol::ll_addr_len, net_device::ll_protocol, memcpy(), netdev_is_open(), ll_protocol::ntoa, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, s_PXENV_UNDI_SET_STATION_ADDRESS::StationAddress, and s_PXENV_UNDI_SET_STATION_ADDRESS::Status.

◆ pxenv_undi_set_packet_filter()

static PXENV_EXIT_t pxenv_undi_set_packet_filter ( struct s_PXENV_UNDI_SET_PACKET_FILTER undi_set_packet_filter)
static

Definition at line 515 of file pxe_undi.c.

516  {
517 
518  DBGC ( &pxe_netdev, "PXENV_UNDI_SET_PACKET_FILTER %02x\n",
519  undi_set_packet_filter->filter );
520 
521  /* Sanity check */
522  if ( ! pxe_netdev ) {
523  DBGC ( &pxe_netdev, "PXENV_UNDI_SET_PACKET_FILTER called with "
524  "no network device\n" );
525  undi_set_packet_filter->Status =
527  return PXENV_EXIT_FAILURE;
528  }
529 
530  /* Pretend that we succeeded, otherwise the 3Com DOS UNDI
531  * driver refuses to load. (We ignore the filter value in the
532  * PXENV_UNDI_OPEN call anyway.)
533  */
534  undi_set_packet_filter->Status = PXENV_STATUS_SUCCESS;
535 
536  return PXENV_EXIT_SUCCESS;
537 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define DBGC(...)
Definition: compiler.h:505
UINT8_t filter
Receive packet filter.
Definition: pxe_api.h:1140
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1129
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, s_PXENV_UNDI_SET_PACKET_FILTER::filter, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, and s_PXENV_UNDI_SET_PACKET_FILTER::Status.

◆ pxenv_undi_get_information()

static PXENV_EXIT_t pxenv_undi_get_information ( struct s_PXENV_UNDI_GET_INFORMATION undi_get_information)
static

Definition at line 544 of file pxe_undi.c.

545  {
546  struct device *dev;
547  struct ll_protocol *ll_protocol;
548 
549  /* Sanity check */
550  if ( ! pxe_netdev ) {
551  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_INFORMATION called with no "
552  "network device\n" );
553  undi_get_information->Status = PXENV_STATUS_UNDI_INVALID_STATE;
554  return PXENV_EXIT_FAILURE;
555  }
556 
557  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_INFORMATION" );
558 
559  /* Fill in information */
560  dev = pxe_netdev->dev;
562  undi_get_information->BaseIo = dev->desc.ioaddr;
563  undi_get_information->IntNumber =
564  ( netdev_irq_supported ( pxe_netdev ) ? dev->desc.irq : 0 );
565  /* Cheat: assume all cards can cope with this */
566  undi_get_information->MaxTranUnit = ETH_MAX_MTU;
567  undi_get_information->HwType = ntohs ( ll_protocol->ll_proto );
568  undi_get_information->HwAddrLen = ll_protocol->ll_addr_len;
570  sizeof ( undi_get_information->CurrentNodeAddress ) );
571  memcpy ( &undi_get_information->CurrentNodeAddress,
573  sizeof ( undi_get_information->CurrentNodeAddress ) );
575  &undi_get_information->PermNodeAddress );
576  undi_get_information->ROMAddress = 0;
577  /* nic.rom_info->rom_segment; */
578  /* We only provide the ability to receive or transmit a single
579  * packet at a time. This is a bootloader, not an OS.
580  */
581  undi_get_information->RxBufCt = 1;
582  undi_get_information->TxBufCt = 1;
583 
584  DBGC ( &pxe_netdev, " io %04x irq %d mtu %d %s %s\n",
585  undi_get_information->BaseIo, undi_get_information->IntNumber,
586  undi_get_information->MaxTranUnit, ll_protocol->name,
587  ll_protocol->ntoa ( &undi_get_information->CurrentNodeAddress ));
588  undi_get_information->Status = PXENV_STATUS_SUCCESS;
589  return PXENV_EXIT_SUCCESS;
590 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
uint8_t ll_addr_len
Link-layer address length.
Definition: netdevice.h:198
UINT16_t IntNumber
IRQ number.
Definition: pxe_api.h:1169
UINT16_t RxBufCt
Receive queue length.
Definition: pxe_api.h:1182
UINT16_t BaseIo
I/O base address.
Definition: pxe_api.h:1168
unsigned long ioaddr
I/O address.
Definition: device.h:37
#define DBGC(...)
Definition: compiler.h:505
SEGSEL_t ROMAddress
Real-mode ROM segment address.
Definition: pxe_api.h:1181
#define ETH_MAX_MTU
Definition: if_ether.h:14
#define ntohs(value)
Definition: byteswap.h:136
void(* init_addr)(const void *hw_addr, void *ll_addr)
Initialise link-layer address.
Definition: netdevice.h:150
A link-layer protocol.
Definition: netdevice.h:114
const char * name
Protocol name.
Definition: netdevice.h:116
A hardware device.
Definition: device.h:73
void * memcpy(void *dest, const void *src, size_t len) __nonnull
MAC_ADDR_t PermNodeAddress
Permanent (EEPROM) MAC address.
Definition: pxe_api.h:1180
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
unsigned int irq
IRQ.
Definition: device.h:39
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1167
UINT16_t MaxTranUnit
Adapter MTU.
Definition: pxe_api.h:1170
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
uint16_t ll_proto
Link-layer protocol.
Definition: netdevice.h:194
UINT16_t HwAddrLen
MAC address length.
Definition: pxe_api.h:1178
struct device * dev
Underlying hardware device.
Definition: netdevice.h:360
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
MAC_ADDR_t CurrentNodeAddress
Current MAC address.
Definition: pxe_api.h:1179
UINT16_t TxBufCt
Transmit queue length.
Definition: pxe_api.h:1183
struct device_description desc
Device description.
Definition: device.h:79
const char *(* ntoa)(const void *ll_addr)
Transcribe link-layer address.
Definition: netdevice.h:163
UINT16_t HwType
Hardware type.
Definition: pxe_api.h:1177
uint8_t ll_addr[MAX_LL_ADDR_LEN]
Link-layer address.
Definition: netdevice.h:381
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
uint8_t hw_addr[MAX_HW_ADDR_LEN]
Hardware address.
Definition: netdevice.h:375
static int netdev_irq_supported(struct net_device *netdev)
Check whether or not network device supports interrupts.
Definition: netdevice.h:663
struct ll_protocol * ll_protocol
Link-layer protocol.
Definition: netdevice.h:366
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References assert(), s_PXENV_UNDI_GET_INFORMATION::BaseIo, s_PXENV_UNDI_GET_INFORMATION::CurrentNodeAddress, DBGC, device::desc, net_device::dev, ETH_MAX_MTU, net_device::hw_addr, s_PXENV_UNDI_GET_INFORMATION::HwAddrLen, s_PXENV_UNDI_GET_INFORMATION::HwType, ll_protocol::init_addr, s_PXENV_UNDI_GET_INFORMATION::IntNumber, device_description::ioaddr, device_description::irq, net_device::ll_addr, ll_protocol::ll_addr_len, ll_protocol::ll_proto, net_device::ll_protocol, s_PXENV_UNDI_GET_INFORMATION::MaxTranUnit, memcpy(), ll_protocol::name, netdev_irq_supported(), ll_protocol::ntoa, ntohs, s_PXENV_UNDI_GET_INFORMATION::PermNodeAddress, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, s_PXENV_UNDI_GET_INFORMATION::ROMAddress, s_PXENV_UNDI_GET_INFORMATION::RxBufCt, s_PXENV_UNDI_GET_INFORMATION::Status, and s_PXENV_UNDI_GET_INFORMATION::TxBufCt.

◆ pxenv_undi_get_statistics()

static PXENV_EXIT_t pxenv_undi_get_statistics ( struct s_PXENV_UNDI_GET_STATISTICS undi_get_statistics)
static

Definition at line 597 of file pxe_undi.c.

598  {
599 
600  /* Sanity check */
601  if ( ! pxe_netdev ) {
602  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_STATISTICS called with no "
603  "network device\n" );
604  undi_get_statistics->Status = PXENV_STATUS_UNDI_INVALID_STATE;
605  return PXENV_EXIT_FAILURE;
606  }
607 
608  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_STATISTICS" );
609 
610  /* Report statistics */
611  undi_get_statistics->XmtGoodFrames = pxe_netdev->tx_stats.good;
612  undi_get_statistics->RcvGoodFrames = pxe_netdev->rx_stats.good;
613  undi_get_statistics->RcvCRCErrors = pxe_netdev->rx_stats.bad;
614  undi_get_statistics->RcvResourceErrors = pxe_netdev->rx_stats.bad;
615  DBGC ( &pxe_netdev, " txok %d rxok %d rxcrc %d rxrsrc %d\n",
616  undi_get_statistics->XmtGoodFrames,
617  undi_get_statistics->RcvGoodFrames,
618  undi_get_statistics->RcvCRCErrors,
619  undi_get_statistics->RcvResourceErrors );
620 
621  undi_get_statistics->Status = PXENV_STATUS_SUCCESS;
622  return PXENV_EXIT_SUCCESS;
623 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
UINT32_t RcvGoodFrames
Successful reception count.
Definition: pxe_api.h:1204
#define DBGC(...)
Definition: compiler.h:505
UINT32_t RcvResourceErrors
Receive queue overflow count.
Definition: pxe_api.h:1206
UINT32_t RcvCRCErrors
Receive CRC error count.
Definition: pxe_api.h:1205
struct net_device_stats tx_stats
TX statistics.
Definition: netdevice.h:417
UINT32_t XmtGoodFrames
Successful transmission count.
Definition: pxe_api.h:1203
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
struct net_device_stats rx_stats
RX statistics.
Definition: netdevice.h:419
unsigned int bad
Count of error completions.
Definition: netdevice.h:291
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1202
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
unsigned int good
Count of successful completions.
Definition: netdevice.h:289
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References net_device_stats::bad, DBGC, net_device_stats::good, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, s_PXENV_UNDI_GET_STATISTICS::RcvCRCErrors, s_PXENV_UNDI_GET_STATISTICS::RcvGoodFrames, s_PXENV_UNDI_GET_STATISTICS::RcvResourceErrors, net_device::rx_stats, s_PXENV_UNDI_GET_STATISTICS::Status, net_device::tx_stats, and s_PXENV_UNDI_GET_STATISTICS::XmtGoodFrames.

◆ pxenv_undi_clear_statistics()

static PXENV_EXIT_t pxenv_undi_clear_statistics ( struct s_PXENV_UNDI_CLEAR_STATISTICS undi_clear_statistics)
static

Definition at line 630 of file pxe_undi.c.

631  {
632  DBGC ( &pxe_netdev, "PXENV_UNDI_CLEAR_STATISTICS\n" );
633 
634  /* Sanity check */
635  if ( ! pxe_netdev ) {
636  DBGC ( &pxe_netdev, "PXENV_UNDI_CLEAR_STATISTICS called with "
637  "no network device\n" );
638  undi_clear_statistics->Status = PXENV_STATUS_UNDI_INVALID_STATE;
639  return PXENV_EXIT_FAILURE;
640  }
641 
642  /* Clear statistics */
643  memset ( &pxe_netdev->tx_stats, 0, sizeof ( pxe_netdev->tx_stats ) );
644  memset ( &pxe_netdev->rx_stats, 0, sizeof ( pxe_netdev->rx_stats ) );
645 
646  undi_clear_statistics->Status = PXENV_STATUS_SUCCESS;
647  return PXENV_EXIT_SUCCESS;
648 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define DBGC(...)
Definition: compiler.h:505
struct net_device_stats tx_stats
TX statistics.
Definition: netdevice.h:417
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1225
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
struct net_device_stats rx_stats
RX statistics.
Definition: netdevice.h:419
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81
void * memset(void *dest, int character, size_t len) __nonnull

References DBGC, memset(), pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, net_device::rx_stats, s_PXENV_UNDI_CLEAR_STATISTICS::Status, and net_device::tx_stats.

◆ pxenv_undi_initiate_diags()

static PXENV_EXIT_t pxenv_undi_initiate_diags ( struct s_PXENV_UNDI_INITIATE_DIAGS undi_initiate_diags)
static

Definition at line 656 of file pxe_undi.c.

657  {
658  DBGC ( &pxe_netdev, "PXENV_UNDI_INITIATE_DIAGS failed: unsupported\n" );
659 
660  /* Sanity check */
661  if ( ! pxe_netdev ) {
662  DBGC ( &pxe_netdev, "PXENV_UNDI_INITIATE_DIAGS called with no "
663  "network device\n" );
664  undi_initiate_diags->Status = PXENV_STATUS_UNDI_INVALID_STATE;
665  return PXENV_EXIT_FAILURE;
666  }
667 
668  undi_initiate_diags->Status = PXENV_STATUS_UNSUPPORTED;
669  return PXENV_EXIT_FAILURE;
670 }
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define DBGC(...)
Definition: compiler.h:505
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1244
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PXENV_STATUS_UNSUPPORTED
Definition: pxe_error.h:22
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_STATUS_UNDI_INVALID_STATE, PXENV_STATUS_UNSUPPORTED, and s_PXENV_UNDI_INITIATE_DIAGS::Status.

◆ pxenv_undi_force_interrupt()

static PXENV_EXIT_t pxenv_undi_force_interrupt ( struct s_PXENV_UNDI_FORCE_INTERRUPT undi_force_interrupt)
static

Definition at line 678 of file pxe_undi.c.

679  {
680  DBGC ( &pxe_netdev,
681  "PXENV_UNDI_FORCE_INTERRUPT failed: unsupported\n" );
682 
683  /* Sanity check */
684  if ( ! pxe_netdev ) {
685  DBGC ( &pxe_netdev, "PXENV_UNDI_FORCE_INTERRUPT called with no "
686  "network device\n" );
687  undi_force_interrupt->Status = PXENV_STATUS_UNDI_INVALID_STATE;
688  return PXENV_EXIT_FAILURE;
689  }
690 
691  undi_force_interrupt->Status = PXENV_STATUS_UNSUPPORTED;
692  return PXENV_EXIT_FAILURE;
693 }
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1263
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define DBGC(...)
Definition: compiler.h:505
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PXENV_STATUS_UNSUPPORTED
Definition: pxe_error.h:22
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References DBGC, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_STATUS_UNDI_INVALID_STATE, PXENV_STATUS_UNSUPPORTED, and s_PXENV_UNDI_FORCE_INTERRUPT::Status.

◆ pxenv_undi_get_mcast_address()

static PXENV_EXIT_t pxenv_undi_get_mcast_address ( struct s_PXENV_UNDI_GET_MCAST_ADDRESS undi_get_mcast_address)
static

Definition at line 700 of file pxe_undi.c.

701  {
702  struct ll_protocol *ll_protocol;
703  struct in_addr ip = { .s_addr = undi_get_mcast_address->InetAddr };
704  int rc;
705 
706  /* Sanity check */
707  if ( ! pxe_netdev ) {
708  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_MCAST_ADDRESS called with "
709  "no network device\n" );
710  undi_get_mcast_address->Status =
712  return PXENV_EXIT_FAILURE;
713  }
714 
715  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_MCAST_ADDRESS %s",
716  inet_ntoa ( ip ) );
717 
718  /* Hash address using the network device's link-layer protocol */
720  if ( ( rc = ll_protocol->mc_hash ( AF_INET, &ip,
721  undi_get_mcast_address->MediaAddr ))!=0){
722  DBGC ( &pxe_netdev, " failed: %s\n", strerror ( rc ) );
723  undi_get_mcast_address->Status = PXENV_STATUS ( rc );
724  return PXENV_EXIT_FAILURE;
725  }
726  DBGC ( &pxe_netdev, "=>%s\n",
727  ll_protocol->ntoa ( undi_get_mcast_address->MediaAddr ) );
728 
729  undi_get_mcast_address->Status = PXENV_STATUS_SUCCESS;
730  return PXENV_EXIT_SUCCESS;
731 }
IP4_t InetAddr
Multicast IP address.
Definition: pxe_api.h:1283
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
MAC_ADDR_t MediaAddr
Multicast MAC address.
Definition: pxe_api.h:1284
#define DBGC(...)
Definition: compiler.h:505
A link-layer protocol.
Definition: netdevice.h:114
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1282
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
IP address structure.
Definition: in.h:39
char * inet_ntoa(struct in_addr in)
Convert IPv4 address to dotted-quad notation.
Definition: ipv4.c:658
IP4_t ip
Destination IP address.
Definition: pxe_api.h:58
int(* mc_hash)(unsigned int af, const void *net_addr, void *ll_addr)
Hash multicast address.
Definition: netdevice.h:172
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
const char *(* ntoa)(const void *ll_addr)
Transcribe link-layer address.
Definition: netdevice.h:163
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS(rc)
Derive PXENV_STATUS code from iPXE error number.
Definition: pxe_error.h:121
#define AF_INET
IPv4 Internet addresses.
Definition: socket.h:63
struct ll_protocol * ll_protocol
Link-layer protocol.
Definition: netdevice.h:366
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81

References AF_INET, DBGC, inet_ntoa(), s_PXENV_UNDI_GET_MCAST_ADDRESS::InetAddr, ip, net_device::ll_protocol, ll_protocol::mc_hash, s_PXENV_UNDI_GET_MCAST_ADDRESS::MediaAddr, ll_protocol::ntoa, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, rc, s_PXENV_UNDI_GET_MCAST_ADDRESS::Status, and strerror().

◆ pxenv_undi_get_nic_type()

static PXENV_EXIT_t pxenv_undi_get_nic_type ( struct s_PXENV_UNDI_GET_NIC_TYPE undi_get_nic_type)
static

Definition at line 737 of file pxe_undi.c.

738  {
739  struct device *dev;
740 
741  /* Sanity check */
742  if ( ! pxe_netdev ) {
743  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_NIC_TYPE called with "
744  "no network device\n" );
745  undi_get_nic_type->Status = PXENV_STATUS_UNDI_INVALID_STATE;
746  return PXENV_EXIT_FAILURE;
747  }
748 
749  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_NIC_TYPE" );
750 
751  /* Fill in information */
752  memset ( &undi_get_nic_type->info, 0,
753  sizeof ( undi_get_nic_type->info ) );
754  dev = pxe_netdev->dev;
755  switch ( dev->desc.bus_type ) {
756  case BUS_TYPE_PCI: {
757  struct pci_nic_info *info = &undi_get_nic_type->info.pci;
758 
759  undi_get_nic_type->NicType = PCI_NIC;
760  info->Vendor_ID = dev->desc.vendor;
761  info->Dev_ID = dev->desc.device;
762  info->Base_Class = PCI_BASE_CLASS ( dev->desc.class );
763  info->Sub_Class = PCI_SUB_CLASS ( dev->desc.class );
764  info->Prog_Intf = PCI_PROG_INTF ( dev->desc.class );
765  info->BusDevFunc = dev->desc.location;
766  /* Earlier versions of the PXE specification do not
767  * have the SubVendor_ID and SubDevice_ID fields. It
768  * is possible that some NBPs will not provide space
769  * for them, and so we must not fill them in.
770  */
771  DBGC ( &pxe_netdev, " PCI %02x:%02x.%x %04x:%04x "
772  "('%04x:%04x') %02x%02x%02x rev %02x\n",
773  PCI_BUS ( info->BusDevFunc ),
774  PCI_SLOT ( info->BusDevFunc ),
775  PCI_FUNC ( info->BusDevFunc ), info->Vendor_ID,
776  info->Dev_ID, info->SubVendor_ID, info->SubDevice_ID,
777  info->Base_Class, info->Sub_Class, info->Prog_Intf,
778  info->Rev );
779  break; }
780  case BUS_TYPE_ISAPNP: {
781  struct pnp_nic_info *info = &undi_get_nic_type->info.pnp;
782 
783  undi_get_nic_type->NicType = PnP_NIC;
784  info->EISA_Dev_ID = ( ( dev->desc.vendor << 16 ) |
785  dev->desc.device );
786  info->CardSelNum = dev->desc.location;
787  /* Cheat: remaining fields are probably unnecessary,
788  * and would require adding extra code to isapnp.c.
789  */
790  DBGC ( &pxe_netdev, " ISAPnP CSN %04x %08x %02x%02x%02x\n",
791  info->CardSelNum, info->EISA_Dev_ID,
792  info->Base_Class, info->Sub_Class, info->Prog_Intf );
793  break; }
794  default:
795  DBGC ( &pxe_netdev, " failed: unknown bus type\n" );
796  undi_get_nic_type->Status = PXENV_STATUS_FAILURE;
797  return PXENV_EXIT_FAILURE;
798  }
799 
800  undi_get_nic_type->Status = PXENV_STATUS_SUCCESS;
801  return PXENV_EXIT_SUCCESS;
802 }
#define PCI_FUNC(busdevfn)
Definition: pci.h:258
#define PCI_BUS(busdevfn)
Definition: pci.h:256
#define PCI_NIC
PCI network card.
Definition: pxe_api.h:1301
u32 info
Definition: ar9003_mac.h:67
struct pnp_nic_info pnp
NIC information (if NicType==PnP_NIC)
Definition: pxe_api.h:1343
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define DBGC(...)
Definition: compiler.h:505
unsigned long class
Device class.
Definition: device.h:35
union s_PXENV_UNDI_GET_NIC_TYPE::nic_type_info info
unsigned int vendor
Vendor ID.
Definition: device.h:31
struct pci_nic_info pci
NIC information (if NicType==PCI_NIC)
Definition: pxe_api.h:1339
#define PCI_BASE_CLASS(class)
Definition: pci.h:265
A hardware device.
Definition: device.h:73
#define PnP_NIC
ISAPnP network card.
Definition: pxe_api.h:1302
#define BUS_TYPE_PCI
PCI bus type.
Definition: device.h:43
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1330
Information for an ISAPnP or equivalent NIC.
Definition: pxe_api.h:1319
unsigned int location
Location.
Definition: device.h:29
UINT8_t NicType
NIC type.
Definition: pxe_api.h:1335
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define PCI_SLOT(busdevfn)
Definition: pci.h:257
struct device * dev
Underlying hardware device.
Definition: netdevice.h:360
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
unsigned int bus_type
Bus type.
Definition: device.h:24
#define PCI_PROG_INTF(class)
Definition: pci.h:267
unsigned int device
Device ID.
Definition: device.h:33
struct device_description desc
Device description.
Definition: device.h:79
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define PXENV_STATUS_FAILURE
Definition: pxe_error.h:20
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81
Information for a PCI or equivalent NIC.
Definition: pxe_api.h:1306
#define BUS_TYPE_ISAPNP
ISAPnP bus type.
Definition: device.h:46
void * memset(void *dest, int character, size_t len) __nonnull
#define PCI_SUB_CLASS(class)
Definition: pci.h:266

References device_description::bus_type, BUS_TYPE_ISAPNP, BUS_TYPE_PCI, device_description::class, DBGC, device::desc, net_device::dev, device_description::device, info, s_PXENV_UNDI_GET_NIC_TYPE::info, device_description::location, memset(), s_PXENV_UNDI_GET_NIC_TYPE::NicType, s_PXENV_UNDI_GET_NIC_TYPE::nic_type_info::pci, PCI_BASE_CLASS, PCI_BUS, PCI_FUNC, PCI_NIC, PCI_PROG_INTF, PCI_SLOT, PCI_SUB_CLASS, s_PXENV_UNDI_GET_NIC_TYPE::nic_type_info::pnp, PnP_NIC, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_FAILURE, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, s_PXENV_UNDI_GET_NIC_TYPE::Status, and device_description::vendor.

◆ pxenv_undi_get_iface_info()

static PXENV_EXIT_t pxenv_undi_get_iface_info ( struct s_PXENV_UNDI_GET_IFACE_INFO undi_get_iface_info)
static

Definition at line 809 of file pxe_undi.c.

810  {
811 
812  /* Sanity check */
813  if ( ! pxe_netdev ) {
814  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_IFACE_INFO called with "
815  "no network device\n" );
816  undi_get_iface_info->Status = PXENV_STATUS_UNDI_INVALID_STATE;
817  return PXENV_EXIT_FAILURE;
818  }
819 
820  DBGC ( &pxe_netdev, "PXENV_UNDI_GET_IFACE_INFO" );
821 
822  /* Just hand back some info, doesn't really matter what it is.
823  * Most PXE stacks seem to take this approach.
824  */
825  snprintf ( ( char * ) undi_get_iface_info->IfaceType,
826  sizeof ( undi_get_iface_info->IfaceType ), "DIX+802.3" );
827  undi_get_iface_info->LinkSpeed = 10000000; /* 10 Mbps */
828  undi_get_iface_info->ServiceFlags =
833  undi_get_iface_info->ServiceFlags |= SUPPORTED_IRQ;
834  memset ( undi_get_iface_info->Reserved, 0,
835  sizeof(undi_get_iface_info->Reserved) );
836 
837  DBGC ( &pxe_netdev, " %s %dbps flags %08x\n",
838  undi_get_iface_info->IfaceType, undi_get_iface_info->LinkSpeed,
839  undi_get_iface_info->ServiceFlags );
840  undi_get_iface_info->Status = PXENV_STATUS_SUCCESS;
841  return PXENV_EXIT_SUCCESS;
842 }
#define SUPPORTED_OPEN_CLOSE
Open / Close Adapter supported.
Definition: pxe_api.h:1376
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define SUPPORTED_IRQ
Interrupt Request supported.
Definition: pxe_api.h:1378
#define SUPPORTED_SET_STATION_ADDRESS
Software settable station address.
Definition: pxe_api.h:1370
#define SUPPORTED_RESET
Reset MAC supported.
Definition: pxe_api.h:1374
#define DBGC(...)
Definition: compiler.h:505
UINT32_t ServiceFlags
Service flags.
Definition: pxe_api.h:1401
UINT32_t LinkSpeed
Link speed, in bits per second.
Definition: pxe_api.h:1394
UINT32_t Reserved[4]
Must be zero.
Definition: pxe_api.h:1402
#define SUPPORTED_BROADCAST
Broadcast supported.
Definition: pxe_api.h:1362
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
#define SUPPORTED_MULTICAST
Multicast supported.
Definition: pxe_api.h:1364
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
int snprintf(char *buf, size_t size, const char *fmt,...)
Write a formatted string to a buffer.
Definition: vsprintf.c:382
UINT8_t IfaceType[16]
Interface type.
Definition: pxe_api.h:1393
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1382
static int netdev_irq_supported(struct net_device *netdev)
Check whether or not network device supports interrupts.
Definition: netdevice.h:663
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81
void * memset(void *dest, int character, size_t len) __nonnull

References DBGC, s_PXENV_UNDI_GET_IFACE_INFO::IfaceType, s_PXENV_UNDI_GET_IFACE_INFO::LinkSpeed, memset(), netdev_irq_supported(), pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_STATE, s_PXENV_UNDI_GET_IFACE_INFO::Reserved, s_PXENV_UNDI_GET_IFACE_INFO::ServiceFlags, snprintf(), s_PXENV_UNDI_GET_IFACE_INFO::Status, SUPPORTED_BROADCAST, SUPPORTED_IRQ, SUPPORTED_MULTICAST, SUPPORTED_OPEN_CLOSE, SUPPORTED_RESET, and SUPPORTED_SET_STATION_ADDRESS.

◆ pxenv_undi_isr()

static PXENV_EXIT_t pxenv_undi_isr ( struct s_PXENV_UNDI_ISR undi_isr)
static

Definition at line 853 of file pxe_undi.c.

853  {
854  struct io_buffer *iobuf;
855  size_t len;
856  struct ll_protocol *ll_protocol;
857  const void *ll_dest;
858  const void *ll_source;
859  uint16_t net_proto;
860  unsigned int flags;
861  size_t ll_hlen;
862  struct net_protocol *net_protocol;
863  unsigned int prottype;
864  int rc;
865 
866  /* Use a different debug colour, since UNDI ISR messages are
867  * likely to be interspersed amongst other UNDI messages.
868  */
869 
870  /* Sanity check */
871  if ( ! pxe_netdev ) {
872  DBGC ( &pxenv_undi_isr, "PXENV_UNDI_ISR called with "
873  "no network device\n" );
875  return PXENV_EXIT_FAILURE;
876  }
877 
878  DBGC2 ( &pxenv_undi_isr, "PXENV_UNDI_ISR" );
879 
880  /* Just in case some idiot actually looks at these fields when
881  * we weren't meant to fill them in...
882  */
883  undi_isr->BufferLength = 0;
884  undi_isr->FrameLength = 0;
885  undi_isr->FrameHeaderLength = 0;
886  undi_isr->ProtType = 0;
887  undi_isr->PktType = 0;
888 
889  switch ( undi_isr->FuncFlag ) {
891  DBGC2 ( &pxenv_undi_isr, " START" );
892 
893  /* Call poll(). This should acknowledge the device
894  * interrupt and queue up any received packet.
895  */
896  net_poll();
897 
898  /* A 100% accurate determination of "OURS" vs "NOT
899  * OURS" is difficult to achieve without invasive and
900  * unpleasant changes to the driver model. We settle
901  * for always returning "OURS" if interrupts are
902  * currently enabled.
903  *
904  * Returning "NOT OURS" when interrupts are disabled
905  * allows us to avoid a potential interrupt storm when
906  * we are on a shared interrupt line; if we were to
907  * always return "OURS" then the other device's ISR
908  * may never be called.
909  */
910  if ( netdev_irq_enabled ( pxe_netdev ) ) {
911  DBGC2 ( &pxenv_undi_isr, " OURS" );
912  undi_isr->FuncFlag = PXENV_UNDI_ISR_OUT_OURS;
913  } else {
914  DBGC2 ( &pxenv_undi_isr, " NOT OURS" );
916  }
917 
918  /* Disable interrupts */
919  netdev_irq ( pxe_netdev, 0 );
920 
921  break;
924  DBGC2 ( &pxenv_undi_isr, " %s",
925  ( ( undi_isr->FuncFlag == PXENV_UNDI_ISR_IN_PROCESS ) ?
926  "PROCESS" : "GET_NEXT" ) );
927 
928  /* Some dumb NBPs (e.g. emBoot's winBoot/i) never call
929  * PXENV_UNDI_ISR with FuncFlag=PXENV_UNDI_ISR_START;
930  * they just sit in a tight polling loop merrily
931  * violating the PXE spec with repeated calls to
932  * PXENV_UNDI_ISR_IN_PROCESS. Force extra polls to
933  * cope with these out-of-spec clients.
934  */
935  net_poll();
936 
937  /* If we have not yet marked a TX as complete, and the
938  * netdev TX queue is empty, report the TX completion.
939  */
940  if ( undi_tx_count && list_empty ( &pxe_netdev->tx_queue ) ) {
941  DBGC2 ( &pxenv_undi_isr, " TXC" );
942  undi_tx_count--;
944  break;
945  }
946 
947  /* Remove first packet from netdev RX queue */
948  iobuf = netdev_rx_dequeue ( pxe_netdev );
949  if ( ! iobuf ) {
950  DBGC2 ( &pxenv_undi_isr, " DONE" );
951  /* No more packets remaining */
952  undi_isr->FuncFlag = PXENV_UNDI_ISR_OUT_DONE;
953  /* Re-enable interrupts */
954  netdev_irq ( pxe_netdev, 1 );
955  break;
956  }
957 
958  /* Copy packet to base memory buffer */
959  len = iob_len ( iobuf );
960  DBGC2 ( &pxenv_undi_isr, " RX" );
961  if ( len > sizeof ( basemem_packet ) ) {
962  /* Should never happen */
963  DBGC2 ( &pxenv_undi_isr, " overlength (%zx)", len );
964  len = sizeof ( basemem_packet );
965  }
966  memcpy ( basemem_packet, iobuf->data, len );
967 
968  /* Strip link-layer header */
970  if ( ( rc = ll_protocol->pull ( pxe_netdev, iobuf, &ll_dest,
971  &ll_source, &net_proto,
972  &flags ) ) != 0 ) {
973  /* Assume unknown net_proto and no ll_source */
974  net_proto = 0;
975  ll_source = NULL;
976  }
977  ll_hlen = ( len - iob_len ( iobuf ) );
978 
979  /* Determine network-layer protocol */
980  switch ( net_proto ) {
981  case htons ( ETH_P_IP ):
982  net_protocol = &ipv4_protocol;
983  prottype = P_IP;
984  break;
985  case htons ( ETH_P_ARP ):
986  net_protocol = &arp_protocol;
987  prottype = P_ARP;
988  break;
989  case htons ( ETH_P_RARP ):
990  net_protocol = &rarp_protocol;
991  prottype = P_RARP;
992  break;
993  default:
994  net_protocol = NULL;
995  prottype = P_UNKNOWN;
996  break;
997  }
998 
999  /* Fill in UNDI_ISR structure */
1001  undi_isr->BufferLength = len;
1002  undi_isr->FrameLength = len;
1003  undi_isr->FrameHeaderLength = ll_hlen;
1004  undi_isr->Frame.segment = rm_ds;
1005  undi_isr->Frame.offset = __from_data16 ( basemem_packet );
1006  undi_isr->ProtType = prottype;
1007  if ( flags & LL_BROADCAST ) {
1008  undi_isr->PktType = P_BROADCAST;
1009  } else if ( flags & LL_MULTICAST ) {
1010  undi_isr->PktType = P_MULTICAST;
1011  } else {
1012  undi_isr->PktType = P_DIRECTED;
1013  }
1014  DBGC2 ( &pxenv_undi_isr, " %04x:%04x+%x(%x) %s hlen %d",
1015  undi_isr->Frame.segment, undi_isr->Frame.offset,
1016  undi_isr->BufferLength, undi_isr->FrameLength,
1017  ( net_protocol ? net_protocol->name : "RAW" ),
1018  undi_isr->FrameHeaderLength );
1019 
1020  /* Free packet */
1021  free_iob ( iobuf );
1022  break;
1023  default :
1024  DBGC2 ( &pxenv_undi_isr, " INVALID(%04x)\n",
1025  undi_isr->FuncFlag );
1026 
1027  /* Should never happen */
1028  undi_isr->FuncFlag = PXENV_UNDI_ISR_OUT_DONE;
1030  return PXENV_EXIT_FAILURE;
1031  }
1032 
1033  DBGC2 ( &pxenv_undi_isr, "\n" );
1034  undi_isr->Status = PXENV_STATUS_SUCCESS;
1035  return PXENV_EXIT_SUCCESS;
1036 }
#define LL_MULTICAST
Packet is a multicast (including broadcast) packet.
Definition: netdevice.h:105
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
unsigned short uint16_t
Definition: stdint.h:11
const char * name
Protocol name.
Definition: netdevice.h:66
#define PXENV_EXIT_FAILURE
An error occurred.
Definition: pxe_types.h:46
#define P_IP
IP protocol.
Definition: pxe_api.h:1012
void net_poll(void)
Poll the network stack.
Definition: netdevice.c:1052
PXENV_STATUS_t Status
PXE status code.
Definition: pxe_api.h:1480
UINT8_t PktType
Packet type.
Definition: pxe_api.h:1503
void free_iob(struct io_buffer *iobuf)
Free I/O buffer.
Definition: iobuf.c:145
#define ETH_P_IP
Definition: if_ether.h:18
#define DBGC(...)
Definition: compiler.h:505
#define PXENV_STATUS_UNDI_INVALID_PARAMETER
Definition: pxe_error.h:83
static PXENV_EXIT_t pxenv_undi_isr(struct s_PXENV_UNDI_ISR *undi_isr)
Definition: pxe_undi.c:853
#define P_DIRECTED
Unicast packet (or packet captured in promiscuous mode)
Definition: pxe_api.h:1472
#define rm_ds
Definition: libkir.h:39
UINT16_t FuncFlag
Function flag.
Definition: pxe_api.h:1489
A link-layer protocol.
Definition: netdevice.h:114
#define PXENV_UNDI_ISR_OUT_RECEIVE
A packet has been received.
Definition: pxe_api.h:1467
#define list_empty(list)
Test whether a list is empty.
Definition: list.h:136
#define PXENV_UNDI_ISR_IN_PROCESS
Start processing interrupt.
Definition: pxe_api.h:1455
void * memcpy(void *dest, const void *src, size_t len) __nonnull
UINT16_t FrameLength
Total frame length.
Definition: pxe_api.h:1491
#define PXENV_UNDI_ISR_IN_START
Determine whether or not this is our interrupt.
Definition: pxe_api.h:1453
struct list_head tx_queue
TX packet queue.
Definition: netdevice.h:411
#define P_MULTICAST
Multicast packet.
Definition: pxe_api.h:1476
SEGOFF16_t Frame
Data buffer address.
Definition: pxe_api.h:1493
#define PXENV_UNDI_ISR_OUT_TRANSMIT
A packet transmission has completed.
Definition: pxe_api.h:1465
static int netdev_irq_enabled(struct net_device *netdev)
Check whether or not network device interrupts are currently enabled.
Definition: netdevice.h:675
#define basemem_packet
UINT8_t ProtType
Protocol type.
Definition: pxe_api.h:1498
struct net_device * pxe_netdev
Definition: pxe_undi.c:59
static size_t iob_len(struct io_buffer *iobuf)
Calculate length of data in an I/O buffer.
Definition: iobuf.h:151
void netdev_irq(struct net_device *netdev, int enable)
Enable or disable interrupts.
Definition: netdevice.c:875
#define PXENV_UNDI_ISR_OUT_NOT_OURS
This interrupt was not ours.
Definition: pxe_api.h:1461
uint16_t net_proto
Network-layer protocol.
Definition: netdevice.h:99
#define PXENV_UNDI_ISR_IN_GET_NEXT
Continue processing interrupt.
Definition: pxe_api.h:1457
#define LL_BROADCAST
Packet is a broadcast packet.
Definition: netdevice.h:108
A network-layer protocol.
Definition: netdevice.h:64
#define PXENV_EXIT_SUCCESS
No error occurred.
Definition: pxe_types.h:45
#define P_BROADCAST
Broadcast packet.
Definition: pxe_api.h:1474
int(* pull)(struct net_device *netdev, struct io_buffer *iobuf, const void **ll_dest, const void **ll_source, uint16_t *net_proto, unsigned int *flags)
Remove link-layer header.
Definition: netdevice.h:141
uint32_t len
Length.
Definition: ena.h:14
#define DBGC2(...)
Definition: compiler.h:522
#define __from_data16(pointer)
Definition: libkir.h:22
void * data
Start of data.
Definition: iobuf.h:44
#define P_RARP
RARP protocol.
Definition: pxe_api.h:1014
#define PXENV_UNDI_ISR_OUT_DONE
Finished processing interrupt.
Definition: pxe_api.h:1463
#define ETH_P_ARP
Definition: if_ether.h:19
#define ETH_P_RARP
Definition: if_ether.h:20
#define P_ARP
ARP protocol.
Definition: pxe_api.h:1013
static int undi_tx_count
Count of outstanding transmitted packets.
Definition: pxe_undi.c:57
#define PXENV_STATUS_SUCCESS
Definition: pxe_error.h:19
#define P_UNKNOWN
Media header already filled in.
Definition: pxe_api.h:1011
UINT16_t FrameHeaderLength
Frame header length.
Definition: pxe_api.h:1492
#define PXENV_UNDI_ISR_OUT_OURS
This interrupt was ours.
Definition: pxe_api.h:1459
#define NULL
NULL pointer (VOID *)
Definition: Base.h:362
UINT16_t BufferLength
Data buffer length.
Definition: pxe_api.h:1490
#define htons(value)
Definition: byteswap.h:135
struct ll_protocol * ll_protocol
Link-layer protocol.
Definition: netdevice.h:366
#define PXENV_STATUS_UNDI_INVALID_STATE
Definition: pxe_error.h:81
struct io_buffer * netdev_rx_dequeue(struct net_device *netdev)
Remove packet from device's receive queue.
Definition: netdevice.c:538
A persistent I/O buffer.
Definition: iobuf.h:32
uint8_t flags
Flags.
Definition: ena.h:18

References __from_data16, basemem_packet, s_PXENV_UNDI_ISR::BufferLength, io_buffer::data, DBGC, DBGC2, ETH_P_ARP, ETH_P_IP, ETH_P_RARP, flags, s_PXENV_UNDI_ISR::Frame, s_PXENV_UNDI_ISR::FrameHeaderLength, s_PXENV_UNDI_ISR::FrameLength, free_iob(), s_PXENV_UNDI_ISR::FuncFlag, htons, iob_len(), len, list_empty, LL_BROADCAST, LL_MULTICAST, net_device::ll_protocol, memcpy(), net_protocol::name, net_poll(), net_protocol::net_proto, netdev_irq(), netdev_irq_enabled(), netdev_rx_dequeue(), NULL, P_ARP, P_BROADCAST, P_DIRECTED, P_IP, P_MULTICAST, P_RARP, P_UNKNOWN, s_PXENV_UNDI_ISR::PktType, s_PXENV_UNDI_ISR::ProtType, ll_protocol::pull, pxe_netdev, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_PARAMETER, PXENV_STATUS_UNDI_INVALID_STATE, PXENV_UNDI_ISR_IN_GET_NEXT, PXENV_UNDI_ISR_IN_PROCESS, PXENV_UNDI_ISR_IN_START, PXENV_UNDI_ISR_OUT_DONE, PXENV_UNDI_ISR_OUT_NOT_OURS, PXENV_UNDI_ISR_OUT_OURS, PXENV_UNDI_ISR_OUT_RECEIVE, PXENV_UNDI_ISR_OUT_TRANSMIT, rc, rm_ds, s_PXENV_UNDI_ISR::Status, net_device::tx_queue, and undi_tx_count.

Variable Documentation

◆ undi_tx_count

int undi_tx_count = 0
static

Count of outstanding transmitted packets.

This is incremented each time PXENV_UNDI_TRANSMIT is called, and decremented each time that PXENV_UNDI_ISR is called with the TX queue empty, stopping when the count reaches zero. This allows us to provide a pessimistic approximation of TX completion events to the PXE NBP simply by monitoring the netdev's TX queue.

Definition at line 57 of file pxe_undi.c.

Referenced by pxe_netdev_close(), pxenv_undi_isr(), and pxenv_undi_transmit().

◆ pxe_netdev

struct net_device* pxe_netdev = NULL

◆ __profiler

struct profiler undi_tx_profiler __profiler = { .name = "undi.tx" }
static

Transmit profiler.

Definition at line 62 of file pxe_undi.c.

◆ __pxe_api_call

struct pxe_api_call pxe_undi_api [] __pxe_api_call

PXE UNDI API.

Definition at line 1039 of file pxe_undi.c.