edittbl(1M) MISC. REFERENCE MANUAL PAGES edittbl(1M)
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 edtdata 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; warn-
ings and errors are not affected. This option is pri-
marily useful in installation and removal scripts.
-B Specifies that the edtdata 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
edtdata file will be edited.
Last change: Essential Utilities 1
edittbl(1M) MISC. REFERENCE MANUAL PAGES edittbl(1M)
file The user may specify a target path name for the utili-
ties. The default for the -d and -s options is
./edtdata. 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/edtdata.
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
IDcode Number between 0x0 and 0xffff that a device
uses to identify itself. For extended dev-
ices (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.
rqsize Number between 0x0 and 0xff for the count of
entries in a device's job request queue.
cqsize Number between 0x0 and 0xff for the count of
entries in a device's job completion queue.
bootdevice Determines whether a device may be used to
boot programs. A ``1'' means that it is
bootable; a ``0'' means that it is not.
wordsize 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.
brdsize Specifies the I/O connector slots that a dev-
ice requires. A ``1'' indicates that two
slots are needed, while a ``0'' means that
one is required.
smartboard 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.
conscap Shows whether a device can support the system
console terminal. A ``1'' is used for
Last change: Essential Utilities 2
edittbl(1M) MISC. REFERENCE MANUAL PAGES edittbl(1M)
devices that can, a ``0'' for those that can-
not.
consfile Shows whether a device needs downloaded code
to support the console interface when
conscap 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. consfile must have the value of "0"
when conscap is "0".
Subdevices
IDcode Number between 0x0 and 0xffff for the code
that identifies a subdevice. Subdevice ID
codes are administered by AT&T.
subdevname String (maximum of 9 characters) for a sub-
device name. Subdevice names are admin-
istered by AT&T.
devname String (maximum of 9 characters) for the dev-
ice name with which the subdevice is associ-
ated.
Last change: Essential Utilities 3
edittbl(1M) MISC. REFERENCE MANUAL PAGES edittbl(1M)
EXAMPLES
Generate and list the base entries for both the device and
subdevice tables, saving the results in ./edtdata.
edittbl -g -l -s -d
Install subdevice entries with new ID codes from the file
subdev.in into the existing file ./edtdata.
edittbl -i -s < subdev.in
List the device table entries found in /dgn/edtdata
edittbl -l -d /dgn/edtdata
FILES
/dgn/edtdata
/edt/SCSI/edtdata
/etc/scsi/edittbl
Last change: Essential Utilities 4