 |
Index for
Section 8 |
|
 |
Alphabetical
listing for H |
|
 |
Bottom of
page |
|
hwmgr_show(8)
NAME
hwmgr_show - Displays information from hardware subsystems
SYNOPSIS
/sbin/hwmgr show [component | name | scsi] [subsystem-specific-options]
OPTIONS
show component
Displays hardware component information from the hardware component
subsystem. This includes all hardware components, including those that
were previously registered but are not currently registered.
The show component command returns a FLAGS field as part of the output.
The FLAGS field is a series of characters that provide information on
the state of a hardware component. The following characters are used:
r The component is currently registered with hardware management.
d The component has device special files associated with it.
c The component has a cluster wide unique name.
s The component has saved attributes associated with it in the on-
disk hardware database.
i A warning that this component has an inconsistency in the hardware
component database.
You can specify the following additional options with the hwmgr show
command to control the output:
-registered
Shows all hardware components that are currently registered with
hardware management.
-nregistered
Shows all hardware components that are not currently registered
with hardware management. These components were previously
registered.
-cshared
Shows all hardware components that are cluster shared. A cluster
shared hardware component is a hardware component that has a name
which is guaranteed to be unique anywhere in the cluster.
-ncshared
Shows all hardware components that are NOT cluster shared. See the
-cshared flag for a definition of cluster shared.
-devnodes
Shows all hardware components that have device special files
associated with them.
-ndevnode
Shows all hardware components that do not have device special files
associated with them.
-savedattr
Shows all hardware components that have saved attributes. See the
hwmgr get command option for a description of saved attributes.
-nsavedattr
Shows all hardware components that do NOT have saved attributes.
See the hwmgr get command option for a description of saved
attributes.
-inconsistencies
Shows all hardware components that have software inconsistencies in
the hardware component database. An inconsistency is a possible
internal error with the component database. Use the show -full
command option to obtain detailed information of possible problems.
This command does not fix database inconsistencies; it only detects
inconsistencies. One possible fix might be to reboot the cluster.
-ninconsistencies
Shows all hardware components with no software inconsistencies.
-full
Shows detailed information on the hardware component.
-output output-format
Displays output from the show command option in an alternate
format. The tcl format is the only alternate format supported in
this release.
-member cluster-member-name
Specifies a cluster member on which you want to perform the hwmgr
show operation.
-cluster
Specifies that the operation be performed on every member of the
cluster. This option is valid only when the system is a cluster
member.
-id hardware-component-ID
Specifies the hardware identifier (HWID) for the component on which
you want to perform the show operation.
If no member ID is specified and the -cluster option was not used, the
show operation defaults to the local cluster member.
show name
Shows information from the name subsystem, which maintains the on-disk
database. This database is used to preserve the names of most hardware
components. For example, pci0 and tu3. This operation defaults to the
local system if you do not specify a cluster member.
-member cluster-member-name
Specifies a cluster member on which to perform the show operation.
show scsi
Shows information from the SCSI subsystem. You can specify the
following options with the hwmgr show scsi command:
-id hardware-component-ID
Shows SCSI information for only the component specified by the
hardware component identifier.
-did scsi-device-ID
Shows SCSI information for the component specified by the SCSI
device identifier (did). The did is a specific identifier used by
the SCSI subsystem, and differs from the hardware identifier
(HWID).
-bus scsi-bus
Shows any SCSI entries with a path (valid or stale) at the
specified bus. A stale path occurs when a component that was
previously seen at a path is no longer accessible at that path.
-target scsi-target
Shows any SCSI entries at the specified target.
-lun scsi-lun
Shows any SCSI entries at specified lun (logical unit number).
-member cluster-member-name
Specifies a cluster member on which to perfom the show operation.
This operation defaults to the local system if no cluster member
identifier is specified and you do not specify a cluster member.
-type SCSI-device-type
Specifies a SCSI device type, such as disk or tape. SCSI device
types are specified in the SCSI standards that the operating system
supports. Supported standards and restrictions are defined in the
Quick Specs.
-active
Specifies that only SCSI components with valid paths be displayed.
If a component can be accessed, the path is valid.
-stale
Specifies that only SCSI components with stale paths be displayed.
A path becomes stale when a component that was previously seen at a
path is no longer accessible at that path.
-full
Specifies that if detailed information on a component is available,
that data be displayed.
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.
Hardware subsystems maintain on-disk databases that contain information
about components. You use the hwmgr show command options to display
information from the following hardware subsystems:
component subsystem
The component subsystem maintains information on all hardware devices
specified in the binary /etc/dec_hwc_ldb and /etc/dec_hwc_cdb
databases. These databases contain information on all hardware
components. This includes most devices on a system.
name subsystem
The name subsystem maintains information on all hardware components in
the binary /etc/dec_hw_db database, often referred to as the hardware
topology. The database contains hardware name persistence information
that is maintained by the kernel driver framework and includes data for
most buses, controllers, and devices.
scsi subsystem
The scsi subsystem maintains information on all SCSI devices in the
binary /etc/dec_scsi_db database.
You use the information obtained from the subsystems as parameters to other
hwmgr operational commands that you use to manage devices and subsystems.
Refer to the following pages for information on related commands:
· hwmgr_view(8) - Describes commands that enable you to display
information about the status of the system and its hardware
components.
· hwmgr_get(8) - Describes commands that enable you to display (get) or
configure (set) component attributes such as the capacity of a hard
disk or the speed of a CPU. You can also display component category
names.
· 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 System Administration guide for more information on device names
and device special files and a definitive list of the supported device
names. You can run some hwmgr commands directly from the SysMan Menu, and
monitor components by using the SysMan Station.
RESTRICTIONS
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.
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. Use the following command to display SCSI information for all the
disks in your system:
# /sbin/hwmgr show scsi -type disk
SCSI DEVICE DEVICE DRIVER NUM DEVICE FIRST
HWID: DEVICEID HOSTNAME TYPE SUBTYPE OWNER PATH FILE VALID PATH
---------------------------------------------------------------------
32: 0 cymro disk none 2 1 dsk0 [0/0/0]
34: 2 cymro disk none 0 1 dsk1 [0/5/0]
35: 3 cymro disk none 0 1 dsk2 [0/6/0]
36: 4 cymro disk none 2 1 dsk3 [0/8/0]
2. Use the following command to display the hardware persistence entries
from the name subsystem.:
# /sbin/hwmgr show name
HWID: NAME HOSTNAME PERSIST TYPE PERSIST AT
-----------------------------------------------------
59: aha0 psychlo BUS eisa0 slot 3
52: isp1 psychlo BUS pci0 slot 13
14: isp0 psychlo BUS pci0 slot 5
5: pci0 psychlo BUS nexus
53: scsi1 psychlo CONTROLLER isp1 slot 0
15: scsi0 psychlo CONTROLLER isp0 slot 0
42: tu1 psychlo CONTROLLER pci0 slot 12
30: tu0 psychlo CONTROLLER pci0 slot 11
3. The following command displays the components that have associated
device special files. This information comes from the component
subsystem:
# /sbin/hwmgr show component -devnodes
HWID: HOST FLAGS SERVICE COMPONENT NAME
-----------------------------------------------
3: pmoba r-d-- none kevm
20: pmoba r-d-- none tty00
22: pmoba r-d-- none tty01
24: pmoba r-d-- none lp0
27: pmoba r-d-- iomap FDI-fdi0-unit-0
35: pmoba rcd-- iomap SCSI-WWID:0410004c:"DEC RZ28 0034766791"
36: pmoba rcd-- iomap SCSI-WWID:04100024:"DEC RZ25F 14295981"
37: pmoba r-d-- iomap SCSI-WWID:0710002c:"DEC RRD43 6l00000"
38: pmoba r-d-- iomap SCSI-WWID:0710002c:"DEC TLZ06 04l00000"
40: pmoba --d-- iomap SCSI-WWID:0710002c:"DEC RX26 0l00000"
42: pmoba rcd-- iomap SCSI-WWID:0410004c:"DEC RZ26L 574435"
43: pmoba rcds- iomap SCSI-WWID:0410003a:"DEC RZ26L 2191192"
To see more information on the device special file, such as the dev_t
information, you can use the -full option with the show component
command, as follows:
# /sbin/hwmgr show component -id 3 -full
HWID: HOSTNAME FLAGS SERVICE COMPONENT NAME
-----------------------------------------------
3: pumba r-d-- none kevm
DSF GROUP
INSTANCE GRPFLAGS GROUPID SUBSYSTEM BASENAME L1 L2
---------------------------------------------------------
0 40 1 kevm kevm pseudo kevm
DEVICE NODE
ID LB LC CB CC B C Class Suffix L3B L3C
devT devT devT devT Flags Flags
---------------------------------------------------------------
0 0 4f00000 0 0 0x0 0x865 0x0 (null) (null) (null)
2 0 4f00002 0 0 0x0 0x865 0x0 .pterm (null) (null)
1 0 4f00001 0 0 0x0 0x875 0x0 .debug (null) (null)
This example shows the device special file basename of pseudo device
kevm. It also shows the device special file and dev_t information.
4. Use the following command to display information from the SCSI
subsystem:
# /sbin/hwmgr show scsi
SCSI DEVICE DEVICE DRIVER NUM DEVICE FIRST
HWID: DID HOSTNAME TYPE SUBTYPE OWNER PATH FILE VALID PATH
---------------------------------------------------------------
22: 0 ftiwod disk none 2 1 dsk0 [0/3/0]
23: 1 ftiwod cdrom none 0 1 cdrom0 [0/4/0]
24: 2 ftiwod disk none 0 1 dsk1 [2/2/0]
25: 3 ftiwod disk none 0 1 dsk2 [2/2/1]
29: 4 ftiwod disk none 0 1 scp2 [2/2/2]
To view all the paths to a particular SCSI device you can use the -
show scsi -full option, as follows:
# /sbin/hwmgr show scsi -full -id 43
SCSI DEVICE DEVICE DRIVER NUM DEVICE FIRST
HWID: DID HOSTNAME TYPE SUBTYPE OWNER PATH FILE VALID PATH
----------------------------------------------------- ---------
43: 7 pmoba disk none 0 2 dsk3 [0/2/0]
WWID:0410003a:"DEC RZ26L (C) DECPCB= ; HDA=000052191192"
BUS TARGET LUN PATH STATE
------------------------------
1 2 0 stale
0 2 0 valid
FILES
See hwmgr(8).
SEE ALSO
Commands: dsfmgr(8), hwmgr_view(8), hwmgr_get(8), hwmgr_ops(8), sysman(8),
sysman_station(8)
Files: olar_config(4)
Misc: OLAR_intro(5)
System Administration, , Managing Online Addition and Removal
|
Index for
Section 8 |
|
|
Alphabetical
listing for H |
|
 |
Top of
page |
|