hwmgr, hardware, hotswap, hot-swap - Command line interface for managing
/sbin/hwmgr [-help] command [subsystem] [parameters]
The hwmgr command enables you to manage hardware components and the subsys-
tems that maintain information about them. A hardware component can be a
storage peripheral, such as a disk or tape, or a system component such as a
CPU or a bus. Use the hwmgr utility to manage hardware components on either
a single system or on a cluster.
Use this utility for managing hardware, gathering information on system
status, and diagnosing device problems. The hwmgr utility has the following
+ Provides a wide range of hardware management functions under a single
+ Enables you to manage (to a small extent) hardware components that are
not currently connected to your system but were seen on a previous
+ Enables you to manage hardware components that are connected to multi-
ple systems in the cluster.
+ Enables you to propagate a management request to multiple members of a
The hwmgr command enables you to manage hardware components. The hwmgr com-
mands are organized into related groups and documented in the following
+ hwmgr(8) - The hwmgr command overview. It also describes options for
configuring the environment variable settings for the hwmgr command.
+ hwmgr_get(8) - Commands that enable you to display information about
hardware components and their attributes (or properties), such as the
capacity of a hard disk or the speed of a CPU.
+ hwmgr_view(8) - Commands that display information about the status of
the system and its hardware components. The display output from each
command organizes the data into a specific format.
+ hwmgr_show(8) - Commands that enable you to display information from
specific hardware subsystems.
+ hwmgr_ops(8) - Commands that enable you to perform administrative
tasks on hardware components, such as scanning buses, locating com-
ponents, powering off components, and deleting components.
You can abbreviate hwmgr commands and parameters to the fewest unique char-
You can run some hwmgr commands using the SysMan Menu, and also monitor
device properties and attributes using the SysMan Station. You must be
superuser (root) to use the hwmgr utility, however you can assign root
privileges by using the Division of Privileges (DOP) utility.
The following options are used with many of the commands. Other options are
unique to the individual commands and are defined with the commands.
Perform the operation on every member of the cluster. This option is
valid only when the system is a cluster member.
Perform the operation on the specified cluster member. This option is
valid only when the system is a cluster member.
Display extended details where they are provided.
Provide detailed information about the return status of this command.
You must not abbreviate the -verbose option. To make the verbose
operation default, define the environment variable HWMGR_VERBOSE =
The hwmgr utility provides a set of environment variable settings, which
you can set in your preferred environment configuration file such as your
.profile file. The default settings are:
Use this variable to set the location of the main hwmgr command data
HWMGR_DEBUG=TRUE | FALSE
Use this variable to set debugging on or off.
HWMGR_HEXINTS=TRUE | FALSE
Use this variable to set the display output to hexadecimal.
HWMGR_NOWRAP=TRUE | FALSE
Causes the display output to be truncated at 80 columns rather than
HWMGR_VERBOSE=TRUE | FALSE
Use this variable to set the hwmgr command to display verbose output by
default. This option can also be specified using the -verbose option
on the command line.
Use the view env command option to display the current values of the
environment variables as follows:
# /sbin/hwmgr view env
HWMGR_DATA_FILE = "/etc/hwmgr/hwmgr.dat"
HWMGR_DEBUG = FALSE
HWMGR_HEXINTS = FALSE
HWMGR_NOWRAP = FALSE
HWMGR_VERBOSE = FALSE
The following notes and restrictions apply:
+ When working on a cluster, if you do not specify a member name the
operation defaults to the local member. Some command options require
that you specify a member name, but in general it is an option.
+ Currently the locate component -id command is only implemented only
for SCSI disks, using the disk activity indicator light (LED).
+ The following operations on the name subsystem are not supported by
-- The reload name operation.
-- The unconfigure name operation.
-- The unload name operation.
The command returns an int with an errorno from <<errno.h>>.
Do not edit any of the following files:
The executable image
The main data file
The data file for the HWC component subsystem
The data file for the NAME component subsystem
The data file for the CAM SCSI component subsystem
Commands: dop(8), dsfmgr(8), hwmgr_show(8), hwmgr_get(8), hwmgr_ops(8),
hwmgr_view(8) ,sysman(8), sysman_station(8)
System Administration, Managing Online Addition and Removal