hwmgr_get man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

hwmgr_get(8)							  hwmgr_get(8)

NAME
       hwmgr_get,   hwmgr_set  -  Commands  that  display  and	set  component
       attributes and display component category names

SYNOPSIS
       /sbin/hwmgr get category

       /sbin/hwmgr get attribute [saved | default | current] [-a attribute...]
       [-a  attribute=value] [-a attribute!=value] [-id hardware-component-id]
       [-category hardware-category] [-member cluster-member-name] [-cluster]

       /sbin/hwmgr set attribute [saved	 |  current]  -a  attribute=value  [-a
       attribute=value]...  [-id  hardware-component-id] [-member cluster-mem‐
       ber-name] [-cluster]

OPTIONS
       Displays a list of all hardware component category names	 available  on
       the  system,  such as platform, scsi_bus, and disk.  Displays attribute
       values for a component. You can specify	the  component	attributes  to
       return,	according  to  their  type  and	 one or more optional matching
       parameters. An attribute can have up to three values: The value	of  an
       attribute  that	is configured and stored in the database using the set
       saved command option. When you set the saved value of an attribute,  it
       is  saved  across boots and is used on subsequent reboots.  The default
       value of an unmodified attribute. When you add a new component and boot
       the  system,  the  attributes of the new component are at their default
       values.	The value of the attribute that the driver is currently	 using
       in its operation of the component. If you set an attribute by using the
       set current option, the saved value is unchanged. When  you  shut  down
       and  reboot the system, the value of the attribute reverts to the value
       saved in the database. If you want the value you are using  to  persist
       across  boots,  you  must use the set saved option. The get option dis‐
       plays the current values by default.

	      Not all attributes have a current,  saved,  and  default	value.
	      Most  component  attributes have read-only values and you cannot
	      set them. Typically, you are able to set only a  few  attributes
	      for  the	specified component. In most cases, if an attribute is
	      settable it also has a saved value. You can specify  this	 saved
	      value and the system uses the value on the next reboot.

	      Settable	attributes  are marked (settable) when you use the get
	      attribute option.	 The  following	 truncated  display  shows  an
	      example:

	      #	 /sbin/hwmgr  get attribute path_fail_limit = 5 device_starva‐
	      tion_time = 25 (settable) cluster_disables = 0

	      For each attribute value (saved, default, or  current)  you  can
	      specify the following optional parameters: Displays the value of
	      an individual attribute, such as	path_fail_limit,  which	 is  a
	      SCSI  disk attribute defining the limit for path failures.  Dis‐
	      plays attributes that match the specified name and the specified
	      value.  For example, to search for components that support power
	      management,  use	the  following	command:  #  /sbin/hwmgr   get
	      attribute	 -a  power_mgmt_capable=1  Displays attributes that do
	      not match the specified name and	do  not	 match	the  specified
	      value.   For   example:	#   /sbin/hwmgr	  get	attribute   -a
	      power_mgmt_capable!=1 Displays  the  attribute  values  for  the
	      specified	 hardware  device  identifier (HWID). For example, the
	      following command displays all the current attribute values  for
	      hardware	component  18: # /sbin/hwmgr get attribute current -id
	      18 Specifies a hardware category, such as bus or ide_adapter  on
	      which  to	 perform  the operation. You can display the available
	      category names by using the get category option.	Specifies  the
	      host name of a cluster member on which to perform the operation.
	      Specifies that the operation be performed clusterwide.  If  this
	      option  is  not  specified, data for the local host is returned.
	      Sets either the saved or current value for one or	 more  of  the
	      specified	 attribute(s). Refer to the get option for more infor‐
	      mation.  You cannot set default attribute values.

	      You can specify the following parameters:	 You  must  supply  at
	      least  one  attribute and a value. Specify additional attributes
	      to set as required, subject to limitations on the command	 input
	      buffer.	Specifies  a  hardware	component identifier (HWID) on
	      which to perform the operation.  Specifies the host  name	 of  a
	      cluster  member  on  which  to perform the operation.  Specifies
	      that the operation be performed clusterwide.  If the  system  is
	      part  of	a cluster and this option is not specified, the opera‐
	      tion is performed only on the local host.

	      The values of the attributes of a particular hardware  component
	      might not be the same for each member of the cluster.  One hard‐
	      ware component may have different attributes, or different  val‐
	      ues for the same attributes, for each cluster member.

					  Caution

	      Always  specify a hardware identifier when setting an attribute.
	      Failure to specify an identifier causes your  setting  to	 apply
	      too   all	  hardware   components	 that  support	the  specified
	      attribute.

DESCRIPTION
       The commands described in this reference page are a subset of the  com‐
       mand  options  available	 from the hwmgr utility. Refer to hwmgr(8) for
       more information.

       Use these commands to: Display or set the values of  various  component
       attributes.   A component attribute is a physical or logical character‐
       istic of a component that you might need to obtain, or set,  to	manage
       the  component.	For  example,  a  hard	disk  might  support  a set of
       attributes that define its power	 management  capabilities.  To	better
       manage  power  use  on your system, you can review the current value of
       these attributes and possibly set them to different values.   Obtain  a
       list of all hardware component category names that are available on the
       system. You might need this information as input to  other  hwmgr  com‐
       mands.

       The  get and set command options for the hwmgr command are used in con‐
       junction with the command options described  in	the  following	pages:
       hwmgr_view(8)  - Describes commands that enable you to display informa‐
       tion about the status  of  the  system  and  its	 hardware  components.
       hwmgr_show(8)  - Describes commands that enable you to display informa‐
       tion from the hardware component databases.  hwmgr_ops(8) -   Describes
       commands	 that  enable  you to perform administrative tasks on hardware
       components, such as scanning buses, locating components,	 powering  off
       components, and deleting components.

       See  the	 Hardware  Management manual for more information about compo‐
       nents, device special files, and a definitive  list  of	the  supported
       device  names.	This manual provides further examples of hwmgr command
       usage and common procedures.

       You can run some hwmgr commands directly from the SysMan Menu. You  can
       also  monitor many properties and attributes of components by using the
       SysMan Station GUI. See the System Administration manual	 for  informa‐
       tion about these interfaces.

RESTRICTIONS
       When  working  on  a  cluster,  if you do not specify a member name the
       operation defaults to the local	member.	 Some  command	options	 might
       require that you specify a member name, but in general a member name is
       optional.

ERRORS
       The command returns an int with an errorno from <errno.h>.

EXAMPLES
       These examples have been reformatted for ease of reference.  The actual
       formatted  output  from	commands is slightly different.	 The following
       command shows partial output of all attributes for  all	components  on
       the system:

	      # /sbin/hwmgr get attribute 1:
		name = AlphaServer 800 5/500
		category = platform
		memory_size_MB = 256
		registration_time = Mon May 14 11:11:04 2001
		user_name = (null) (settable)
		location = (null) (settable)
		software_module = (null)
		state = available
		state_previous = unknown
		state_change_time = none
		event_count = 0
		last_event_time = none
		access_state = online
		access_state_change_time = none
		capabilities = 0
		indicted = 0
		indicted_probability = (null)
		indicted_urgency = (null)
		disabled = 0 <long display output truncated>

	      You can display information for specific devices by specifying a
	      hardware identifier (HWID), as shown in the following example:

	      # /sbin/hwmgr get attribute -id 4 4:
		name = pci0
		category = bus

	      You can display information about attribute values by specifying
	      attributes, as follows:

	      # /sbin/hwmgr get attribute -a name -id 4 4:
		name  = pci0 The following command displays the hardware cate‐
	      gory names found on the local system:

	      # /sbin/hwmgr get cat

	      Hardware Categories  -------------------	category  =  undefined
	      category	= platform category = cpu category = pseudo category =
	      bus category = connection category = unconfigured_hardware cate‐
	      gory = scsi_adapter category = scsi_bus category = graphics_con‐
	      troller category = parallel_port category = keyboard category  =
	      pointer  category	 =  fdi_controller  category = disk category =
	      network

	      The following example shows how  you  set	 attributes  that  are
	      flagged  as  (settable)  in  the output from the /sbin/hwmgr get
	      attribute command:

	      # /sbin/hwmgr get attr saved -id	18  -a	device_starvation_time
	      18:
		saved device_starvation_time = 25 (settable) # /sbin/hwmgr set
	      attr saved -id 18 -a device_starvation_time=30 18:
		saved device_starvation_time = 30

	      The  first  command   displays   the   saved   attribute	 named
	      device_starvation_time  for device id 18, a hard disk.  The sec‐
	      ond command increases the saved value from 25 to 30.  Having set
	      one of a component's settable attributes, as shown in Example 3,
	      you can use the following command to display its default or cur‐
	      rent  value as follows: # /sbin/hwmgr get attr default -id 18 -a
	      device_starvation_time 18:
		default device_starvation_time = 25  #	/sbin/hwmgr  set  attr
	      current -id 18 -a device_starvation_time=30 18:
		device_starvation_time = 30 (settable)

FILES
       See hwmgr(8) for a list of data files.

SEE ALSO
       Commands:     dop(8),	dsfmgr(8),    hwmgr_view(8),	hwmgr_show(8),
       hwmgr_ops(8), sysman(8), sysman_station(8)

       Files: olar_config(4)

       Misc: olar_intro(5)

       Hardware Management,  Managing  Online  Addition	 and  Removal,	System
       Administration

								  hwmgr_get(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net