psradm(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | DIAGNOSTICS

NAME

psradm- Change processor operational status

SYNOPSIS

psradm -f| -i| -n [-v] processor_id...
psradm -a -f| -i| -n [-v]

DESCRIPTION

The psradm utility changes the operational status of processors. The legal states for the processor are on-line, off-line, and no-intr.

An on-line processor processes LWPs (lightweight processes) and may be interrupted by I/O devices in the system.

An off-line processor does not process any LWPs. Usually, an off-line processor is not interruptible by I/O devices in the system. On some processors or under certain conditions, it may not be possible to disable interrupts for an off-line processor. Thus, the actual effect of being off-line may vary from machine to machine.

A no-intr processor processes LWPs but is not interruptible by I/O devices.

A processor may not be taken off-line if there are LWPs that are bound to the processor. On some architectures, it might not be possible to take certain processors off-line if, for example, the system depends on some resource provided by the processor.

At least one processor in the system must be able to process LWPs. At least one processor must also be able to be interrupted. Since an off-line processor may be interruptible, it is possible to have an operational system with one processor no-intr and all other processors off-line but with one or more accepting interrupts.

If any of the specified processors are powered off, psradm may power on one or more processors.

To succeed, this command needs the sys_config privilege.

OPTIONS

The following options are supported:

-a

Perform the action on all processors, or as many as possible.

-f

Take the specified processors off-line.

-i

Set the specified processors no-intr.

-n

Bring the specified processors on-line.

-v

Output a message giving the results of each attempted operation.

OPERANDS

The following operands are supported:

processor_id

The processor ID of the processor to be set on-line or off-line.

EXAMPLES

---

Example 1 Set processors 2 and 3 off-line.




The following example sets processors 2 and 3 off-line.

psradm -f 2 3

---

---

Example 2 Set processors 1 and 2 no-intr.




The following example sets processors 1 and 2 no-intr.

psradm -i 1 2

---

---

Example 3 Set all processors on-line.




The following example sets all processors on-line.

psradm -a -n

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

FILES

/etc/wtmp

records logging processor status changes

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu

SUMMARY OF TRUSTED SOLARIS CHANGES

To succeed, this command needs the sys_config privilege.

SEE ALSO

Trusted Solaris 7 Reference Manual

p_online(2)

SunOS 5.7 Reference Manual

psrinfo(1M), psrset(1M), attributes(5)

DIAGNOSTICS

psradm: processor 4: Invalid argument

The specified processor does not exist in the configuration.

psradm: processor 3: Device busy

The specified processor could not be taken off-line because it either has LWPs bound to it, is the last on-line processor in the system, or is needed by the system because it provides some essential service.

psradm: processor 3: Device busy

The specified processor could not be set no-intr because it is the last interruptible processor in the system, or or it is the only processor in the system that can service interrupts needed by the system.

psradm: processor 3: Device busy

The specified processor is powered off, and it cannot be powered on because some platform-specific resource is unavailable.

psradm: processor 0: Not owner

The user does not have permission to change processor status.

psradm: processor 2: Operation not supported

The specified processor is powered off, and the platform does not support power on of individual processors.

Trusted Solaris 7  Last Revised 16 Mar 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | DIAGNOSTICS