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

Sun Enterprise 10000 SSP 3.5 Reference Manual

blacklist(4)

NAME | DESCRIPTION | Keywords | EXAMPLES | SEE ALSO

NAME

blacklist- list of system resources not to be booted

DESCRIPTION

$SSPVAR/etc/platform_name/blacklist 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 POST cannot use at boot time. POST reads the blacklist 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 blacklist are excluded.

In the blacklist 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 is an integer, 0 to 15.

-proc board.pmod

Do not test or configure the specified processor within the specified system board, where board is an integer, 0 to 15 and pmod is an integer, 0 to 3.

-abus abus

Do not test or configure the specified address bus, where abus is an integer, 0 to 3. The meaning of this command is that the corresponding CIC ASIC on all system boards is marked black. 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 is an integer, 0 or 1. The meaning of this command is that the corresponding half of the local data router on all system boards is marked black. See the keyword ldpath, below.

-ioc board.ioctl

Do not test or configure the specified I/O controller on the specified system board, where board is an integer, 0 to 15 and ioctl is an integer, 0 or 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 a system board. board is an integer, 0 to 15, ioctl is an integer, 0 or 1, and slot is an integer, 0 to 3.

Note -

The range 0-3 for scard represents the syntactically correct values in the blacklist file, which allows for the possibility of future I/O modules. At this time, the only supported module types have either two SBus cards, or one PCI card, per I/O controller. Blacklisting scards that do not exist is quietly ignored.

-mem board

Do not test or configure memory on the specified system board, where board = 0 to 15.

-mgroup board.group

Do not test or configure the specified group of memory DIMMs within the specified system board, where board is an integer, 0 to 15 and group is an integer, 0 to 3.

-mlimit board.group.MBytes

Restrict memory configuration of the specified group of DIMMs on the specified system board to the specified value (which is less than its actual value), where board is an integer, 0 to 15, group is an integer, 0 to 3 and MBytes is an integer, 64 or 256. This keyword can be useful in benchmarking where, for example, one might simulate memory with 8-Mbyte DIMMs (a 64-Mbyte group) on a machine that actually has 32-Mbyte DIMMs (a 256-Mbyte group). This level of control granularity is required because one board with 256-Mbyte memory groups behaves differently than four boards each with 64-Mbyte memory groups.

-cplane half_centerplane

Do not test or configure the specified Sun Enterprise 10000 half centerplane, which contains two address buses and 72 bits of the global data router, where half_centerplane is an integer, 0 or 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 is an integer, 0 to 15 and pc is an integer, 0 to 2.

xdb board.xdb

Do not test or configure the data buffer ASIC within the specified system board, where board is an integer, 0 to 15 and xdb is an integer, 0 to 3.

cic board.cic

Do not test or configure the specified coherent interface controller ASIC within the specified system board, where board is an integer, 0 to 15 and cic is an integer, 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 is an integer, 0 to 15 and dbus is an integer, 0 or 1.

EXAMPLES

Example 1 A Sample Blacklist 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.