hwmgr_get, hwmgr_set - Commands that display and set component
attributes and display component category names
/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-member-name] [-cluster]
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 displays the current values
by default.
Not all attributes have a current, saved, and
default value. Most component attributes have readonly
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_starvation_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. Displays 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
information. 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 operation
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 hardware component may
have different attributes, or different values 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.
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 information.
Use these commands to: Display or set the values of various
component attributes. A component attribute is a
physical or logical characteristic 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 commands.
The get and set command options for the hwmgr command are
used in conjunction with the command options described in
the following pages: hwmgr_view(8) - Describes commands
that enable you to display information about the status of
the system and its hardware components. hwmgr_show(8) -
Describes commands that enable you to display information
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 components, 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 information about these
interfaces.
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.
The command returns an int with an errorno from <errno.h>.
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 category 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 category =
scsi_adapter category = scsi_bus category = graphics_controller
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 second 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 current 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)
See hwmgr(8) for a list of data files.
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)
[ Back ] |
