ADAPTER: section

Each AOF contains an ADAPTER section that describes the adapter class. The synopsis is:

   ADAPTER:
      DESCRIPTION="string"[,"string2"]
      BUS=EISA|ISA|PCI|PCMCIA|MCA
      MEDIA_TYPE=ethernet|token-ring|fddi
      MAX_BD=highest_board_number
      KEY=attribute[,attribute]
   

      [ID=hex_id1[,hex_id2]
           hex_id1 ="description of hex_id1 adapter"
           hex_id2 ="description of hex_id2 adapter"]
      [SPEED=very_slow|slow|medium|fast]
      [NET_BOOT=static|dynamic|autosearch]
   

      REQUIRED=attribute_list
      ADVANCED=attribute_list
      attribute_list::=[attribute]?[,attribute]
      attribute::=[a-zA-Z][a-zA-Z0-9_]

DESCRIPTION

Describes the adapter class to the user. This is a string enclosed in double quotes and is often the commercial name of the device. If an adapter class has several unique descriptions (such as clone adapter names), the DESCRIPTION value may contain more than one description.

BUS

Specifies the bus supported by the driver. Currently, network adapter drivers support EISA, ISA, PCI, PCMCIA, and/or MCA machine architectures. If a network driver supports adapters for more than one machine architecture, create an AOF for each bust type. For example, if an adapter supports both ISA and MicroChannel adapters, create an AOF to describe the ISA adapter(s) and a separate AOF to describe the MicroChannel adapter(s).

If EISA, PCI, and/or MCA are specified, the AOF file must also include an ID attribute.

MEDIA_TYPE

Indicates the media supported by the network adapter(s). Currently, this may be set to ethernet, token-ring, or fddi. If a network driver supports adapters for more than one media type, create one AOF for each media type.

MAX_BD

Maximum board ID. Set this to the maximum number of adapters supported by the driver minus 1 (because the first board ID is 0). For example, if a driver supports up to 4 adapters in a single machine, set MAX_BD=3.

KEY

Name(s) of the configurable option(s) that the driver uses to locate adapters in the system. Typically, this is:

For ISA adapters

BASE_IO

I/O Base address

For EISA and MCA adapters

SLOT

Slot number

For PCI adapters

PCI_BUS

Bus

PCI_DEV

Device

PCI_FUNC

Function numbers.

The configurable option(s) listed for this attribute are referred to as the adapter's KEY.

ID

Adapter ID, in hexadecimal. If EISA, PCI, and/or MCA are specified for the BUS parameter, an ID attribute is required. netconfig uses this parameter tto search for adapters with known IDs.

Each of the values for the ID attribute specifies an adapter ID in hexadecimal. Hexadecimal ID values use lower case characters and have no leading ``0x''. Each adapter ID also has an attribute of the same name that contains a double-quoted description string that overrides the more general ADAPTER:DESCRIPTION string. For example:

   ADAPTER:
       DESCRIPTION="general description of adapters not currently in system"
       ...
   	ID=4000,5f3l
           4000="exact description of adapter with id 0x4000"
           5f3l="exact description of adapter with id 0x5f3l"

For MicroChannel adapters, the values specified in the ID attribute are two byte (four digit) hexadecimal adapter POS-IDs.

For EISA adapters, the values specified in the ID attribute are four byte (eight digit) EISA product identifiers in hexadecimal. Note that the order of bytes is reversed from that normally associated with the EISA product ID. For example, if the EISA product ID is found in I/O ports 0x0zC80-0x0zC83, where z is replaced with a hexadecimal representation of the slot number, the value in the ID attribute is in the order:

   inb(0x0zC83) inb(0x0zC82) inb(0x0zC81) inb(0x0zC80)

Run the eisadump command on an EISA machine with your adapter and look at the row beginning with the slot number of your adapter. The column immediately after boardid has the expected ID order.

For PCI adapters, the values specified in the ID attribute are 5 byte (ten digit) concatenations of the PCI vendor ID, Device ID, and Revision ID. Run the following command on a PCI machine with your adapter to get the expected ID order:

   `llipathmap`/bin/pcislot -h

SPEED

Provide some measure of the performance of a particular driver/adapter to protocol stacks that wish to use this information. Currently, SCO TCP/IP uses this information to determine appropriate performance parameters for the perf argument to the ifconfig command. If no SPEED attribute is specified, this value defaults to medium.

NET_BOOT

Indicates level of support for boot configuration parameters. This is used by the installation kernel for network installations.

Valid values are:

static

Driver does not obtain configuration parameters from boot line and does not search for adapters.

dynamic

Driver obtains configuration parameters from boot line.

autosearch

If no boot line KEY is specified, the driver uses the first available adapter. Valid only for EISA, MCA, and PCI busses.

If this attribute is not specified and the driver is used in the installation kernel, the attribute defaults to static.

REQUIRED

A list of other attributes tha are required for this adapter. See ``Specifying other sections'' for information about how to define these sections.

ADVANCED

A list of other attributes that can be configured through the "Advanced options" section of the Network Configuration Manager. See ``Specifying other sections'' for information about how to define these sections.