psradm(ADM)
psradm --
processor administration
Synopsis
psradm -a -f | -n | -d [-v]
psradm -f | -n | -d [-v] processor_id [ . . .]
Description
The psradm command
is the interface to processor configuration management
on a multiprocessor system.
It is used by system administrators and operators to manage the
administrative state of individual processors in a
multiprocessor system.
The processor_id is an integer that uniquely identifies a processor;
one or more processors can be specified.
Successful state transitions are recorded
in the /var/adm/wtmp file
for later system activity accounting.
When the -n option is specified, the following message
is written to the kernel log driver:
UX:psradm:INFO:At MM/DD/YY HH:MM:SS, processor_id was brought online.
When the -f option is specified, the following message
is written to the kernel log driver:
UX:psradm:INFO:At MM/DD/YY HH:MM:SS, processor_id was taken offline.
When the -d option is specified, the following message
is written to the kernel log driver:
UX:psradm:INFO:At MM/DD/YY HH:MM:SS, processor_id was disabled.
The message also is written to the standard output
when the -v option is specified.
System activity such as
a system reboot or putting a processor online
is recorded in the
/var/adm/wtmp file.
The options are:
-a-
Specifies that all processors are targeted for the operation.
-d-
Disable the specified processor.
When in the disabled state, a processor can be removed from the system
and replaced (typically called a ``hot swap'').
-f-
Take the specified processor(s)
offline, and make unavailable for use.
This token specifies a transition from an online or unlocked state
to an offline or locked administrative state.
If the -a option is specified, all online
processors except the boot processor will be taken
offline.
Prior to this operation, the specified processor(s) may be in any operational
state.
The processor(s) may even be just physically added to a system which
supports the hot plugging of CPUs; it will be enabled but offline
after specifying this option.
-n-
Bring the specified processor(s) online or all processors online if
no processor_id is specified.
-n specifies a transition from a
locked administrative
state to an unlocked administrative state.
If the -a option is specified, all offline processors
will be brought online.
The named processors must be in an enabled operational
state before this operation will succeed.
-v-
By default, the command executes silently.
The -v forces the command to report the completing status per
processor_id.
Errors
The following conditions will result in abnormal program termination:
-
user does not have appropriate privilege
-
processor_id specified is invalid
-
specified processor has one or more LWPs bound to it and
cannot be taken offline
Examples
To unlock a processor, or bring it online:
psradm -n processor_id
To lock a processor, or take it offline:
psradm -f processor_id
References
psrinfo(ADM)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 - 02 June 2005