1psradm(1M) System Administration Commands psradm(1M)
2
6 psradm - change processor operational status
7
9 psradm -f | -i | -n | -s [-v] [-F] processor_id
10 psradm -a -f | -i | -n | -s [-v] [-F]
13
16 The psradm utility changes the operational status of processors. The
17 legal states for the processor are on-line, off-line, spare, faulted,
18 and no-intr.
19 An on-line processor processes LWPs (lightweight processes) and can be
22 interrupted by I/O devices in the system.
23 An off-line processor does not process any LWPs. Usually, an off-line
26 processor is not interruptible by I/O devices in the system. On some
27 processors or under certain conditions, it might not be possible to
28 disable interrupts for an off-line processor. Thus, the actual effect
29 of being off-line might vary from machine to machine.
30 A spare processor does not process any LWPs. A spare processor can be
33 brought on-line, off-line or to no-intr by a privileged user of the
34 system or by the kernel in response to changes in the system state.
35 A faulted processor is identified by the kernel, which monitors the
38 behavior of processors over time. A privileged user can set the state
39 of a faulted processor to be on-line, off-line, spare or no-intr, but
40 must use the force option to do so.
41 A no-intr processor processes LWPs but is not interruptible by I/O
44 devices.
45 A processor can not be taken off-line or made spare if there are LWPs
48 that are bound to the processor unless the additional -F option is
49 used. The -F option removes processor bindings of such LWPs before
50 changing the processor's operational status. On some architectures, it
51 might not be possible to take certain processors off-line or spare if,
52 for example, the system depends on some resource provided by the pro‐
53 cessor.
54 At least one processor in the system must be able to process LWPs. At
57 least one processor must also be able to be interrupted. Since an off-
58 line or spare processor can be interruptible, it is possible to have an
59 operational system with one processor no-intr and all other processors
60 off-line or spare but with one or more accepting interrupts.
61 If any of the specified processors are powered off, psradm might power
64 on one or more processors.
65 Only users with the PRIV_SYS_RES_CONFIG privilege can use the psradm
68 utility.
69
71 The following options are supported:
72 -a Perform the action on all processors, or as many as possible.
74 -f Take the specified processors off-line.
77 -F Force the transition to the additional specified state. Required
80 if one or more of the specified processors was in the faulted
81 state. Set the specified processors to faulted, if no other tran‐
82 sition option was specified. Forced transitions can only be made
83 to faulted, spare, or off-line states. Administrators are encour‐
84 aged to use the -Q option for pbind(1M) to find out which threads
85 will be affected by forced a processor state transition.
86 -i Set the specified processors no-intr.
89 -n Bring the specified processors on-line.
92 -s Make the specified processors spare.
95 -v Output a message giving the results of each attempted operation.
98
101 The following operands are supported:
102 processor_id The processor ID of the processor to be set on-line or
104 off-line, spare, or no-intr.
105 Specify processor_id as an individual processor number
107 (for example, 3), multiple processor numbers separated
108 by spaces (for example, 1 2 3), or a range of processor
109 numbers (for example, 1-4). It is also possible to com‐
110 bine ranges and (individual or multiple) processor_ids
111 (for example, 1-3 5 7-8 9).
112
115 Example 1 Setting Processors to off-line
116 The following example sets processors 2 and 3 off-line:
119 % psradm -f 2 3
122 Example 2 Setting Processors to no-intr
126 The following example sets processors 1 and 2 no-intr:
129 % psradm -i 1 2
132 Example 3 Setting Processors to spare
136 The following example sets processors 1 and 2 spare, even if either of
139 the processors was in the faulted state:
140 % psradm -F -s 1 2
143 Example 4 Setting All Processors on-line
147 % psradm -a -n
149 Example 5 Forcing Processors to off-line
153 The following example sets processors 1 and 2 offline, and revokes the
156 processor bindings from the processes bound to them:
157 % psradm -F -f 1 2
160
164 The following exit values are returned:
165 0 Successful completion.
167 >0 An error occurred.
170
173 /etc/wtmpx Records logging processor status changes
174
177 See attributes(5) for descriptions of the following attributes:
178 ┌─────────────────────────────┬─────────────────────────────┐
183 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
184 ├─────────────────────────────┼─────────────────────────────┤
185 │Availability │SUNWcsu │
186 └─────────────────────────────┴─────────────────────────────┘
187
189 pbind(1M), psrinfo(1M), psrset(1M), p_online(2), processor_bind(2),
190 attributes(5)
191
193 psradm: processor 4: Invalid argument
194 The specified processor does not exist in the configuration.
196 psradm: processor 3: Device busy
199 The specified processor could not be taken off-line because it
201 either has LWPs bound to it, is the last on-line processor in the
202 system, or is needed by the system because it provides some essen‐
203 tial service.
204 psradm: processor 3: Device busy
207 The specified processor could not be set no-intr because it is the
209 last interruptible processor in the system, or or it is the only
210 processor in the system that can service interrupts needed by the
211 system.
212 psradm: processor 3: Device busy
215 The specified processor is powered off, and it cannot be powered on
217 because some platform-specific resource is unavailable.
218 psradm: processor 0: Not owner
221 The user does not have permission to change processor status.
223 psradm: processor 2: Operation not supported
226 The specified processor is powered off, and the platform does not
228 support power on of individual processors.
229SunOS 5.11 25 Feb 2008 psradm(1M)