showdevices(1M)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXTENDED DESCRIPTION | EXAMPLES | EXIT STATUS | ATTRIBUTES | SEE ALSO
NAME
- showdevices- display system board devices and resource usage information
SYNOPSIS
-
showdevices [-v] [-p query|force] board_id
showdevices [-v] [-p bydevice|byboard] board_id...
showdevices [-v] [-p bydevice|byboard|query|force] -d domain
showdevices -h
DESCRIPTION
showdevices displays the configured physical devices on system boards and the resources made available by those devices. The default display of this information is by device type. Usage information is provided by applications and subsystems that are actively managing system resources. Display the predicted impact of a system board DR operation by performing an offline query of managed resources. Use the -v option to display unmanaged devices, which are not displayed by default.
Note -
This command applies only to Sun Enterprise 10000 domains running DR model 3.0.
OPTIONS
- -d domain
-
Domain name. Displays the device and resource information for all configured boards in the specified domain.
- -h
-
Help. Displays usage descriptions.
Note -Use alone. Any option specified in addition to -h is ignored.
- -p bydevice|byboard|query|force
-
Displays specific reports:
bydevice-- Lists output by device type (CPU, memory, I/O).
byboard -- Lists output by system board, which is displayed in tabular format grouped by device type (CPU, memory, I/O).
query -- Predicts the result of removing a system board.
force -- Forces an offline query. Resource consumers are requested to apply force semantics to predict whether system resources can be relinquished. See cfgadm(1M).
- -v
-
Displays all I/O devices. Includes both managed and unmanaged I/O devices. Managed devices export actively managed resources. Unmanaged devices are physically configured but do not export actively managed resources. No usage information is available for unmanaged devices.
The following options are supported:
OPERANDS
- board_id
-
Board identifier. The valid range for board identifiers is SB0 through SB15.
The following operands are supported:
EXTENDED DESCRIPTION
- domain
-
-- domain name
- board
-
-- board identifier
- id
-
-- processor id
- state
-
-- processor state
- speed
-
-- CPU frequency in MHz
- ecache
-
-- CPU ecache size in MB
- query
-
-- result of offline query of resources
- board mem
-
-- board memory size in MB
- perm mem
-
-- amount of non-relocatable memory on board in MB
- base address
-
-- base physical address of memory on board
- domain mem
-
-- system memory size in MB
- board
-
-- board identifier
- query
-
-- result of offline query of resources
- target board
-
-- target board identifier
- deleted
-
-- amount of memory already deleted in MB
- remaining
-
-- amount of memory remaining to be deleted in MB
- device
-
-- I/O device instance name
- resource
-
-- managed resource name
- usage
-
-- description of resource usage instance
- query
-
-- result of offline query of resources
The showdevice fields are:
CPU:
Memory:
If a memory drain is in progress, the following is available:
I/O Devices:
EXAMPLES
Example 1 Showdevices for System Board SB5
ssp% showdevices -v SB5
CPU
---
domain board id state speed ecache usage
xf8-b4 SB5 20 online 333 4
xf8-b4 SB5 21 online 333 4
xf8-b4 SB5 22 online 333 4
xf8-b4 SB5 23 online 333 4
Memory
------
board perm base domain
domain board memMB memMB address memMB
xf8-b4 SB5 2048 0 0x500000 6144
IO Devices
----------
domain board device resource usage
xf8-b4 SB5 qfe52
xf8-b4 SB5 qfe53
xf8-b4 SB5 qfe54
xf8-b4 SB5 qfe55
xf8-b4 SB5 sd195
xf8-b4 SB5 sd196
|
Example 2 Showdevices for Domain xf8-b4
ssp% showdevices -v -d xf8-b4
CPU
---
domain board id state speed ecache usage
xf8-b4 SB4 16 online 333 4
xf8-b4 SB4 17 online 333 4
xf8-b4 SB4 18 online 333 4
xf8-b4 SB4 19 online 333 4
xf8-b4 SB5 20 online 333 4
xf8-b4 SB5 21 online 333 4
xf8-b4 SB5 22 online 333 4
xf8-b4 SB5 23 online 333 4
xf8-b4 SB6 24 online 333 4
xf8-b4 SB6 25 online 333 4
xf8-b4 SB6 26 online 333 4
xf8-b4 SB6 27 online 333 4
Memory
------
board perm base domain
domain board memMB memMB address memMB
xf8-b4 SB4 2048 648 0x600000 6144
xf8-b4 SB5 2048 0 0x500000 6144
xf8-b4 SB6 2048 0 0x400000 6144
IO Devices
----------
domain board device resource usage
xf8-b4 SB4 qfe0
xf8-b4 SB4 qfe1
xf8-b4 SB4 qfe2
xf8-b4 SB4 qfe3
xf8-b4 SB4 sd0 /dev/dsk/c0t0d0s0 mounted filesystem "/"
xf8-b4 SB4 sd0 /dev/dsk/c0t0d0s1 swap area
xf8-b4 SB4 sd0 /dev/dsk/c0t0d0s1 dump device (swap)
xf8-b4 SB4 sd1
xf8-b4 SB5 qfe52
xf8-b4 SB5 qfe53
xf8-b4 SB5 qfe54
xf8-b4 SB5 qfe55
xf8-b4 SB5 sd195
xf8-b4 SB5 sd196
xf8-b4 SB6 qfe16
xf8-b4 SB6 qfe17
xf8-b4 SB6 qfe18
xf8-b4 SB6 qfe19
xf8-b4 SB6 sd60
xf8-b4 SB6 sd61
|
Example 3 Display Offline Query Result for System Board SB5
ssp% showdevices -v -p query SB5CPU
---
domain board id state speed ecache query usage:reason
xf8-b4 SB5 20 online 333 4
xf8-b4 SB5 21 online 333 4
xf8-b4 SB5 22 online 333 4
xf8-b4 SB5 23 online 333 4
Memory
------
board perm base domain
domain board memMB memMB address memMB query usage:reason
xf8-b4 SB5 2048 0 0x500000 6144
IO Devices
----------
domain board device resource query usage:reason
xf8-b4 SB5 qfe52
xf8-b4 SB5 qfe53
xf8-b4 SB5 qfe54
xf8-b4 SB5 qfe55
xf8-b4 SB5 sd195
xf8-b4 SB5 sd196
|
The query field shows the predicted result of removing the resource.[not in current example]
EXIT STATUS
- 0
-
Successful completion.
- 1
-
An invalid domain was specified.
- 2
-
A command line error such as an invalid option was detected.
- 3
-
More than one domain was specified.
- 5
-
An error occurred communicating with a domain.
- 6
-
An error occurred handling device information.
- 7
-
An internal error such as failed memory allocation occurred.
The following exit values are returned:
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Architecture | All |
| Availability | SUNWsspop |
| Stability | Evolving |
| MT-Level | Safe |
SEE ALSO
addboard(1M), deleteboard(1M), moveboard(1M), rcfgadm(1M) in the Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXTENDED DESCRIPTION | EXAMPLES | EXIT STATUS | ATTRIBUTES | SEE ALSO
- © 2010, Oracle Corporation and/or its affiliates