1psradm(1M)              System Administration Commands              psradm(1M)
2
3
4

NAME

6       psradm - change processor operational status
7

SYNOPSIS

9       psradm -f | -i | -n | -s [-v] [-F] processor_id
10
11
12       psradm -a -f | -i | -n | -s [-v] [-F]
13
14

DESCRIPTION

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
20
21       An  on-line processor processes LWPs (lightweight processes) and can be
22       interrupted by I/O devices in the system.
23
24
25       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
31
32       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
36
37       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
42
43       A  no-intr  processor  processes  LWPs  but is not interruptible by I/O
44       devices.
45
46
47       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
55
56       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
62
63       If any of the specified processors are powered off, psradm might  power
64       on one or more processors.
65
66
67       Only  users  with  the PRIV_SYS_RES_CONFIG privilege can use the psradm
68       utility.
69

OPTIONS

71       The following options are supported:
72
73       -a    Perform the action on all processors, or as many as possible.
74
75
76       -f    Take the specified processors off-line.
77
78
79       -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
87
88       -i    Set the specified processors no-intr.
89
90
91       -n    Bring the specified processors on-line.
92
93
94       -s    Make the specified processors spare.
95
96
97       -v    Output a message giving the results of each attempted operation.
98
99

OPERANDS

101       The following operands are supported:
102
103       processor_id    The processor ID of the processor to be set on-line  or
104                       off-line, spare, or no-intr.
105
106                       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
113

EXAMPLES

115       Example 1 Setting Processors to off-line
116
117
118       The following example sets processors 2 and 3 off-line:
119
120
121         % psradm -f 2 3
122
123
124
125       Example 2 Setting Processors to no-intr
126
127
128       The following example sets processors 1 and 2 no-intr:
129
130
131         % psradm -i 1 2
132
133
134
135       Example 3 Setting Processors to spare
136
137
138       The following example sets processors 1 and 2 spare, even if either  of
139       the processors was in the faulted state:
140
141
142         % psradm -F -s 1 2
143
144
145
146       Example 4 Setting All Processors on-line
147
148         % psradm -a -n
149
150
151
152       Example 5 Forcing Processors to off-line
153
154
155       The  following example sets processors 1 and 2 offline, and revokes the
156       processor bindings from the processes bound to them:
157
158
159         % psradm -F -f 1 2
160
161
162

EXIT STATUS

164       The following exit values are returned:
165
166       0     Successful completion.
167
168
169       >0    An error occurred.
170
171

FILES

173       /etc/wtmpx    Records logging processor status changes
174
175

ATTRIBUTES

177       See attributes(5) for descriptions of the following attributes:
178
179
180
181
182       ┌─────────────────────────────┬─────────────────────────────┐
183       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
184       ├─────────────────────────────┼─────────────────────────────┤
185       │Availability                 │SUNWcsu                      │
186       └─────────────────────────────┴─────────────────────────────┘
187

SEE ALSO

189       pbind(1M),  psrinfo(1M),  psrset(1M),  p_online(2),  processor_bind(2),
190       attributes(5)
191

DIAGNOSTICS

193       psradm: processor 4: Invalid argument
194
195           The specified processor does not exist in the configuration.
196
197
198       psradm: processor 3: Device busy
199
200           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
205
206       psradm: processor 3: Device busy
207
208           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
213
214       psradm: processor 3: Device busy
215
216           The specified processor is powered off, and it cannot be powered on
217           because some platform-specific resource is unavailable.
218
219
220       psradm: processor 0: Not owner
221
222           The user does not have permission to change processor status.
223
224
225       psradm: processor 2: Operation not supported
226
227           The specified processor is powered off, and the platform  does  not
228           support power on of individual processors.
229
230
231
232
233SunOS 5.11                        25 Feb 2008                       psradm(1M)
Impressum