upd_channel_id(8) (RM400 only) upd_channel_id(8)
NAME
updchannelid - display/modify the channel IDs saved in the NVRAM
SYNOPSIS
updchannelid {-l | -o | [-f] -c | [-f] -w file}
DESCRIPTION
The channel ID is used to uniquely identify devices and is unique
within its device-specific class. It forms the link between the
software level (e.g. device name) and the slot.
At initial system startup, the device drivers are assigned a unique
channel ID within the class. This configuration is stored in the NVRAM
(non volatile random access memory).
Every time the system starts up, the channel ID is read by the device
drivers. The entry in the NVRAM is read through specification of the
slot information (e.g. PCI#1/1) and class (e.g. ETHER).
The saved configuration remains available if a device is no longer
available, (e.g. due to repairs). If a device of the same type (the
slot information must also be the same) is now attached to this slot,
the saved configuration is used.
The saved configuration is lost if a device of a different class is
attached with the same slot information.
The saved configuration can be read and modified with updchannelid.
Onboard entries can neither be displayed nor modified with the
updchannelid command.
OPTIONS
-l Outputs a table containing all the channel IDs to the screen
(stdout).
-o Used to convert (old) log IDs to (new) channel IDs for the SCSI
class. As a rule, this is required once for the update installa-
tion. Outputs a table containing all the channel IDs to the
screen (stdout). The channel IDs are calculated according to the
old (updeisa) algorithm.
-c Deletes all channel ID entries from the NVRAM.
-w Reads the table of channel ID entries from the specified file,
checks the information, and saves it in the NVRAM.
-f Deletes/writes to NVRAM for ROOT channels also.
Page 1 Reliant UNIX 5.44 Printed 11/98
upd_channel_id(8) (RM400 only) upd_channel_id(8)
file Contains the channel ID entries to be stored in the NVRAM.
A channel ID entry has the following structure:
slot[.subchannel], channelid, [classcode], [driver], [option], [comment]
where
slot EISA#1 | EISA#2 | ... | PCI#1 | ... | PCI#14/14/14
Interface type and slot number of the controller plug-in
board.
subchannel 0 ... 9, for EISA 0 ... 7
channelid 0 ... 99, for EISA log ID 0 ... 31
classcode Device specific class.
MISC | SCSI | FLOPPY | MASSSTORE | ETHER | TOKEN | FDDI |
ATM | NETWORK | DISPLAY | MULTIMEDIA | COMMDEV
The device specific classes are calculated on the basis of
the PCI specification.
Entries using the old EISA log ID do not belong to any
class.
driver Name of the driver, e.g. adp.
option Optional parameter, used, for example, for a SCSI host ID.
comment Brief controller description.
A channel ID entry based on the slot information (slot and subchan-
nel), which must be unique within the list. The specified channel ID
(channelid) must also be unique within the specified class
(classcode). The entries for the driver name (driver) and comment
(comment) are only displayed and consequently cannot be set. The
optional field (option) can be modified and is evaluated in relation
to the specific driver.
For EISA log ID entries, the option field can neither be displayed nor
set.
Page 2 Reliant UNIX 5.44 Printed 11/98
upd_channel_id(8) (RM400 only) upd_channel_id(8)
The option field has the following meaning for the SCSI class:
- The lower (right-hand) four bits contain the host adapter ID. This
is preassigned a standard value by the corresponding driver (e.g.
0x07). Values greater than seven relate to a wide controller.
- Some host adapters support ULTRA SCSI. To enable this feature, bit
6 has to be set (e.g. 0x27 for ULTRA SCSI, host adapter ID 7).
- Some host adapters support ULTRA2 SCSI. The fifth bit is set in
order to enable this feature to be used (e.g. 0x17 for ULTRA2 SCSI,
host adapter ID 7).
If the values for ULTRA SCSI and ULTRA2 SCSI are set in the option
field, synchronous data transmission is only performed at a speed
of 5 MHz (provided the host adapter supports this).
- The seventh bit is set for multihost mode (e.g. 0x47). The con-
troller is identified by the term "shared" in the autoconf -l out-
put.
- In some special cases, where wide negotiations cause the device to
malfunction, these wide negotiations are suppressed by setting the
eight bit (e.g. 0x87).
EXAMPLES
The updchannelid -l command delivers the following output:
#
#slot.subchannel, channelid, classcode, driver, option, comment
#
EISA#1, 1, ETHER, mac596, 0x00, ETHER SNI Intel 8259
EISA#2, 4, SCSI, adp, 0x07, SCSI ADP ADP1740A DE
PCI#1/2, 0, DISPLAY, gfx, 0x00, DISPLAY SNI CIRRUS 5
PCI#1/1, 2, SCSI, ncr, 0x07, SCSI SNI SYM53C875 S
PCI#2, 3, SCSI, , 0x48,
PCI#2.0, 5, SCSI, dpt, 0x07, SCSI DPT PM3222 SE
PCI#2.1, 6, SCSI, dpt, 0x07, SCSI DPT PM3222 SE
PCI#2.2, 7, SCSI, dpt, 0x07, SCSI DPT PM3222 SE
PCI#3, 0, TOKEN, madge, 0x02, TOKEN MADGE Smart 16
Page 3 Reliant UNIX 5.44 Printed 11/98
upd_channel_id(8) (RM400 only) upd_channel_id(8)
______________________________________________________________________
| Slot Description |
|_____________________________________________________________________|
| EISA 1 SNI Ethernet controller |
| EISA 2 SCSI Adaptec AHA 1740A controller |
| PCI 1 Super Combo Board from SNI, with a graphics board and SCSI |
| controller operated behind the jumper. |
| PCI 2 A SCSI controller with the host adapter ID 8 was previously|
| attached here. This controller was operated in multihost |
| mode with wide peripherals. |
| PCI 2 3-channel SCSI controller from DPT |
| PCI 3 Token ring controller from Madge |
|_____________________________________________________________________|
NOTES
Changes made in the NVRAM with the updchannelid command are only
effective after a reboot. The output (updchannelid -l) of the driver
and comment fields will not be displayed correctly prior to this.
When the channel ID configuration has been changed, the current confi-
guration is stored in the /etc/info/channelid file when the system is
powered down. The old configuration is stored in the
/etc/info/channelid.old file.
A binary map of the channel ID configuration (NVRAM) is copied to par-
tition 10 of the root disk when the system is powered down.
FILES
/dev/nvram
SEE ALSO
nvram(7), sdisk(7), stape(7), autoconf(8).
Page 4 Reliant UNIX 5.44 Printed 11/98