Windows PowerShell command on Get-command cfgadm

Manual Pages for UNIX Operating System command usage for man cfgadm_sysctrl

System Administration Commands cfgadm_sysctrl(1M)

NAME

cfgadm_sysctrl - EXX00 system board administration

SYNOPSIS

/usr/sbin/cfgadm -c function [-f]

[-o disable-at-boot | enable-at-boot] [-n | -y] sysctrl0:slot# ...

/usr/sbin/cfgadm -x quiesce-test sysctrl0:slot#

/usr/sbin/cfgadm -x insert-test | remove-test sysctrl0:slot# ...

/usr/sbin/cfgadm -x set-condition-test=# sysctrl0:slot# ...

/usr/sbin/cfgadm [-l]

-o disable-at-boot | enable-at-boot sysctrl0:slot# ...

DESCRIPTION

The sysctrl hardware specific library /usr/platform/sun4u/lib/cfgadm/sysctrl.so.1 provides dynamic

reconfiguration functionality for configuring and discon-

necting system boards on E6X00, E5X00, E4X00, and E3X00 sys-

tems. You can insert both I/O and CPU boards into a slot on a running system that is configured for Solaris without rebooting. You can also disconnect and remove both types of boards from a running system without rebooting. System slots appear as attachment points in the device tree, one attachment point for each actual slot in the system chassis. If a board is not in a slot, the receptacle state

is empty. If a board is powered-off and ready to remove, the

receptacle state is disconnected. If a board is powered-on

and is connected to the system bus, the receptacle state is connected. The occupant state is unconfigured when the receptacle state is empty or disconnected. The occupant state is either

unconfigured or configured when the receptacle state is con-

nected. In the configured state the devices on a board are available for use by Solaris. In the unconfigured state, the devices on the board are not.

SunOS 5.11 Last change: 10 Mar 1999 1

System Administration Commands cfgadm_sysctrl(1M)

Inserting a board changes the receptacle state from empty to disconnected. Removing a board changes the receptacle state from disconnected to empty. Removing a board that is in the connected state crashes the operating system and can result in permanent damage to the system. OPTIONS Refer to cfgadm(1M) for a more complete description options. The following options are supported:

-c function

Perform the state change function. Specify function as connect, disconnect, configure or unconfigure. configure Change the occupant state to configure. If the receptacle state is disconnected, the configure function first attempts to connect the receptacle. The configure function walks the OBP device tree created as part of the connect function and creates the Solaris device tree nodes, attaching devices as required. For

CPU/Memory boards, configure adds CPUs to

the CPU list in the powered-off state.

These are visible to the psrinfo(1M) and

psradm(1M) commands. Two memory attach-

ment points are published for CPU/memory boards. Use mount(1M) andifconfig(1M) to

use I/O devices on the new board. To use

CPUs, use psradm -n to on-line the new

processors. Use cfgadm_ac(1M) to test and

configure the memory banks. connect Change the receptacle state to connected. Changing the receptacle state requires that the system bus be frozen while the bus signals are connected and the board tested. The bus is frozen by running a quiesce operation which stops all process activity and suspends all drivers. Because the quiesce operation and the subsequent resume can be time consuming, and are not supported by all drivers, the

-x quiesce-test is provided. While the

system bus is frozen, the board being connected is tested by firmware. This

SunOS 5.11 Last change: 10 Mar 1999 2

System Administration Commands cfgadm_sysctrl(1M)

operation takes a short time for I/O boards and a significant time for

CPU/Memory boards due to CPU external cache testing. This does not provide memory testing. The user is prompted for confirmation before proceeding with the

quiesce. Use the -y or -n option to over-

ride the prompt. The connect operation is refused if the board is marked as

disabled-at-boot, unless either the force

flag, -f, or the enable at boot flag, -o

enable-at-boot, is given. See -l.

disconnect Change the receptacle state to discon-

nected. If the occupant state is configure, the disconnect function first attempts to unconfigure the occupant. The disconnect operation does not require a quiesce operation and operates quickly. The board

is powered-off ready for removal.

unconfigure Change the occupant state to unconfi-

gureed. Devices on the board are made invisible

to Solaris during this process. The I/O

devices on an I/O board are removed from the Solaris device tree. Any device that is still in use stops the unconfigure process and be reported as in use. The unconfigure operation must be retried

after the device is made non-busy. For

CPU/Memory boards, the memory must have been changed to the unconfigured state prior to issuing the board unconfigure operation. The CPUs on the board are

off-lined, powered off and removed from

the Solaris CPU list. CPUs that have

processes bound to them cannot be off-

lined. See psradm(1M), psrinfo(1M),

pbind(1M), andp_online(2) for more infor-

mation on off-lining CPUs.

-f

Force a block on connecting a board marked as

SunOS 5.11 Last change: 10 Mar 1999 3

System Administration Commands cfgadm_sysctrl(1M)

disabled-at-boot in the non-volatile disabled-board-list

variable. See Platform Notes:Sun Enterprise 6x00/5x00/4x00/3x00 Systems

-l

List options. Supported as described in cfgadm(1M)cfgadm(1M).

The type field can be one of cpu/mem, mem, dual-sbus,

sbus-upa, dual-pci, soc+sbus, soc+upa, disk or unknown.

The hardware-specific info field is set as follows:

[disabled at boot] [non-detachable] [100 MHz capable]

For sbus-upa and soc+upa type boards, the following

additional information appears first: [single buffered ffb|double buffered ffb|no ffb installed] For disk type boards, the following additional information appears

first: {target: # | no disk} {target: # | no disk}

-o disable-at-boot | enable-at-boot

Modify the state of the non-volatile disabled-board-

list variable. Use this the -o option in conjunction

with the -c function or -l option.

Use -o enable-at-boot with the -c connect to override a

block on connecting a disabled-at-boot board.

-x insert-test | remove-test

Perform a test.

Specify remove-test to change the driver state for the

specified slot from disconnected to empty without the need for physically removing the board during automated test sequences.

Specify insert-test to change the driver state of a slot

made to appear empty using the remove-test command to

the disconnected state as if it had been inserted.

-x quiesce-test sysctrl0:slot1

Perform a test. Allows the quiesce operation required for board connect

SunOS 5.11 Last change: 10 Mar 1999 4

System Administration Commands cfgadm_sysctrl(1M)

operations to be exercised. The execution of this test confirms that, with the current software and hardware configuration, it is possible to quiesce the system. If a device or process cannot be quiesced, its name is printed in an error message. Any valid board attachment

point can be used with this command, but since all sys-

tems have a slot1 the given form is recommended.

-x set-condition-test=#

Perform a test. Allows the condition of a system board attachment point to be set for testing the policy logic for state change

commands. The new setting is given as a number indicat-

ing one of the following condition values: 0 unknown 1 ok 2 failing 3 failed 4 unusable OPERANDS The following operand is supported:

sysctrl0:slot# The attachment points for boards

on EXX00 systems are published by instance 0 of the sysctrl driver (sysctrl0). The names of

the attachment points are num-

bered from slot0 through slot15.

Specify # as a number between 0

and 15, indicating the slot number. This form conforms to

the logical ap_id specification

given in cfgadm(1M). The

corresponding physical ap_ids

are listed in the FILES section. FILES /usr/platform/sun4u/lib/cfgadm/sysctrl.so.1 Hardware specific library

SunOS 5.11 Last change: 10 Mar 1999 5

System Administration Commands cfgadm_sysctrl(1M)

/devices/central@1f,0/fhc@0,f8800000/clock-

board@0,900000:slot* Attachment Points

ATTRIBUTES

See attributes(5) for descriptions of the following attri-

butes:

____________________________________________________________

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

|_____________________________|_____________________________|

| Availability | system/library/platform |

|_____________________________|_____________________________|

Manual Pages for UNIX Operating System command usage for man cfgadm_sysctrl

System Administration Commands cfgadm_sysctrl(1M)

NAME

cfgadm_sysctrl - EXX00 system board administration

SYNOPSIS

DESCRIPTION

System Administration Commands cfgadm_sysctrl(1M)

System Administration Commands cfgadm_sysctrl(1M)

System Administration Commands cfgadm_sysctrl(1M)

System Administration Commands cfgadm_sysctrl(1M)

System Administration Commands cfgadm_sysctrl(1M)

ATTRIBUTES

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

SEE ALSO