hwmgr_show(8) — Maintenance
NAME
hwmgr_show − Displays information from kernel-based hardware subsystems
SYNOPSIS
/sbin/hwmgr show [component | fibre | 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 the system registered on previous boots, but are not currently connected to your system.
The show component command displays a FLAGS field as part of the output. The FLAGS field is a series of characters that provide information about the state of a hardware component. The following characters are used:
rThe component is currently registered with hardware management.
dThe component has device special files associated with it.
cThe component has a clusterwide unique name.
sThe component has saved attributes associated with it in the on-disk hardware database.
iThis 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 that is guaranteed to be unique anywhere in the cluster.
−ncshared
Shows all hardware components that are NOT cluster shared. See the −cshared option 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 about possible problems.
This command does not fix database inconsistencies; it only detects inconsistencies. One possible fix might be to reboot the system.
−ninconsistencies
Shows all hardware components with no software inconsistencies.
−full
Shows detailed information about 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 local system is a cluster member.
−id hardware-component-id
Specifies the hardware identifier (HWID) of 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 all components on the local system.
show fibre
Displays information from the Fibre Channel (emx) subsystem. When you enter the hwmgr show fibre command without any options, the following information is returned for all adapters:
HWID
The hardware identifier for this Fibre Channel component.
ADAPTER NAME
The name and instance of the specified Fibre Channel component. Use the hwmgr show name command to determine adapter names, such as emx0.
LINK STATE
The current state of the adapter’s link connection to the fabric (switch), loop to the hub, or adjacent ports in the loop. Possible states are as follows:
•up − The link is connected and available for I/O.
•down − The link is not available. This adapter has no visibility into the fabric or loop and cannot transfer any I/O to storage devices.
•paused − The link is in a temporary state between up and down. A link condition was detected. If the link comes back quickly, it does not change to the down state.
LINK TYPE
The link type and mode, which is independent of the fabric connection. The link can be one of the following types:
•point-to-point − The adapter is connected directly to another port.
•loop − The adapter is connected in a loop. Either it is connected directly to an upstream port and a downstream port, or the cable pair is plugged into a hub (switch), creating a loop out of all ports connected to the hub.
FABRIC STATE
Whether the adapter is logged into an F_PORT (switch port). This field can either be attached or blank (null).
An attached state can exist under either point-to-point or loop link types. Under point-to-point it indicates that the adapter is directly plugged into a switch port (F_Port). Under loop it indicates that at least one of the ports connected in the loop is an F_Port. However, there might be several other loop ports between the adapter and the F_Port that are in loop mode.
(Fabric loop attach from a host adapter is not supported in Tru64 UNIX Version 5.1B).
SCSI BUS
The SCSI bus name of the bus that is supporting this connection. Use the hwmgr view hierarchy command to determine the location of the bus in the system hardware hierarchy.
CARD MODEL
The model number and revision type of the Fibre Channel device.
Specify the following additional options to control the output:
−id hardware-component-id
Specifies the hardware identifier (HWID) of a specific Fibre Channel component such as a host bus adapter (HBA). Use the hwmgr view hierarchy command to obtain a component’s HWID.
−name component-name
Specifies a component name, such as adapter emx1. Use the hwmgr show name command to determine adapter names, such as emx0.
−adapter
Displays additional information for all Fibre Channel adapters. This option provides the following information:
Revisions: driver 2.01 firmware 3.03A1
FC Address: 0x21300
TARGET: -1
WWPN/WWNN: 1000-0000-c922-2f6b 2000-0000-c922-2f6b
The additional information fields are defined as follows:
•Revisions: − The loaded versions of the driver software and component firmware.
•FC Address: − The component’s Fibre Channel device identifier (DID) address in hexadecimal. This address is either self-determined in a loop topology or assigned by the fabric in a point-to-point fabric configuration.
•TARGET: − A field that is provided for backwards compatibility with output from the retiring emxmgr command. A valid SCSI target ID is no longer assigned to the host bus adapter; its value is always -1.
•WWPN/WWNN: − The Fibre Channel worldwide port name and worldwide node name. The combination of these values is the worldwide name which is a 64-bit unique identifier assigned to a Fibre Channel entity. (This identifier is similar to the concept of the MAC address assigned to an Ethernet network adapter.)
−topology
Displays the port mapping information for all links in the fabric. This option provides the same link state information that is displayed when you use the hwmgr show fibre -id and hwmgr show fibre -name commands. In addition, the following mapping information is displayed:
•FC DID − A field that contains the same information the FC Address, which is the device’s Fibre Channel device identifier (did) address in hexadecimal.
•TARGET − The SCSI target ID assigned to this particular N_Port. A value of -1 indicates that the remote port is a special fabric port that provides a fabric service. A value of -2 indicates that this is a remote N_Port that does not provide SCSI target mode service. This indicates that the N_Port is probably another host bus adapter.
•WWPN − The Fibre Channel worldwide port name.
•WWNN − The Fibre Channel worldwide node name.
•lfd − A flags field providing the following port information:
—
l - The adapter is logged in to the port as a Fibre Channel device.
—
f - The port is an F_Port (switch port).
—
d - The port is a fabric directory server.
•LSIT − A flags field that provides the following SCSI information:
—
L (logged in) - The adapter is logged in to the port as FCP (SCSI).
—
S (suspended) - The FCP login is currently suspended.
—
I (initiator) - The port is an FCP (SCSI) initiator.
—
T (target) - The port is an FCP (SCSI) target.
−member cluster-member-name
Specifies a cluster member on which you want to perform the hwmgr show fibre operation.
Use the hwmgr view hierarchy and hwmgr show component commands to display configuration information about the Fibre Channel devices. Use the hwmgr get attribute and hwmgr set attribute commands to return the attributes (device characteristics or properties) associated with the Fibre Channel device.
show name
Displays information from the name subsystem, which maintains an on-disk database that preserves the names of most hardware components. Typical names are pci0 (PCI bus) and tu3 (Tulip, a type of network card). Use the view hierarchy command option to obtain the component type that is associated with a name.
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
Displays information from the SCSI subsystem, which maintains information about SCSI devices, and does not include SCSI adapters. 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 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 SCSI entries at the specified target.
−lun scsi-lun
Shows SCSI entries at the 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.
−type SCSI-device-type
Specifies a SCSI device type, such as disk or tape. SCSI device types are: disk, tape, printer, processor; worm, cdrom, scanner, optical, changer, raid, enclosure, unknown.
−active
Specifies that only SCSI components with valid paths be displayed. If the system can access a component through a path, 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 the command output includes detailed information, if available.
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 hardware 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 components specified in the /etc/dec_hwc_ldb and /etc/dec_hwc_cdb binary databases. These databases contain information on most devices that are connected to the system.
fibre subsystem
The fibre subsystem maintains information on all fibre channel components specified in the /etc/emx_db binary database.
name subsystem
The name subsystem maintains information on all hardware components in the /etc/dec_hw_db binary 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 information about most buses, controllers, and devices.
scsi subsystem
The scsi subsystem maintains information on all SCSI devices in the /etc/dec_scsi_db binary database.
When managing the system hardware, you typically use the show option to obtain information on components that you need to manage. (For example, a component’s HWID (hardware identifier) or name. You can then specify this information as a command parameter with hwmgr operational commands. Refer to the following reference 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 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
The following notes and restrictions apply:
•When working on a cluster, if you do not specify an optional member name the operation defaults to the local member. (Some command options require that you specify a member name.)
•Currently the locate component −id command is implemented only for some SCSI disks, using the disk’s activity indicator light (LED).
•The following operations on the name subsystem are not supported by all drivers:
—
reload name
—
unconfigure name
—
unload name
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 120 -full
HWID: HOSTNAME FLAGS SERVICE COMPONENT NAME
---------------------------------------------
120: failte rcd-- iomap SCSI-WWID:01000010:6000-1fe1-0005-d760-0009-0041-7910-019d
DSF GROUP
INSTANCE GRPFLAGS GROUPID SUBSYSTEM BASENAME L1 L2
---------------------------------------------------------
0 40 42 cdisk dsk33 disk generic
DEVICE NODE
ID LBdevT LCdevT CBdevT CCdevT BFlags CFlags Class Suffix L3B L3C
-------------------------------------------------------------------------------
0 5100980 5100980 1300223 1300224 0xa61 0xa61 0x0 a block char
1 5100981 5100981 1300225 1300226 0xa61 0xa61 0x1 b block char
2 5100982 5100982 1300227 1300228 0xa61 0xa61 0x2 c block char
3 5100983 5100983 1300229 130022a 0xa61 0xa61 0x3 d block char
4 5100984 5100984 130022b 130022c 0xa61 0xa61 0x4 e block char
5 5100985 5100985 130022d 130022e 0xa61 0xa61 0x5 f block char
6 5100986 5100986 130022f 1300230 0xa61 0xa61 0x6 g block char
7 5100987 5100987 1300231 1300232 0xa61 0xa61 0x7 h block char
8 814401 814401 0 0 0x843 0x843 0x0 (null) block char
9 814401 814401 0 0 0x843 0x843 0x0 (null) block char
10 814403 814403 0 0 0x843 0x843 0x0 (null) block char
11 814403 814403 0 0 0x843 0x843 0x0 (null) block char
12 814405 814405 0 0 0x843 0x843 0x0 (null) block char
13 814405 814405 0 0 0x843 0x843 0x0 (null) block char
14 814407 814407 0 0 0x843 0x843 0x0 (null) block char
15 814407 814407 0 0 0x843 0x843 0x0 (null) block char
This example shows the full component information for the disk that has the HWID of 120 (dsk33).
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 hwmgr show scsi -full command, 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
5.The following command displays the link state of a specific Fibre Channel device:
# hwmgr show fibre -id 50
ADAPTER LINK LINK FABRIC SCSI CARD
HWID: NAME STATE TYPE STATE BUS MODEL
----------------------------------------------------------------------
50: emx0 up point-to-point attached scsi4 KGPSA-BC
6.The following command displays the link state and identifiers of all Fibre Channel components (where more than one Fibre Channel component is installed):
# hwmgr show fibre -adapter
ADAPTER LINK LINK FABRIC SCSI CARD
HWID: NAME STATE TYPE STATE BUS MODEL
--------------------------------------------------------------------------------
46: emx0 up point-to-point attached scsi1 KGPSA-CA
Revisions: driver 2.03 firmware 3.81X1
FC Address: 0x11000
TARGET: -1
WWPN/WWNN: 1000-0000-c922-47cd 2000-0000-c922-47cd
50: emx0 up point-to-point attached scsi4 KGPSA-BC
Revisions: driver 2.01 firmware 3.03A1
FC Address: 0x21300
TARGET: -1
WWPN/WWNN: 1000-0000-c922-2f6b 2000-0000-c922-2f6b
7.The following command displays the Fibre Channel N-Ports that are visible to the adapter, for all components attached to the system
# hwmgr show fibre -topology
ADAPTER LINK LINK FABRIC SCSI CARD
HWID: NAME STATE TYPE STATE BUS MODEL
--------------------------------------------------------------------------------
46: emx0 up point-to-point attached scsi1 KGPSA-CA
FC DID TARGET WWPN WWNN lfd LSIT
------------------------------------------------------------------------
0x011100 0 5000-1fe1-0006-3f13 5000-1fe1-0006-3f10 l-- L--T
0x011200 -2 1000-0000-c924-4b7b 2000-0000-c924-4b7b l-- L-I-
0x011300 2 5000-1fe1-0006-3f14 5000-1fe1-0006-3f10 l-- L--T
0x011400 -2 1000-0000-c922-4aac 2000-0000-c922-4aac l-- L-I-
0x011500 1 5000-1fe1-0006-3f11 5000-1fe1-0006-3f10 l-- L--T
0x011600 -2 1000-0000-c922-473d 2000-0000-c922-473d l-- L-I-
0x011700 3 5000-1fe1-0006-3f12 5000-1fe1-0006-3f10 l-- L--T
0xfffffc -1 20fc-0060-6920-383d 1000-0060-6920-383d l-d ----
0xfffffe -1 2000-0060-6920-383d 1000-0060-6920-383d lf- ----
FILES
See hwmgr(8) for a list of data files.
SEE ALSO
Commands: dop(8) ,dsfmgr(8), hwmgr_view(8), hwmgr_get(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.