NAME

edittbl - edit edt_data file

SYNOPSIS

/usr/sbin/edittbl -d  |-s  {-g  |-i  |-l  |-r}  [-t]  [file]
/usr/sbin/edittbl -B bus_type {-g |-i |-l |-r} [-t] [file]

DESCRIPTION

The edittbl command is a user-level utility that permits changes to edt_data files. These files are used by firmware programs (see firmware(8)) during construction of the Equipped Device Table (EDT). Note that only one of the -g, -i, -l, and -r options may be specified in either of the forms shown above. edittbl prints the option list when no arguments are specified. The options and arguments are:

-d Selects the device look-up table for the system bus. This option cannot be used with the -B option.

-s Selects the sub-device look-up table for the system bus. This option cannot be used with the -B option.

-g Generates the default entries for the selected look-up table(s). This overwrites any entries that are currently in the selected look-up table(s). For the device table, these base entries are SBD and PORTS. For the subdevice table, they are NULL, FD5, HD10, HD30, HD72, HD72A, HD72B, HD72C, HD43, and HD72D.

-i Specifies that new entries are to be added to the selected table(s). The ID codes for table entries and the input are compared; only new codes are installed. The formats for entries are described below. An EOF or ``.'' ends the data input.

-l Specifies that the selected table(s) are to be listed.

-r Specifies that entries are to be removed from either table. The ID codes of the table are compared to the input; entries with codes that match the input are removed. The format is identical to that for the -i option and is listed below. An EOF or ``.'' ends the data input.

-t Suppresses the program headings and user prompts; warnings and errors are not affected. This option is primarily useful in installation and removal scripts.

-B Specifies that the edt_data file for bus_type is to be edited. Currently the only bus type supported is scsi. If this option is not specified, the system bus edt_data file will be edited.

file The user may specify a target path name for the  utili-
     ties.   The  default  for  the  -d  and  -s  options is
     ./edt_data.  For the -B option and the scsi  bus  type,
     file  is  where the target controller information is to
     be placed;  the default  for  the  -B  scsi  option  is
     /edt/SCSI/edt_data.

INPUT FORMAT

Data for installation/removal is entered as hex format numbers or character strings, one line for each table entry. The data fields must be supplied in the sequence described below.

Devices

ID_code Number between 0x0 and 0xffff that a device uses to identify itself. For extended devices (such as SCSI), add 0x10000 to the ID_code. ID codes are administered by AT&T.

name Field name for a device. Device names are administered by AT&T. This string is also the file name that DGMON loads to diagnose a device.

rq_size Number between 0x0 and 0xff for the count of entries in a device's job request queue.

cq_size Number between 0x0 and 0xff for the count of entries in a device's job completion queue.

boot_device Determines whether a device may be used to boot programs. A ``1'' means that it is bootable; a ``0'' means that it is not.

word_size Shows the word size of a device I/O bus. A ``1'' is used for devices with a 16 bit bus word; a ``0'' is used for devices with an 8 bit bus word.

brd_size Specifies the I/O connector slots that a device requires. A ``1'' indicates that two slots are needed, while a ``0'' means that one is required.

smart_board Determines whether a device is intelligent, i.e., requires downloaded code for normal operation or supports subdevices. A ``1'' indicates an intelligent device; a ``0'' specifies a ``dumb'' device.

cons_cap Shows whether a device can support the system console terminal. A ``1'' is used for devices that can, a ``0'' for those that cannot.

cons_file Shows whether a device needs downloaded code to support the console interface when cons_cap has a value of "1". A "0" in this field means that the device can support a system console terminal with PROM-based code. A "1" in this field means downloaded code is needed. cons_file must have the value of "0" when cons_cap is "0".

Subdevices

ID_code Number between 0x0 and 0xffff for the code that identifies a subdevice. Subdevice ID codes are administered by AT&T.

subdev_name String (maximum of 9 characters) for a subdevice name. Subdevice names are administered by AT&T.

dev_name String (maximum of 9 characters) for the device name with which the subdevice is associated.

EXAMPLES

Generate and list the base entries for both the device and subdevice tables, saving the results in ./edt_data.

edittbl -g -l -s -d

Install subdevice entries with new ID codes from the file subdev.in into the existing file ./edt_data.

     edittbl -i -s < subdev.in

List the device table entries found in /dgn/edt_data

     edittbl -l -d /dgn/edt_data

FILES

/dgn/edt_data
/edt/SCSI/edt_data
/etc/scsi/edittbl