|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Administration Commands psradm(1M)
NAME
psradm - change processor operational status
SYNOPSIS
psradm -f | -i | -n | -s [-v] [-F] processor_id
psradm -a -f | -i | -n | -s [-v] [-F]
DESCRIPTION
The psradm utility changes the operational status of proces-
sors. The legal states for the processor are on-line, off-
line, spare, faulted, and no-intr.
An on-line processor processes LWPs (lightweight processes)
and can 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 might not be possible to disable interrupts for an off-
line processor. Thus, the actual effect of being off-line
might vary from machine to machine.
A spare processor does not process any LWPs. A spare proces-
sor can be brought on-line, off-line or to no-intr by a
privileged user of the system or by the kernel in response
to changes in the system state.
A faulted processor is identified by the kernel, which moni-
tors the behavior of processors over time. A privileged user
can set the state of a faulted processor to be on-line,
off-line, spare or no-intr, but must use the force option to
do so.
A no-intr processor processes LWPs but is not interruptible
by I/O devices.
A processor can not be taken off-line or made spare if there
are LWPs that are bound to the processor unless the addi-
tional -F option is used. The -F option removes processor
bindings of such LWPs before changing the processor's opera-
tional status. On some architectures, it might not be possi-
ble to take certain processors off-line or spare 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 inter-
rupted. Since an off-line or spare processor can be inter-
ruptible, it is possible to have an operational system with
one processor no-intr and all other processors off-line or
spare but with one or more accepting interrupts.
SunOS 5.10 Last change: 17 Aug 2004 1
System Administration Commands psradm(1M)
If any of the specified processors are powered off, psradm
might power on one or more processors.
Only superusers can use the psradm utility.
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.
-F Force the transition to the additional specified
state. Required if one or more of the specified
processors was in the faulted state. Set the speci-
fied processors to faulted, if no other transition
option was specified. Forced transitions can only
be made to faulted, spare, or off-line states.
Administrators are encouraged to use the -Q option
for pbind(1M) to find out which threads will be
affected by forced a processor state transition.
-i Set the specified processors no-intr.
-n Bring the specified processors on-line.
-s Make the specified processors spare.
-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, spare, or no-intr.
SunOS 5.10 Last change: 17 Aug 2004 2
System Administration Commands psradm(1M)
Specify processor_id as an individual pro-
cessor number (for example, 3), multiple
processor numbers separated by spaces (for
example, 1 2 3), or a range of processor
numbers (for example, 1-4). It is also pos-
sible to combine ranges and (individual or
multiple) processor_ids (for example, 1-3 5
7-8 9).
EXAMPLES
Example 1: Setting Processors to off-line
The following example sets processors 2 and 3 off-line:
% psradm -f 2 3
Example 2: Setting Processors to no-intr
The following example sets processors 1 and 2 no-intr:
% psradm -i 1 2
Example 3: Setting Processors to spare
The following example sets processors 1 and 2 spare, even if
either of the processors was in the faulted state:
% psradm -F -s 1 2
Example 4: Setting All Processors on-line
% psradm -a -n
Example 5: Forcing Processors to off-line
The following example sets processors 1 and 2 offline, and
revokes the processor bindings from the processes bound to
them:
% psradm -F -f 1 2
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
SunOS 5.10 Last change: 17 Aug 2004 3
System Administration Commands psradm(1M)
FILES
/etc/wtmpx Records logging processor status changes
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
SEE ALSO
pbind(1M), psrinfo(1M), psrset(1M), p_online(2),
processor_bind(2), attributes(5)
DIAGNOSTICS
psradm: processor 4: Invalid argument
The specified processor does not exist in the configura-
tion.
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 ser-
vice 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.
SunOS 5.10 Last change: 17 Aug 2004 4
System Administration Commands psradm(1M)
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.
SunOS 5.10 Last change: 17 Aug 2004 5
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:26:28 GMT 2007
|
Your favourite pages:
No pages logged yet... Top 10 most popular pages:
prstat man page (24546 hits)
(Solaris 10 11_06)
netcat man page (17695 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (13531 hits)
(Solaris 10 11_06)
signal man page (12551 hits)
(Suse Linux 10.1)
startproc man page (11991 hits)
(Suse Linux 10.1)
raidctl man page (11357 hits)
(Solaris 10 11_06)
adv_cap_autoneg man page (10285 hits)
(Solaris 10 11_06)
sqlite3 man page (9729 hits)
(openSUSE 10.2)
CPAN man page (8947 hits)
(Suse Linux 10.1)
BusyBox man page (7702 hits)
(Suse Linux 10.1)
|
Man Pages 
