man 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 fnkac@uaf.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).