System Management Services 1.2 man pages


	www.sun.com	docs.sun.com \| \| \|

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

System Administration

showcomponent(1m)

DESCRIPTION
OPTIONS
OPERANDS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
FILES
ATTRIBUTES
SEE ALSO

NAME

showcomponent - display the blacklist status for a component

SYNOPSIS

showcomponent [-a|-d domain_tag|domain_id] [-v] [location ...]

showcomponent -h

DESCRIPTION

showcomponent(1M) displays whether the specified component is listed in the platform, domain, or ASR blacklist file.

If neither the -a nor the -d option is specified, showcomponent displays the platform blacklist. If no location is specified, showcomponent displays all components in the specified blacklist.

The blacklist is an internal file that lists components POST cannot use at boot time. POST reads the blacklist file(s) before preparing the system for booting, and passes along to OpenBoot PROM a list of only those components that have been successfully tested; those on the blacklist are excluded.

SMS supports three blacklists, one for domain boards and one for platform boards; and the internal automatic system recovery (ASR) blacklist.

For more information on the use and editing of platform and domain blacklists refer to Chapter 7 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems.

OPTIONS

The following options are supported.

-a: Specifies the ASR blacklist.
-d domain_id: ID for a domain. Valid domain_ids are 'A'...'R' and are case insensitive. This option specifies the domain blacklist.
-d domain_tag: Name assigned to a domain using addtag(1M). This option specifies the domain blacklist.
-h: Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.
-v: Verbose. Displays all available command information.

OPERANDS

The following operands are supported:

location

List of component locations, separated by forward slashes and comprised of:

board_loc/proc/bank/logical_bank

board_loc/proc/bank/all_dimms_on_that_bank

board_loc/proc/all_banks_on_that_proc

board_loc/all_banks_on_that_board

board_loc/proc

board_loc/procs

board_loc/cassette

board_loc/bus

board_loc/paroli_link

Multiple location arguments are permitted separated by a space.

The location forms are optional and are used to specify particular components on boards in specific locations.

For example, the location SB5/P0/B1/L1 indicates Logical Bank 1 of Bank 1 on Processor 0 at SB5.

The SB0/PP1 location indicates Processor Pair 1 at SB0. The CS0/ABUS1 location indicates address bus 1 at CS0.

The following board_loc forms are accepted:

Sun Fire 15K, Sun Fire 12K

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

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

CS(0|1), CS(0|1)

EX(0...17), EX(0...8)

Processor locations indicate single processors or processor pairs.

There are four possible processors on a CPU/Memory board. Processor pairs on that board are: procs 0 and 1, and procs 2 and 3.

The MaxCPU has two processors,: procs 0 and 1, and only one proc pair (PP0). Using PP1 for this board will cause disablecomponent to exit and display an error message.

The following proc forms are accepted:

P(0...3) PP(0|1)

The following bank forms are accepted:

B(0|1)

The following logical_bank forms are accepted:

L(0|1)

The following all_dimms_on_that_bank forms are accepted:

D

The following all_banks_on_that_proc forms are accepted:

B

The following all_banks_on_that_board forms are accepted:

B

The following paroli_link forms are accepted:

PAR(0|1)

The hsPCI assemblies contain hot-swappable cassettes.

The following hsPCI forms are accepted:

C(3|5)V(0|1)

There are three bus locations: address, data and response.

The following bus forms are accepted:

ABUS|DBUS|RBUS (0|1)

EXTENDED DESCRIPTION

Group Privileges Required

You must have platform administrator, platform operator, platform service, domain administrator, or domain configurator privileges to run this command. If you have domain privileges you may only run this command on the domain for which you have privileges

Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.

EXAMPLES

Example 1. Display Whether SB0 is ASR Blacklisted

sc0:sms-user:>  showcomponent -a SB0
Component SB0 is disabled: #High Voltage

Example 2. Display Whether 4 Boards/Components in Domain B Are Blacklisted

sc0:sms-user:>  showcomponent -dB IO4/PP0 SB5 IO6/C5V0 EX7/ABUS0 
Component IO4/PP0 is disabled: #High temp 
Component SB5 is disabled: <no reason given> 
Component IO6/C5V0 is NOT disabled. 
Component EX7/ABUS0 is NOT disabled.

Example 3. Display Whether the Logical Bank on IO7 in Domain B Is Blacklisted

sc0:sms-user:>  showcomponent -dB IO7/P0/B1/L0 
Component IO7/P0/B1/L0 is disabled: <no reason given>

Example 4. Display All Platform Blacklisted Components

sc0:sms-user:>  showcomponent 
Component SB0 is disabled: #High temp 
Component SB3 is disabled:  
Component IO2 is disabled. <no reason given>

Example 5. Display All DomainB Blacklisted Components

sc0:sms-user:>  showcomponent -dB 
Component IO4/PP0 is disabled: #High temp 
Component SB5 is disabled: <no reason given>

Example 6. Display All ASR Blacklisted Components

sc0:sms-user:>  showcomponent -a 
Component SB0 is disabled: #High temp

EXIT STATUS

The following exit values are returned:

0: Successful completion
>0: An error occurred.

FILES

The following file is used by this command.

/etc/opt/SUNWSMS/config/asr/blacklist: List of components excluded by esmd.
/etc/opt/SUNWSMS/config/platform/blacklist: List of platform components excluded.
/etc/opt/SUNWSMS/config/domain_id/blacklist: List of domain components excluded.

Note – The asr blacklist file is created and used internally and should not be edited manually.

ATTRIBUTES

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

Attribute Types	Attribute Values
Availability	SUNWSMSop