unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



hwmgr_show(8)							hwmgr_show(8)



NAME

  hwmgr_show - Displays	information from hardware subsystems

SYNOPSIS

  /sbin/hwmgr show [component  | name  | scsi] [subsystem-specific-options]

OPTIONS

  show component
      Displays hardware	component information from the hardware	component
      subsystem. This includes all hardware components,	including those	that
      were previously registered but are not currently registered.

      The show component command returns a FLAGS field as part of the output.
      The FLAGS	field is a series of characters	that provide information on
      the state	of a hardware component.  The following	characters are used:

      r	  The component	is currently registered	with hardware management.

      d	  The component	has device special files associated with it.

      c	  The component	has a cluster wide unique name.

      s	  The component	has saved attributes associated	with it	in the on-
	  disk hardware	database.

      i	  A warning that this component	has an inconsistency in	the hardware
	  component database.

      You can specify the following additional options with the	hwmgr show
      command to control the output:

      -registered
	  Shows	all hardware components	that are currently registered with
	  hardware management.

      -nregistered
	  Shows	all hardware components	that are not currently registered
	  with hardware	management. These components were previously
	  registered.

      -cshared
	  Shows	all hardware components	that are cluster shared.  A cluster
	  shared hardware component is a hardware component that has a name
	  which	is guaranteed to be unique anywhere in the cluster.

      -ncshared
	  Shows	all hardware components	that are NOT cluster shared. See the
	  -cshared flag	for a definition of cluster shared.

      -devnodes
	  Shows	all hardware components	that have device special files asso-
	  ciated with them.

      -ndevnode
	  Shows	all hardware components	that do	not have device	special	files
	  associated with them.

      -savedattr
	  Shows	all hardware components	that have saved	attributes. See	the
	  hwmgr	get command option for a description of	saved attributes.

      -nsavedattr
	  Shows	all hardware components	that do	NOT have saved attributes.
	  See the hwmgr	get command option for a description of	saved attri-
	  butes.

      -inconsistencies
	  Shows	all hardware components	that have software inconsistencies in
	  the hardware component database.  An inconsistency is	a possible
	  internal error with the component database.  Use the show -full
	  command option to obtain detailed information	of possible problems.

	  This command does not	fix database inconsistencies; it only detects
	  inconsistencies.  One	possible fix might be to reboot	the cluster.

      -ninconsistencies
	  Shows	all hardware components	with no	software inconsistencies.

      -full
	  Shows	detailed information on	the hardware component.

      -output output-format
	  Displays output from the show	command	option in an alternate for-
	  mat. The tcl format is the only alternate format supported in	this
	  release.

      -member cluster-member-name
	  Specifies a cluster member on	which you want to perform the hwmgr
	  show operation.

      -cluster
	  Specifies that the operation be performed on every member of the
	  cluster.  This option	is valid only when the system is a cluster
	  member.

      -id hardware-component-ID
	  Specifies the	hardware identifier (HWID) for the component on	which
	  you want to perform the show operation.

      If no member ID is specified and the -cluster option was not used, the
      show operation defaults to the local cluster member.

  show name
      Shows information	from the name subsystem, which maintains the on-disk
      database.	This database is used to preserve the names of most hardware
      components. For example, pci0 and	tu3. This operation defaults to	the
      local system if you do not specify a cluster member.

      -member cluster-member-name
	  Specifies a cluster member on	which to perform the show operation.

  show scsi
      Shows information	from the SCSI subsystem. You can specify the follow-
      ing options with the hwmgr show scsi command:

      -id hardware-component-ID
	  Shows	SCSI information for only the component	specified by the
	  hardware component identifier.

      -did scsi-device-ID
	  Shows	SCSI information for the component specified by	the SCSI dev-
	  ice identifier (did).	 The did is a specific identifier used by the
	  SCSI subsystem, and differs from the hardware	identifier (HWID).

      -bus scsi-bus
	  Shows	any SCSI entries with a	path (valid or stale) at the speci-
	  fied bus. A stale path occurs	when a component that was previously
	  seen at a path is no longer accessible at that path.

      -target scsi-target
	  Shows	any SCSI entries at the	specified target.

      -lun scsi-lun
	  Shows	any SCSI entries at specified lun (logical unit	number).

      -member cluster-member-name
	  Specifies a cluster member on	which to perfom	the show operation.
	  This operation defaults to the local system if no cluster member
	  identifier is	specified and you do not specify a cluster member.

      -type SCSI-device-type
	  Specifies a SCSI device type,	such as	disk or	tape. SCSI device
	  types	are specified in the SCSI standards that the operating system
	  supports. Supported standards	and restrictions are defined in	the
	  Quick	Specs.

      -active
	  Specifies that only SCSI components with valid paths be displayed.
	  If a component can be	accessed, the path is valid.

      -stale
	  Specifies that only SCSI components with stale paths be displayed.
	  A path becomes stale when a component	that was previously seen at a
	  path is no longer accessible at that path.

      -full
	  Specifies that if detailed information on a component	is available,
	  that data be displayed.

DESCRIPTION

  The commands described in this reference page	are a subset of	the command
  options available from the hwmgr utility. Refer to hwmgr(8) for more infor-
  mation.

  Hardware subsystems maintain on-disk databases that contain information
  about	components. You	use the	hwmgr show command options to display infor-
  mation from the following hardware subsystems:

  component subsystem
      The component subsystem maintains	information on all hardware devices
      specified	in the binary /etc/dec_hwc_ldb and /etc/dec_hwc_cdb data-
      bases. These databases contain information on all	hardware components.
      This includes most devices on a system.

  name subsystem
      The name subsystem maintains information on all hardware components in
      the binary /etc/dec_hw_db	database, often	referred to as the hardware
      topology.	The database contains hardware name persistence	information
      that is maintained by the	kernel driver framework	and includes data for
      most buses, controllers, and devices.

  scsi subsystem
      The scsi subsystem maintains information on all SCSI devices in the
      binary /etc/dec_scsi_db database.

  You use the information obtained from	the subsystems as parameters to	other
  hwmgr	operational commands that you use to manage devices and	subsystems.
  Refer	to the following pages for information on related commands:

    +  hwmgr_view(8) - Describes commands that enable you to display informa-
       tion about the status of	the system and its hardware components.

    +  hwmgr_get(8) - Describes	commands that enable you to display (get) or
       configure (set) component attributes such as the	capacity of a hard
       disk or the speed of a CPU. You can also	display	component category
       names.

    +  hwmgr_ops(8) - Describes	commands that enable you to perform adminis-
       trative tasks on	hardware components, such as scanning buses, locating
       components, powering off	components, and	deleting components.

  See the System Administration	guide for more information on device names
  and device special files and a definitive list of the	supported device
  names.  You can run some hwmgr commands directly from	the SysMan Menu, and
  monitor components by	using the SysMan Station.

RESTRICTIONS

  The following	notes and restrictions apply:

  When working on a cluster, if	you do not specify a member name the opera-
  tion defaults	to the local member.

ERRORS

  The command returns an int with an errorno from <&lt;errno.h>&gt;.

EXAMPLES

  These	examples have been reformatted for ease	of reference.  The actual
  formatted output from	commands is slightly different.

   1.  Use the following command to display SCSI information for all the
       disks in	your system:


	    # /sbin/hwmgr show scsi -type disk
		   SCSI		    DEVICE  DEVICE  DRIVER NUM	DEVICE FIRST
	    HWID: DEVICEID HOSTNAME TYPE    SUBTYPE OWNER  PATH	FILE   VALID PATH
	    ---------------------------------------------------------------------
	     32:  0	   cymro    disk    none    2	   1	dsk0   [0/0/0]
	     34:  2	   cymro    disk    none    0	   1	dsk1   [0/5/0]
	     35:  3	   cymro    disk    none    0	   1	dsk2   [0/6/0]
	     36:  4	   cymro    disk    none    2	   1	dsk3   [0/8/0]


   2.  Use the following command to display the	hardware persistence entries
       from the	name subsystem.:


	    # /sbin/hwmgr show name
	     HWID:  NAME    HOSTNAME   PERSIST TYPE    PERSIST AT
	    -----------------------------------------------------
	       59:  aha0    psychlo    BUS	       eisa0 slot 3
	       52:  isp1    psychlo    BUS	       pci0 slot 13
	       14:  isp0    psychlo    BUS	       pci0 slot 5
		5:  pci0    psychlo    BUS	       nexus
	       53:  scsi1   psychlo    CONTROLLER      isp1 slot 0
	       15:  scsi0   psychlo    CONTROLLER      isp0 slot 0
	       42:  tu1	    psychlo    CONTROLLER      pci0 slot 12
	       30:  tu0	    psychlo    CONTROLLER      pci0 slot 11

   3.  The following command displays the components that have associated
       device special files. This information comes from the component sub-
       system:


	    # /sbin/hwmgr show component -devnodes

	     HWID: HOST	  FLAGS	SERVICE	COMPONENT NAME
	    -----------------------------------------------
	      3:   pmoba  r-d--	none	kevm
	     20:   pmoba  r-d--	none	tty00
	     22:   pmoba  r-d--	none	tty01
	     24:   pmoba  r-d--	none	lp0
	     27:   pmoba  r-d--	iomap	FDI-fdi0-unit-0
	     35:   pmoba  rcd--	iomap	SCSI-WWID:0410004c:"DEC	RZ28 0034766791"
	     36:   pmoba  rcd--	iomap	SCSI-WWID:04100024:"DEC	RZ25F  14295981"
	     37:   pmoba  r-d--	iomap	SCSI-WWID:0710002c:"DEC	RRD43	6l00000"
	     38:   pmoba  r-d--	iomap	SCSI-WWID:0710002c:"DEC	TLZ06  04l00000"
	     40:   pmoba  --d--	iomap	SCSI-WWID:0710002c:"DEC	RX26	0l00000"
	     42:   pmoba  rcd--	iomap	SCSI-WWID:0410004c:"DEC	RZ26L	 574435"
	     43:   pmoba  rcds-	iomap	SCSI-WWID:0410003a:"DEC	RZ26L	2191192"

       To see more information on the device special file, such	as the dev_t
       information, you	can use	the -full option with the show component com-
       mand, as	follows:


	    # /sbin/hwmgr show component -id 3 -full

	    HWID:  HOSTNAME   FLAGS SERVICE COMPONENT NAME
	    -----------------------------------------------
		3:  pumba      r-d-- none    kevm

	      DSF GROUP
	      INSTANCE GRPFLAGS	GROUPID	SUBSYSTEM BASENAME L1	  L2
	      ---------------------------------------------------------
	      0	       40	1	kevm	  kevm	   pseudo kevm

	      DEVICE NODE
	      ID  LB	LC    CB    CC	 B     C     Class Suffix L3B	 L3C
		  devT	devT  devT  devT Flags Flags
	      ---------------------------------------------------------------
	      0	  0  4f00000  0	   0	0x0   0x865 0x0	 (null)	(null) (null)
	      2	  0  4f00002  0	   0	0x0   0x865 0x0	 .pterm	(null) (null)
	      1	  0  4f00001  0	   0	0x0   0x875 0x0	 .debug	(null) (null)


       This example shows the device special file basename of pseudo device
       kevm.  It also shows the	device special file and	dev_t information.

   4.  Use the following command to display information	from the SCSI subsys-
       tem:


	    # /sbin/hwmgr show scsi

		   SCSI		 DEVICE	DEVICE DRIVER NUM  DEVICE FIRST
	    HWID:  DID	HOSTNAME TYPE  SUBTYPE OWNER  PATH FILE	  VALID	PATH
	    ---------------------------------------------------------------
	     22:   0	ftiwod	 disk	none   2      1	   dsk0	  [0/3/0]
	     23:   1	ftiwod	 cdrom	none   0      1	   cdrom0 [0/4/0]
	     24:   2	ftiwod	 disk	none   0      1	   dsk1	  [2/2/0]
	     25:   3	ftiwod	 disk	none   0      1	   dsk2	  [2/2/1]
	     29:   4	ftiwod	 disk	none   0      1	   scp2	  [2/2/2]

       To view all the paths to	a particular SCSI device you can use the -
       show scsi -full option, as follows:


	    # /sbin/hwmgr show scsi -full -id 43

		  SCSI		DEVICE DEVICE DRIVER NUM  DEVICE FIRST
	    HWID: DID HOSTNAME	TYPE  SUBTYPE OWNER  PATH FILE	 VALID PATH
	    ----------------------------------------------------- ---------
	    43:	  7   pmoba    disk   none    0	     2	  dsk3	 [0/2/0]

		 WWID:0410003a:"DEC  RZ26L (C) DECPCB=	; HDA=000052191192"


		  BUS	TARGET	LUN   PATH STATE
		  ------------------------------
		  1	2	0     stale
		  0	2	0     valid




FILES

  See hwmgr(8).

SEE ALSO

  Commands: dsfmgr(8), hwmgr_view(8), hwmgr_get(8), hwmgr_ops(8), sysman(8),
  sysman_station(8)

  Files: olar_config(4)

  Misc:	OLAR_intro(5)

  System Administration, , Managing Online Addition and	Removal