 |
Index for
Section 8 |
|
 |
Alphabetical
listing for H |
|
 |
Bottom of
page |
|
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-member-
name] [-cluster]
OPTIONS
get category
Displays a list of all hardware component category names available on
the system, such as platform, scsi_bus, and disk.
get attribute
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:
saved
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.
default
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.
current
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 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_starvation_time = 25 (settable)
cluster_disables = 0
For each attribute value (saved, default, or current) you can specify
the following optional parameters:
-a attribute...
Displays the value of an individual attribute, such as
path_fail_limit, which is a SCSI disk attribute defining the limit
for path failures.
-a attribute=value...
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
-a attribute!=value...
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
-id hardware-component-id
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
-category hardware-category
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.
-member cluster-member-name
Specifies the host name of a cluster member on which to perform the
operation.
-cluster
Specifies that the operation be performed clusterwide. If this
option is not specified, data for the local host is returned.
set attribute
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:
-a attribute=value...
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.
-id hardware-component-id
Specifies a hardware component identifier (HWID) on which to
perform the operation.
-member cluster-member-name
Specifies the host name of a cluster member on which to perform the
operation.
-cluster
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.
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
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.
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.
1. 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
2. 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
3. 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.
4. 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)
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
|
Index for
Section 8 |
|
|
Alphabetical
listing for H |
|
 |
Top of
page |
|