uashodev
NAME
uashodev - Show I/O device table
DESCRIPTION
The uashodev command reports the a Digital UNIX system device table, con-
trollers, and busses. If run with kmem group or root authority then the
kernel device, controller, and bus names are displayed. uashodev utilizes
the device routine employed by uaio and as such can be used to debug or
predict what uaio can report.
RESTRICTIONS
Under DU v3.2 disk device names report as 'rz' and there is no distinction
between CDROM and DISK devices (all are disks).
Under DU v4.0 names all report as 'cam' instead of 'rz' and kmem device
names do distinguish CDROM vs. DISK.
Under DU v4.0b the device information table is updated for average service
time which appears to be accumulated time in microseconds from when I/O's
are issued until they are satisfied. With uaio under DU v4.0 and presum-
ably later this value is reported as the average milliseconds per transfer.
For uaio purposes a 'disk' under v3.2g is any device named 'rz' or 're'.
Under DU v4.0b without kmem authority any 'cam' device with non-negative
'dk' is considered a disk. With kmem authority only device type 'disk' is
considered. Effective with v1.3 're' disks (swxcr based) are recognized.
Note that 'fd' devices are incorrectly defined as disks under both DU v3.2g
and v4.0b.
Under DU v4.0b (vs. DU v3.2g) changes were made in how device tables retain
information. The disk_info() routine utilized by uaio and uashodev recog-
nizes both versions. Under 4.0b, the di_name field [table(TBL_DKINFO] now
appears to include the lun letter (such as rzb17) although uaio still
fabricates the letter. uashodev reports both the di_name lun letter and
the project letter, the fabricated display looks like rzb(b)17. Under 4.0b
logunit [getsysinfo(GSI_DEV_STRUCT] is a relative number for scsi disks not
the real lu, for scsi disks the real lu should come from di_unit
[table(TBL_DKINFO] although logunit is still believed to be valid for swxcr
(re) devices.
These were observed to be usable rules on several systems, but under some
circumstances (e.g., untested configurations) these may not work. If these
rules are inappropriate for some configuration then report the configura-
tion with a uashodev display to dutools@ts.sois.alaska.edu.
Device naming is based on Digital conventions for scsi disks. For example,
rzc57 where 'c' represents a LUN-2 device and 57 would be bus#7 logical
unit 1 (7*8+1=57 or 'scu show device bus 7 target 1 lun 2').
A bus may contain other busses and controllers and busses are numbered in
Digital UNIX by their type. In other words, there is no absolute con-
troller number or bus number... within the operating system these struc-
tures are maintained by links so no absolute numbering is required. There-
fore, uashodev reports busses and controllers with a fabricated relative
number in the order encountered. Controllers are reported with the
relative number of their parent bus and their own relative controller
number. The display with uashodev is based on first walking the bus table,
recursively walking any busses attached to a bus, then walking the con-
trollers attached to a bus, and finally walking any devices attached to the
controller. The term bus is often used interchangably with controller, for
example, uaio reports scsi controllers as 'Bus#'.
EXAMPLES
Execution without kmem authority:
# uashodev
Can't open /dev/kmem (for device types)
Boot: 97/07/30 11:51:16 nugget.alaska.edu 3 cpus 190 mhz
97/08/27 17:03:26 Digital UNIX v3.2
Name lu unit dk bus target lun alive
---- -- ---- -- --- ------ --- -----
Bus 0. 0 #00:?? Slot:-1 Type:01 Connect:-1 x001
Bus 1. 1 #00:?? Slot:00 Type:19 Connect:00 x001
Bus 2. 2 #00:?? Slot:01 Type:18 Connect:00 x001
2.003 #00:?? Ctrl#00 Slot:00 x001
dev 2.003.000 | rz 0 0 0 0 0 0 x001 | rz0
dev 2.003.001 | rz 1 8 1 0 1 0 x001 | rz1
dev 2.003.002 | rz 6 48 2 0 6 0 x001 | rz6
dev 2.003.003 | rz 2 16 10 0 2 0 x001 | rz2
dev 2.003.004 | rz 3 24 11 0 3 0 x001 | rz3
Bus 4. 2 #00:?? Slot:02 Type:17 Connect:00 x001
4.005 #00:?? Ctrl#00 Slot:10 x003
4.006 #00:?? Ctrl#01 Slot:11 x003
4.007 #00:?? Ctrl#00 Slot:12 x003
4.008 #00:?? Ctrl#00 Slot:13 x003
dev 4.008.005 | fd 0 0 3 0 0 -1 x001
4.009 #00:?? Ctrl#00 Slot:02 x003
4.010 #00:?? Ctrl#00 Slot:03 x003
Bus 11. 2 #00:?? Slot:06 Type:18 Connect:00 x001
11.012 #00:?? Ctrl#01 Slot:00 x001
Bus 13. 2 #01:?? Slot:07 Type:18 Connect:00 x001
13.014 #01:?? Ctrl#02 Slot:00 x001
dev 13.014.006 | rz 17 136 4 2 1 0 x001 | rz17
dev 13.014.007 | rz 19 152 5 2 3 0 x001 | rz19
dev 13.014.008 | rz 20 161 6 2 4 1 x001 | rzb20
dev 13.014.009 | rz 20 162 7 2 4 2 x001 | rzc20
dev 13.014.010 | rz 20 163 8 2 4 3 x001 | rzd20
dev 13.014.011 | rz 18 144 9 2 2 0 x001 | rz18
Bus 15. 2 #01:?? Slot:08 Type:18 Connect:00 x001
15.016 #01:?? Ctrl#03 Slot:00 x001
1.017 #00:?? Ctrl#00 Slot:00 x001
0.018 #00:?? Ctrl#00 Slot:00 x001
Execution with kmem authority:
# sudo uashodev
sxkac@nugget: sudo ./uashodev
Boot: 97/07/30 11:51:16 nugget.alaska.edu
97/08/27 17:06:40 Digital UNIX v3.2 3 cpus 190 mhz
Device Type Ctlr Name lu unit dk bus target lun alive
------------- ---- ---- -- ---- -- --- ------ --- -----
Bus 0. 0 #00:ibus Slot:-1 Type:01 Connect:-1 x001
Bus 1. 1 #00:pci Slot:00 Type:19 Connect:00 x001
Bus 2. 2 #00:psiop Slot:01 Type:18 Connect:00 x001
2.003 #00:scsi Ctrl#00 Slot:00 x001
disk rz scsi | rz 0 0 0 0 0 0 x001 | rz0
disk rz scsi | rz 1 8 1 0 1 0 x001 | rz1
disk rz scsi | rz 6 48 2 0 6 0 x001 | rz6
disk rz scsi | rz 2 16 10 0 2 0 x001 | rz2
disk rz scsi | rz 3 24 11 0 3 0 x001 | rz3
Bus 4. 2 #00:eisa Slot:02 Type:17 Connect:00 x001
4.005 #00:ace Ctrl#00 Slot:10 x003
4.006 #00:ace Ctrl#01 Slot:11 x003
4.007 #00:lp Ctrl#00 Slot:12 x003
4.008 #00:fdi Ctrl#00 Slot:13 x003
disk fd fdi | fd 0 0 3 0 0 -1 x001
4.009 #00:vga Ctrl#00 Slot:02 x003
4.010 #00:fta Ctrl#00 Slot:03 x003
Bus 11. 2 #00:pza Slot:06 Type:18 Connect:00 x001
11.012 #00:scsi Ctrl#01 Slot:00 x001
Bus 13. 2 #01:pza Slot:07 Type:18 Connect:00 x001
13.014 #01:scsi Ctrl#02 Slot:00 x001
disk rz scsi | rz 17 136 4 2 1 0 x001 | rz17
disk rz scsi | rz 19 152 5 2 3 0 x001 | rz19
disk rz scsi | rz 20 161 6 2 4 1 x001 | rzb20
disk rz scsi | rz 20 162 7 2 4 2 x001 | rzc20
disk rz scsi | rz 20 163 8 2 4 3 x001 | rzd20
disk rz scsi | rz 18 144 9 2 2 0 x001 | rz18
Bus 15. 2 #01:psiop Slot:08 Type:18 Connect:00 x001
15.016 #01:scsi Ctrl#03 Slot:00 x001
1.017 #00:tu Ctrl#00 Slot:00 x001
0.018 #00:gpc Ctrl#00 Slot:00 x001
Execution under DU v4.0b (different system):
# sudo uashodev
Boot: 97/08/17 12:01:34 moka.sois.alaska.edu
97/08/27 17:12:09 Digital UNIX v4.0 1 cpu 125 mhz
Device Type Ctlr Name lu unit dk bus target lun alive
------------- ---- ---- -- ---- -- --- ------ --- -----
Bus 0. 0 #00:tc Slot:-1 Type:02 Connect:-1 x001
Bus 1. 1 #00:tcds Slot:04 Type:18 Connect:00 x001
1.002 #00:scsi Ctrl#00 Slot:00 x001
disk cam scsi | cam 0 0 0 0 0 0 x001 | rz0
disk cam scsi | cam 1 8 1 0 1 0 x001 | rz1
disk cam scsi | cam 2 16 2 0 2 0 x001 | rz2
disk cam scsi | cam 3 24 3 0 3 0 x001 | rz3
cdrom cam scsi | cam 4 32 -1 0 4 -1 x001
cdrom cam scsi | cam 5 40 -1 0 5 -1 x001
cdrom cam scsi | cam 6 48 -1 0 6 -1 x001
Bus 3. 1 #01:tcds Slot:01 Type:18 Connect:00 x001
3.004 #01:scsi Ctrl#01 Slot:00 x001
3.005 #01:scsi Ctrl#02 Slot:01 x001
tape cam scsi | cam 7 128 -1 2 0 -1 x001
changer cam scsi | cam 8 129 -1 2 0 -1 x001
0.006 #00:ln Ctrl#00 Slot:05 x001
0.007 #00:scc Ctrl#00 Slot:05 x001
0.008 #00:bba Ctrl#00 Slot:05 x001
0.009 #00:fb Ctrl#00 Slot:06 x001
Execution under DU v4.0b on a system with a swxcr:
# sudo uashodev
Boot: 97/08/22 23:38:08 pharos.dgim.doc.ca
97/09/15 13:15:36 Digital UNIX v4.0 2 cpus 190 mhz
Device Type Ctlr Name lu unit dk bus target lun alive
------------- ---- ---- -- ---- -- --- ------ --- -----
Bus 0. 0 #00:ibus Slot:-1 Type:01 Connect:-1 x001
Bus 1. 1 #00:pci Slot:00 Type:19 Connect:00 x001
Bus 2. 2 #00:psiop Slot:01 Type:18 Connect:00 x001
2.003 #00:scsi Ctrl#00 Slot:00 x001
disk cam scsi | cam 0 0 8 0 0 0 x001 | rz0
tape cam scsi | cam 1 8 -1 0 1 -1 x001
tape cam scsi | cam 2 16 -1 0 2 -1 x001
changer cam scsi | cam 3 24 -1 0 3 -1 x001
disk cam scsi | cam 4 32 9 0 4 0 x001 | rz4
cdrom cam scsi | cam 5 40 -1 0 5 -1 x001
Bus 4. 2 #00:eisa Slot:02 Type:17 Connect:00 x001
4.005 #00:ace Ctrl#00 Slot:10 x001
4.006 #00:ace Ctrl#01 Slot:11 x001
4.007 #00:lp Ctrl#00 Slot:12 x001
4.008 #00:fdi Ctrl#00 Slot:13 x001
disk fd fdi | fd 0 0 0 0 0 -1 x001
4.009 #00:qvision Ctrl#00 Slot:01 x001
4.010 #00:xcr Ctrl#00 Slot:02 x001
disk re xcr | re 0 0 1 0 0 0 x001 | re0
disk re xcr | re 1 1 2 0 0 0 x001 | re1
4.011 #00:xcr Ctrl#01 Slot:03 x001
disk re xcr | re 8 8 3 0 1 0 x001 | re8
disk re xcr | re 9 9 4 0 1 0 x001 | re9
disk re xcr | re 10 10 5 0 1 0 x001 | re10
disk re xcr | re 11 11 6 0 1 0 x001 | re11
disk re xcr | re 12 12 7 0 1 0 x001 | re12
RELATED INFORMATION
Commands: uaio(8).