Intel Extensible Firmware Interface Network Router User Manual


  Open as PDF
of 1084
 
32/64-Bit UNDI Specification
Version 1.10 12/01/02 E-71
E.4.13 Statistics
This command is used to read and clear the NIC traffic statistics. Before using this command check
to see if statistics is supported in the !PXE.Implementation flags.
E.4.13.1 Issuing the Command
To issue a Statistics command, create a CDB and fill it in as shown in the table below:
CDB Field How to initialize the CDB structure for a Statistics command
OpCode
PXE_OPCODE_STATISTICS
OpFlags Set as needed.
CPBsize
PXE_CPBSIZE_NOT_USED
DBsize
sizeof(PXE_DB_STATISTICS)
CPBaddr
PXE_CPBADDR_NOT_USED
DBaddr
Address of PXE_DB_STATISTICS structure.
StatCode
PXE_STATCODE_INITIALIZE
StatFlags
PXE_STATFLAGS_INITIALIZE
IFnum
A valid interface number from zero to !PXE.IFcnt.
Control Set as needed.
OpFlags
To read the current statistics counters set the OpFlags field to:
PXE_OPFLAGS_STATISTICS_READ
To reset the current statistics counters set the OpFlags field to:
PXE_OPFLAGS_STATISTICS_RESET
E.4.13.2 Waiting for the Command to Execute
Monitor the upper two bits (14 & 15) in the CDB.StatFlags field. Until these bits change to
report PXE_STATFLAGS_COMMAND_COMPLETE or PXE_STATFLAGS_COMMAND_FAILED,
the command has not been executed by the UNDI.
StatFlags Reason
COMMAND_COMPLETE Command completed successfully. DB is written.
COMMAND_FAILED Command failed. StatCode field contains error code.
COMMAND_QUEUED Command has been queued.
INITIALIZE Command has been not executed or queued.