redlist(4) (Sun Enterprise 10000 SSP 3.5 Reference Manual)

Sun Enterprise 10000 SSP 3.5 Reference Manual

redlist(4)

NAME

redlist- list of system resources not to be touched

CAUTION

Contact your service provider before using this file. Certain changes to this file can cause your system to become unusable.

DESCRIPTION

$SSPVAR/etc/platform_name/redlist is an ASCII file that enables the system administrator or root to restrict, from the SSP, the configuration of the host system. It lists components that POST cannot touch, and whose state POST cannot change. POST reads the redlist file before preparing the system for booting, and passes along to OBP a list of only those components that have been successfully tested; those on the redlist are excluded.

The redlist file is very restrictive, and used in a very limited way, mostly in specialized debug in the lab. For example, a Sun Microsystems engineer might use it while working with experimental hardware that is missing components with which POST expects to communicate, even if just to freeze them.

Redlisted components are also considered effectively blacklisted.

Redlisting components carries a price in capability and performance. If any component on a board is redlisted, POST cannot reset that board; since some failures require a board reset to clear, the entire board becomes unusable and, in some cases, the entire system can become unusable.

Caution:Never use redlisting if blacklisting will do.

In the redlist file:

Keywords are not case-sensitive.
Any part of a line that starts with # is a comment.
Numbers are assumed decimal unless preceded by 0x, which indicates hexadecimal. Exception: a board number entered as one of [a - f] or [A - F] is assumed hexadecimal.
Each line has one and only one keyword.
The same keyword can be used on more than one line.
Each keyword has one or more arguments. Each argument is shown as an integer and multiple integers are separated by a period.

Keywords

All value ranges shown below are inclusive.

sysbd board: Do not test or configure the specified system board, where board equals 0 to 15.
proc board.pmod: Do not test or configure the specified processor within the specified system board, where board equals 0 to 15 and pmod equals 0 to 3.
abus abus: Do not test or configure the specified address bus, where abus equals 0 to 3. The meaning of this command is that the corresponding CIC ASIC on all system boards is marked red. See the keyword cic, below.
dbus dbus: Do not test or configure the specified 72-bit half of the 144-bit data router, where dbus equals 0 to 1. The meaning of this command is that the corresponding half of the local data router on all system boards is marked red. See the keyword ldpath, below.
ioc board.ioctl: Do not test or configure the specified I/O controller within the specified system board, where board equals 0 to 15 and ioctl equals 0 to 1.
scard board.ioctl.slot: Do not test or configure the specified I/O adapter card within the specified I/O controller, which is within the specified system board. board equals 0 to 15, ioctl equals 0 to 1 and slot equals 0 to 3.
mem board: Do not test or configure memory on the specified system board, where board equals 0 to 15.
mgroup board.group: Do not test or configure the specified group of memory DIMMs within the specified system board, where board equals 0 to 15 and group equals 0 to 3.
cplane half_centerplane: Do not test or configure the specified Sun Enterprise 10000 half centerplane, which contains two buses and 72 bits of the global data router, where half_centerplane equals 0 to 1. The meaning of this command is equivalent to the combination of the abus and dbus commands for the buses contained in this half-centerplane.
pc board.pc: Do not test or configure the specified port controller ASIC within the specified system board, where board equals 0 to 15 and pc equals 0 to 2.
xdb board.xdb: Do not test or configure the specified data buffer ASIC within the specified system board, where board equals 0 to 15 and xdb equals 0 to 3.
cic board.cic: Do not test or configure the specified coherent interface controller ASIC within the specified system board, where board equals 0 to 15 and cic equals 0 to 3 (cic corresponds to an address bus on that board).
ldpath board.dbus: Do not test or configure the specified 72-bit half of the 144-bit local data router within the specified system board, where board equals 0 to 15 and dbus equals 0 to 1.

EXAMPLES

Example 1 A Sample `redlist`(4) File

# Sun Microsystems, Inc.
sysbd 3 5 0xA        # Disable system boards 3, 5 and 10.
sysbd 3 5 A          # Disable system boards 3, 5 and 10.
PROC 4.0 6.2         # Disable Processor 0 on System Board 4, and 
                     # Processor 2 on System Board 6.
ScarD 3.0.1          # Disable I/O Adapter 1 on I/O Controller 0 on 
                     # System Board 3.
mem 2                # Disable all memory on System Board 2.
mlimit 0xE 2.64      # Restrict use of Memory DIMM Group 2 on System 
                     # Board 14 to 64MB.
cIc 1.2              # Disable CIC ASIC 2 on System Board 1.