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)