SCO OpenServer

mdi_netboot(D3mdi)

mdi_netboot: mdi_netboot_info, mdi_netboot_quiet, mdi_netboot_me -- network boot support for MDI drivers

Synopsis (Not in SVR5 version)

   #include <sys/mdi.h>
   
   int mdi_netboot_info(
   	char * driver_name,
   	int minor_num,
   	char * label);
   

   int mdi_netboot_quiet(
   	char * driver_name,
   	int minor_num);
   

   int mdi_netboot_me(
   	char * driver_name,
   	int minor_num);

Description

The mdi_netboot( ) functions implement the network boot feature for MDI drivers.

mdi_netboot_info( ) is used by MDI drivers at init time to obtain configuration values specified in the net.mdi=driver_name(minor_num) net.param=(label:value) arguments on the Boot: command line. In network installation, these parameters are passed over the network from the server.

The following labels are valid:

Label Description

"bus" enumated bus type

"phy" enumerated media type

"slt" slot number

"io" I/O base address

"irq" interrupt line

"mem" memory address

"msz" memory size

"dma" DMA address

"pcb" PCI bus number

"pcd" PCI device number

"pcf" PCI function number

mdi_netboot_quiet( ) is used by MDI drivers at init time to determine if the driver should suppress the "ADAPTER NOT FOUND" message in the XXinit( ) routine.

mdi_netboot_me( ) is used by MDI drivers at init time to determine if the driver name and minor device number were specified in the net.mdi=driver_name(minor_num) parameter on the Boot: command line.

Context and synchronization

Blockable context.

Hardware applicability

All

Version applicability

mdi: 1

Differences between versions

This function is not supported in MDI on SVR5 systems; all calls can be deleted. See the e3B sample driver source that is included in the ndsample package to see an example of how this function can be stubbed out.

Return values

mdi_netboot_info( ) return values correspond to the label specified:

Label type Value returned in

integer hex

bus type media type appropriate enumerated type as defined for the MDI_BUS_* and MDI_MEDIA_* flags in the <sys/mdi.h> header file.

A -1 is returned if no label is specified. 0 may be returned for a bad integer conversion for all label types except for bus and phy.

For example, if the following line is typed at the Boot: prompt:

   Boot: unix net.mdi=wdn(0)  net.param-(bus:isa,io:0x240)

And the MDI driver is coded:

   mdi_netboot_info("wdn", 0, "io")

mdi_netboot_info( ) returns 576.

The return values from mdi_netboot_quiet( ) are:

0: Print the Adapter Not Found message at system initialization; either this adapter is specified or no adapter is specified.
1: Do not print the Adapter Not Found message at system initialization; a different network adapter was specified at boot time.

The return values from mdi_netboot_me( ) are:

1: this adapter (driver and minor number) are specified
0: all other cases

References

boot

Label	Description
"bus"	enumated bus type
"phy"	enumerated media type
"slt"	slot number
"io"	I/O base address
"irq"	interrupt line
"mem"	memory address
"msz"	memory size
"dma"	DMA address
"pcb"	PCI bus number
"pcd"	PCI device number
"pcf"	PCI function number

Label type	Value returned in
integer	hex
bus type media type	appropriate enumerated type as defined for the MDI_BUS_* and MDI_MEDIA_* flags in the <sys/mdi.h> header file.