Blank lines and lines beginning with ``#'' or ``*'' are considered comments and are ignored up to the line containing the first occurrence of the driver name, but lines beyond the driver name are processed regardless of ``#'' or ``*'' symbols. It is important to keep comments in the header only, before the first line containing the driver name. Multiple fields on a line are separated by vertical bars (``|'').
The first non-comment line of a Drvmap file contains the following per-driver fields:
Typical entries for category include:
When the bus_type is ISA and there are multiple ISA entries, only the brand is displayed because the specific entry cannot be identified.
Following the driver information line is a line for each board type supported by the driver:
Valid entries for bus_type are:
EISA board IDs are in uncompressed form.
MCA board IDs are in the form:
where each D is a hex digit, 0-9 or A-F. MCA board IDs must be four digits; when necessary leading zeroes must be used. For example:
PCI board IDs are in the form:
where V and D are hex digits, 0 - 9 or A - F, VVVV is the vendor ID, and DDDD is the device ID.
PCI board IDs may also be specified as:
CLASSxssbbwhere s and b are hex digits, 0 - 9 or A - F, ss is the sub-class ID, and bb is the base-class ID. This form matches any board of the given class and subclass.
I2O board IDs are specified as:
0xCCCCEach C is a hex digit, 0 - 9 or A - F, that combine to specify the I2O class code as defined by the I2O SIG; see ``I2O'' in HDK Technical Reference.
PCCARD board IDs are specified as:
0xVVVVIIIIFFwhere V, I, and F are hex digits, 0 - 9 or A - F. VVVV is the PC Card manufacturer code (TPLMID_MANF) and IIII is the manufacturer information (TPLMID_CARD) from the Manufacturer Identification Tuple (CISTPL_MANFID). In the event a CISTPL_MANFID tuple is not found a board ID will be created by making a checksum out of the bytes comprising the Level 1 Version/Product Information Tuple (CISTPL_VERS_1). FF is the function number, starting with 00.
Note that board lines are distinguished from driver lines by the initial vertical bar.
Each of the category, brand, and board_name fields can be a simple string or a message catalog reference in the following format:
where msgfile, msgnum, and string are the message catalog filename, the message number, and the default (English) string as expected by gettxt(C). The initial colon (``:'') distinguishes catalog references from simple strings.