eisa(ADM)

eisa -- report on boards that are installed on the EISA bus

Syntax

/etc/eisa [ slots | h | H ]

/etc/eisa_nvm "argtype ..." [ arg ... ]

/etc/eisadump [ -abghz ] [ -i eisafile ]

Description

The eisa command provides information about the host adapters that are installed on the system. By default, eisa reports on the motherboard and 15 slots (slots 0-15). You can specify the number of slots for which you want a report. If you specify a higher number of slots than you have on your computer, the eisa report for those slots is invalid. If you do not specify slot information, use the H or h options to get usage information.

Here is a sample report:

   Slot:	EISA ID:	Vendor:	Prod#:	Rev#:	EISA Ver:
   MB	22 f0 fd 09	HWP	0xfd	01	1
    4	04 90 00 00	ADP	0x000	00
    6	04 90 00 00	ADP	0x000	00
   15	22 f0 08 01	HWP	0x080	01

These columns have the following meanings:

Slot: logical number of the slot on the EISA bus to which the board is attached. The motherboard is always configured as slot 0, so slot 0 is reported as ``MB''.
EISA ID: standard EISA ID. The first four digits represent the vendor; the next four digits represent the product number and the revision number for the product.
Vendor: abbreviation for the vendor of the board. The sample report shows that the motherboard and the board in slot 15 are sold by HP and the boards in slots 4 and 6 are sold by Adaptec. Note that this column merely interprets the vendor information given in the first four digits of the EISA ID column.
Prod#: product number of the individual board. These numbers are assigned by the vendor and should be explained in the documentation that accompanies the board.
Rev#: hardware revision number for the board.
EISA Ver: EISA version number. Each motherboard is encoded with a version of the EISA specification to which it conforms, and that version number is given in this column.

eisa_nvm provides access to the hardware configuration data stored in EISA non-volatile memory, for driver installation scripts and other programs that run in user space.

The argument types (argtype) act as filters on the output of eisa_nvm and define the format that the arguments (arg) must take. At least one of the following argument types must be specified:

BOARD_ID: EISA-readable board ID. The argument arg must be specified as a board ID followed by a decimal or hexadecimal mask indicating how much of the board ID is significant. Alternatively, you can specify ``?'' wildcards for individual characters in the board ID, for example, ``ADP????'', ``ECS11??'', or ``CPQ??01''.
CHECKSUM: EISA board firmware checksum. Takes an integer argument in decimal or hexadecimal format.
FUNCTION: Function record number within an EISA slot. Takes an integer argument in decimal or hexadecimal format.
RESOURCES: EISA board resources (display only valid values). The argument arg must be specified as a list containing one or more of the following identifiers separated by spaces and enclosed in double quotes ("): MEMORY, IRQ, DMA, and PORT.
REVISION: EISA board revision number. Takes an integer argument in decimal or hexadecimal format.
SLOT: EISA bus slot number. Takes an integer argument in decimal or hexadecimal format.
SUB_TYPE: EISA board sub-type string.
TYPE: EISA board type string.

eisa_nvm returns 0 if it succeeds. Otherwise, it returns a value greater than 0 and prints a diagnostic message.

If the exit code is 0, eisa_nvm writes one or more strings with the following format to the standard output:

slot board_ID dma vector SIOA EIOA SCMA ECMA

The fields have the following meanings:

slot: Slot number.
board_ID: Board ID.
dma: DMA channel (DMA resource).
vector: Interrupt vector (IRQ resource).
SIOA: Start I/O address (PORT resource).
EIOA: End I/O address.
SCMA: Start controller memory address (MEMORY resource).
ECMA: End controller memory address.

A value of -1 indicates that the field is not valid. See mdevice(F) for more information about the dma field and sdevice(F) for more information about the fields vector through ECMA.

eisadump opens the EISA ROM driver device (by default, this is /dev/eisa0), reads the configuration data passed from boot to the kernel at system startup, and writes the information to the standard output.

eisadump takes the following options:

-a: Show every field; implies all options expect -h.
-b: Show the individual components (bits) of bitfields; usually, unless -a is specified, the whole bitfield is dumped as one value.
-g: Show the unique function number calculated by boot.
-h: Print a header for each of the columns.
-i eisafile: Specify a device file other than /dev/eisa0.
-z: Print a field even if it is zero; normally, zero fields are suppressed.

The fields in the output from eisadump have the following meanings:

SYS: Unique function number calculated by boot.
ST: Slot number.
FNC: Function number within a slot.
NO: Subdivision within a function.
DESCRIPTION: Name of field from the /usr/include/sys/nvm.h file.
HEX: Field value in hexadecimal.
OCTAL: Field value in octal.
DECIMAL: Field value in decimal.
ASCII: Field value in ASCII characters.

Diagnostics

The EISA ROM BIOS driver (eisarom) interfaces to the EISA bus, and is primarily used to extract device information that was collected at system startup by the EISA ROM BIOS. It displays the following message if it cannot allocate enough memory to store the EISA configuration information:

NOTICE: eisarom: Cannot allocate nk for EISA configuration

The error ENOMEM is set in errno and the configuration is aborted.

Exit values

eisa returns a 0 value if successful. A return value of 1 indicates a command line error, a return value of 2 indicates that the motherboard was not located, and a return value greater than 2 indicates an unspecified error.

If the slot number that you specify is larger than the actual number of slots, the results are unpredictable; however, the return value is still 0.

Examples

The following examples demonstrate the syntax of the eisa_nvm command:

eisa_nvm SLOT 0

eisa_nvm "SLOT TYPE" 0 C eisa_nvm "SLOT TYPE" 0 COM

eisa_nvm BOARD_ID ??????? eisa_nvm BOARD_ID CPQ40?? eisa_nvm BOARD_ID CPQ4001 0xFFFFFFFF

eisa_nvm "BOARD_ID SUB_TYPE" CPQ4001 0xFFFFFFFF BMIC eisa_nvm "BOARD_ID SUB_TYPE" CPQ40?? BMIC eisa_nvm "BOARD_ID SUB_TYPE" CPQ4010 CTL1

Display all EISA boards which use a valid interrupt vector:

   eisa_nvm RESOURCES IRQ

Display all EISA boards which use a valid DMA channel:

   eisa_nvm "RESOURCES" "DMA"

Warning

The eisa commands return an error or meaningless results on a non-EISA bus machine.

Limitations

The eisa commands report only EISA boards that are installed on an EISA system, not the 8-bit or 16-bit ISA (XT/AT) boards.

Only root can execute the eisa commands.

Files

/dev/eisa0: device node for eisarom driver
/usr/include/sys/eisa.h
/usr/include/sys/nvm.h: header files

Standards conformance

eisa, eisa_nvm, and eisadump are not part of any currently supported standard; they are an extension of AT&T System V provided by The Santa Cruz Operation, Inc.