showdevices(1M) displays the configured physical devices on system boards and the resources made available by these devices. Usage information is provided by applications and subsystems that are actively managing system resources. You can perform offline queries of managed resources to display the predicted impact of a system board DR operation. Unmanaged devices are not displayed by default; you must use the -v option.

showdevices gathers device information from one or more Sun Fire high-end system domains. The command uses dca(1M) as a proxy to gather the information from the domains.

The following options are supported.

-d domain_indicator

Specifies the domain using one of the following:

domain_id - ID for a domain. Valid domain_ids are A-R and are not case sensitive.

domain_tag - Name assigned to a domain using addtag(1M).

-h

Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.

-p

Displays specific reports.

Valid arguments for -p are:

bydevice

List output is grouped by device type (CPU, memory, IO). This is the default.

byboard

List output is grouped by system board. Default output is in tabular format grouped by device type (CPU, memory, IO).

query

List output is the result of a query to predict the effect of removing a system board

force

Forced offline query. Resource consumers are requested to apply force semantics in predicting whether they are able to relinquish usage of the system resources. (see cfgadm(1M)).

Note – The query and force arguments are not valid with the -d option.

-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 operands are supported:

location

List of board locations, separated by a space. Multiple location arguments are permitted.

The following location forms are accepted:

Sun Fire 15K, Sun Fire 12K

SB(0...17), SB(0...8)

IO(0...17), IO(0...8)

Showdevices fields:

domain

Tag or identifier

board

Board identifier

CPU:

id

Processor Id

state

Processor state

speed

CPU frequency in MHz

ecache

CPU ecache size in MB

Memory:

board mem

Board memory size in MB

perm mem

Amount of nonrelocatable memory on board in MB

base address

Base physical address of memory on board

domain mem

System memory size in MB

board

Board identifier

If a memory drain is in progress, the following is available:

target board

Target board identifier

deleted

Amount of memory already deleted in MB

remaining

Amount of memory remaining to be deleted in MB

I/O devices:

device

I/O device instance name

resource

Managed resource name

usage

Description of resource usage instance

query

Result of offline query of resources

Group Privileges Required

sc0:sms-user:> showdevices IO1 
IO Devices
----------
domain location device  resource           usage
A      IO1      sd3     /dev/dsk/c0t3d0s0  mounted filesystem "/"
A      IO1      sd3     /dev/dsk/c0t3s0s1  dump device (swap)
A      IO1      sd3     /dev/dsk/c0t3s0s1  swap area
A      IO1      sd3     /dev/dsk/c0t3d0s3  mounted filesystem "/var"
A      IO1      sd3     /var/run            mounted filesystem "/var/run"

sc0:sms-user:> showdevices -v -d A
CPU
----
domain  location  id     state    speed  ecache  
A       C1        40     online   400    4
A       C1        41     online   400    4
A       C1        42     online   400    4
A       C1        43     online   400    4
A       C2        55     online   400    4
A       C2        56     online   400    4
A       C2        57     online   400    4
A       C2        58     online   400    4

Memory

drain in progress:
-----------------
               board  perm   base      domain target  deleted  remaining

domain location  mem MB  mem MB address    mem MB  board   mem MB    mem MB
A     C1        2048    723    0x600000   4096    C2      250       1500
A     C2        2048      0    0x200000   4096

IO Devices
---------
domain location  device resource           usage
A      IO1       sd0
A      IO1       sd1
A      IO1       sd2
A      IO1       sd3    /dev/dsk/c0t3d0s0  mounted filesystem "/"
A      IO1       sd3    /dev/dsk/c0t3s0s1  dump device (swap)
A      IO1       sd3    /dev/dsk/c0t3s0s1  swap area
A      IO1       sd3    /dev/dsk/c0t3d0s3  mounted filesystem "/var"
A      IO1       sd3    /var/run           mounted filesystem "/var/run"
A      IO1       sd4
A      IO1       sd5
A      IO1       sd6		

sc0:sms-user:> showdevices -p query IO1


Location IO1 - Domain A
====================
IO Devices
----------
device  resource               query  usage/reason
sd3     /dev/dsk/c0t3d0s0      fail   mounted filesystem "/"
sd3     /dev/dsk/c0t3s0s1      fail   dump device (swap)
sd3     /dev/dsk/c0t3s0s1      fail   swap area
sd3     /dev/dsk/c0t3d0s3      fail   mounted filesystem "/var" 
sd3     /var/run                -     mounted filesystem "/var/run"

The query field shows the predicted result of removing the resource. The failure of the mounted file system /var to offline prevents the query from reaching the layered mount point /var/run.

The following exit values are returned:

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.

4

An error occurred communicating with pcd.

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.

See attributes(5) for descriptions of the following attributes.

addtag(1m), dca(1m), pcd(1m)