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_view(8)							hwmgr_view(8)



NAME

  hwmgr_view - Displays	information about the status of	the system and its
  hardware components

SYNOPSIS

  /sbin/hwmgr view cluster

  /sbin/hwmgr view devices [-dsf device-special-filename] [-category
  hardware-category] [-member cluster-member-name] [-cluster]

  /sbin/hwmgr view environment

  /sbin/hwmgr view hierarchy [-id hardware-component-id	[-instance
  component-instance]] [-member	cluster-member-name]

  /sbin/hwmgr view timestamps [-reverse] [-a timestamp-attribute...] [-a
  timestamp-attribute=time] [-id hardware-component-id]	[-category hardware-
  category] [-member cluster-member-name] [-cluster]

  /sbin/hwmgr view transaction [-member	cluster-member-name] [-cluster]

OPTIONS

  The following	options	are available:

  view cluster
      Displays information on the state	of each	cluster	member.	This command
      is useful	only in	a cluster environment.

  view devices
      Displays all devices.  All devices on the	local host are returned	by
      default, unless you also specify one of the following options:

      -category	hardware-category
	  Specifies a hardware category, such as disk or tape on which to
	  perform the operation. Use the hwmgr get catergory command option
	  to display a list of available devices.

      -dsf device-special-filename
	  Specifies the	device special file for	a particular device.  You can
	  obtain the device special file name by using the hwmgr show comp
	  -full	command	option (see the	DSF GROUP) or the hwmgr	show scsi
	  command option.

      -cluster
	  Specifies that the operation be performed cluster-wide.  If this
	  option is not	specified, data	for the	local host is returned.

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

      For the purpose of this command, a device	is considered to be any	item
      of hardware that has the dev_base_name attribute.

  view env
      Displays the internal Hardware Manager (hwmgr) environment variable
      settings,	which you can set in your environment configuration file such
      as your .profile file. Refer to hwmgr(8) for information.

  view hierarchy
      Displays the current hardware component hierarchy. If no cluster member
      name is specified	this operation defaults	to the local system.

      -id hardware-component-ID
	  Displays the hierarchy from the specified component downwards.
	  Specify a hardware identifier	(HWID).

      -inst component-instance
	  Specifies an instance	of a hardware component. Some components
	  might	be in the hierarchy in more than one place.  For example,
	  SCSI disks on	a shared bus might be seen in the hierarchy under two
	  buses.  Each entry for the component in the hierarchy	is considered
	  a different instance.

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

      The display hierarchy command displays the currently registered
      hardware components which	have been placed in the	system hierarchy.
      Components that have a flagged status are	identified in the command
      output by	the following codes:

	+  (!) warning

	+  (X) critical

	+  (-) inactive

      Refer to the description of the hwmgr status component command option
      for an explanation of these codes.

  view timestamp
      Displays time stamp attributes for a component, such as its registra-
      tion time	or the time that the most recent event was posted. You can
      specify the following additional options:

      -reverse
	  Specifies that you want to display the data in reverse chronologi-
	  cal order

      -a timestamp attribute=
	  Specifies that you want to display only timestamps that have the
	  stated attribute. Valid attributes are: registration_time,
	  start_stop_time, last_event_time, and	access_state_change.

      -atimestamp attribute=time
	  Specifies that you want to find a specific attribute and value
	  pair.	Valid attributes are: registration_time, start_stop_time,
	  last_event_time, and access_state_change.

      -id Specifies that you want to display timestamps	for a particular com-
	  ponent.  You must supply a HWID for the component, which you can
	  obtain by using the hwmgr show comp command

      -categoryhardware-category
	  Specifies that you want to display timestamps	for a particular
	  category of component. You can obtain	a list of categories that are
	  available on the system by using the hwmgr get category command

      -membercluster-member-name
	  Specifies the	cluster	member on which	you want to perform the
	  operation.

      -cluster
	  Specifies that you want to perform the operation on all members of
	  the cluster

  view transaction
      Displays information on the transactions that the	hardware management
      kernel code uses to perform some requests, including the status of:

	+  The current hardware	management transactions, if any

	+  The last hardware management	transaction that was completed

DESCRIPTION

  The commands described in this reference page	are a subset of	the command
  options available from the hwmgr utility. See	hwmgr(8) for an	overview of
  the commands.

  Use the hwmgr	view command option to display information about the status
  of the system	and its	hardware components. Refer to the following pages for
  information on related commands:

    +  hwmgr_show(8) - Describes commands that enable you to display informa-
       tion from hardware subsystems.

    +  hwmgr_get(8) - Describes	commands that enable you to display (get) or
       configure (set) component attributes and	identify 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	manual for more	information on component
  names	and device special files and a definitive list of the supported	dev-
  ice names.  You can run some hwmgr commands directly from the	SysMan Menu.
  You can also monitor many properties and attributes of components by using
  the the SysMan Station GUI.

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. Some command options might	require	that
  you specify a	member name, but in general it is an option.

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 might be slightly different.

   1.  If your system is a member of a cluster,	use the	hwmgr utility to send
       hardware	management requests to any node	in the cluster.	 Use the fol-
       lowing command to determine the current state of	each member of the
       cluster:


	    # /sbin/hwmgr view cluster


		    Member ID	     State    Member HostName
		    ---------	     -----    ---------------
			 1	       UP	  rene (localhost)
			31	       UP	  witt
			24	       UP	  freu
			10	       UP	  rogr

   2.  The following example displays devices on the system:


	    # /sbin/hwmgr view devices
	    HWID: Device Name	    Mfg	     Model	      Location
	    -------------------------------------------------------------------
	     4:	/dev/kevm
	    29:	/dev/disk/floppy0c	      3.5in floppy     fdi0-unit-0
	    32:	/dev/disk/dsk1c	    DEC	     RZ26L    (C) DEC  bus-0-targ-1-lun-0
	    36:	/dev/disk/dsk4c	    DEC	     RZ1DF-CB (C) DEC  bus-0-targ-11-lun-0
	    45:	/dev/disk/dsk3c	    COMPAQ   HB00931B93	       bus-0-targ-6-lun-0
	    46:	/dev/disk/cdrom1c   DEC	     RRD47   (C) DEC   bus-0-targ-4-lun-0
	    64:	/dev/dmapi/dmapi
	    66:	/dev/disk/dsk16c    COMPAQ   HB00931B93	       bus-0-targ-3-lun-0

       The information shown in	the output is as follows:

       HWID
	   The cluster-wide unique hardware identifier (integer) assigned to
	   the device

       Device Name
	   The device special file name	for the	device

       Mfg The manufacturer of the device, if provided

       Model
	   The vendor's	model number, as shown on the device or	its enclosure

       Location
	   The physical	location of the	device as defined by the operating
	   system

       In the preceding	example, no tape device	is present and the following
       command returns no data:


	    # /sbin/hwmgr view devices -cat tape

   3.  The following example displays all devices on a cluster:


	    # /sbin/hwmgr view devices -cluster
	    HWID: Device Name	  Mfg Model	      Host  Location
	    --------------------------------------------------------
	     3:	/dev/kevm			      jully
	    28:	/dev/disk/floppy0c    3.5in floppy    jully fdi0-unit-0
	    40:	/dev/disk/dsk0c	  DEC RZ28M    (C)DEC jully bus-0-targ-0-lun-0
	    41:	/dev/disk/dsk1c	  DEC RZ28L-AS (C)DEC jully bus-0-targ-1-lun-0
	    42:	/dev/disk/dsk2c	  DEC RZ28     (C)DEC jully bus-0-targ-2-lun-0
	    43:	/dev/disk/cdrom0c DEC RRD46    (C)DEC jully bus-0-targ-6-lun-0
	    44:	/dev/disk/dsk3c	  DEC RZ28M    (C)DEC phoey bus-1-targ-1-lun-0
	    45:	/dev/disk/dsk4c	  DEC RZ28L-AS (C)DEC jully bus-1-targ-2-lun-0
	    45:	/dev/disk/dsk4c	  DEC RZ28L-AS (C)DEC phoey bus-1-targ-2-lun-0
	    46:	/dev/disk/dsk5c	  DEC RZ29B    (C)DEC jully bus-1-targ-3-lun-0
	    46:	/dev/disk/dsk5c	  DEC RZ29B    (C)DEC phoey bus-1-targ-3-lun-0
	    47:	/dev/disk/dsk6c	  DEC RZ28D    (C)DEC jully bus-1-targ-4-lun-0
	    47:	/dev/disk/dsk6c	  DEC RZ28D    (C)DEC phoey bus-1-targ-4-lun-0
	    48:	/dev/disk/dsk7c	  DEC RZ28L-AS (C)DEC jully bus-1-targ-5-lun-0
	    48:	/dev/disk/dsk7c	  DEC RZ28L-AS (C)DEC phoey bus-1-targ-5-lun-0
	    49:	/dev/disk/dsk8c	  DEC RZ1CF-CF (C)DEC jully bus-1-targ-8-lun-0
	    49:	/dev/disk/dsk8c	  DEC RZ1CF-CF (C)DEC phoey bus-1-targ-8-lun-0
	    50:	/dev/disk/dsk9c	  DEC RZ1CB-CS (C)DEC jully bus-1-targ-9-lun-0
	    .
	    .
	    .

   4.  The following command enables you to display device information about
       a particular component by specifying its	device special file:


	    # /sbin/hwmgr view devices -dsf /dev/disk/cdrom0
	     HWID:	DSF Name     Mfg  Model	      Location
	     --------------------------------------------------------
	      31:  /dev/disk/cdrom0c DEC  RRD47(C)DEC bus-0-targ-4-lun-0

   5.  The following example command displays the component hierarchy:


	    # /sbin/hwmgr view hierarchy
	    HWID: Hardware component hierarchy
	    ----------------------------------------------
	       1: platform AlphaServer 800 5/500
	       2:   cpu	CPU0
	       4:   bus	pci0
	       5:     scsi_adapter isp0
	       6:	scsi_bus scsi0
	      18:	  disk bus-0-targ-0-lun-0 dsk0
	      19:	  disk bus-0-targ-4-lun-0 cdrom0
	      20:     graphics_controller trio0
	       8:     bus eisa0
	       9:	serial_port tty00
	      10:	serial_port tty01
	      11:	parallel_port lp0
	      12:	keyboard PCXAL
	      13:	pointer	PCXAS
	      14:	fdi_controller fdi0
	      15:	  disk fdi0-unit-0 floppy0
	      16:     network tu0
	      17:     network tu1

       If a component has a status other than good, a status code appears
       next to its entry in the	command	output,	and the	following code defin-
       ition string is appended	to the header: (!) warning (X) critical	(-)
       inactive	(see -status).

   6.  The following example displays the hwmgr	command	environment variable
       settings:


	    # /sbin/hwmgr view env
	    HWMGR_DATA_FILE = "/etc/hwmgr/hwmgr.dat"
	    HWMGR_DEBUG	= FALSE
	    HWMGR_HEXINTS = FALSE
	    HWMGR_NOWRAP = FALSE
	    HWMGR_VERBOSE = FALSE

   7.  The following example displays all timestamps for all hardware com-
       ponents registered on a small standalone	system:


	    # hwmgr view timestamps

	     HWID:  Component	  Attribute Name  Hostname  Time occurred
	    ------------------------------------------------------------
	     1:	 AlphaServer 80	registration_time  cy1.k3. time
	     2:	 CPU0		registration_time  cy1.k3. time
	     3:	 kevm		registration_time  cy1.k3. time
	     4:	 pci0		registration_time  cy1.k3. time
	     5:	 pci0slot5	registration_time  cy1.k3. time
	     7:	 pci0slot6	registration_time  cy1.k3. time
	     9:	 pci0slot7	registration_time  cy1.k3. time
	    (truncated)

       In the preceding	output,	the time is displayed as weekday month date
       HH:MM:SS	year. For example: Sat May 15 14:42:18 1999.

   8.  The following example displays the transaction information for the
       local host:


	    #  /sbin/hwmgr view	trans
	    hardware management	transaction status
	    -----------------------------------------------------------
	    there is no	active transaction on this system
	      the last transaction initiated from this system was:
		transaction = general tx lock
		proposal    = 3835
		sequence    = 0
		status	    = 0
	      the last transaction processed by	this system was:
		transaction = general tx lock
		proposal    = 3835
		sequence    = 0
		status	    = 0

	    proposal			  last status  success	fail
	    ----------------------------  -----------  -------	-------
		       Lock member/ 3847  0	       85	0
			Modify CDB/ 3838  0	       4	0
			  Read CDB/ 3834  0	       1	0
		      No operation/ 3835  0	       89	0
		Change name - lock/ 3836  0	       0	0
	      Change name - commit/ 3837  0	       0	0
			    Locate/ 3832  0	       0	0
			      Scan/ 3801  0	       0	0
	     Unconfigure - confirm/ 3933  0	       0	0
	      Unconfigure - commit/ 3934  0	       0	0
		  Delete - confirm/ 3925  0	       0	0
		   Delete - commit/ 3926  0	       0	0
		Redirect - confirm/ 3928  0	       0	0
		Redirect - commit1/ 3929  0	       0	0
		Redirect - commit2/ 3930  0	       0	0
		    Refresh - lock/ 3937  0	       0	0
		   Change basename/ 3938  0	       10	0
			  Unindict/ 3841  0	       0	0
			    Indict/ 3840  0	       0	0






FILES

  See hwmgr(8) for more	information.

SEE ALSO

  Commands: dop(8), dsfmgr(8), hwmgr_show(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