1 '\" te
2 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
4 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH PRCTL 1 "Aug 25, 2009"
7 .SH NAME
8 prctl \- get or set the resource controls of running processes, tasks, and
9 projects
10 .SH SYNOPSIS
11 .LP
12 .nf
13 \fBprctl\fR [\fB-P\fR] [\fB-t\fR [basic | privileged | system]]
14 [\fB-n\fR \fIname\fR [\fB-srx\fR] [\fB-v\fR \fIvalue\fR] [\fB-e\fR | \fB-d\fR \fIaction\fR] [\fB-p\fR \fIpid\fR]]
15 [\fB-i\fR \fIidtype\fR] \fIid\fR...
16 .fi
17
18 .SH DESCRIPTION
19 .sp
20 .LP
21 The \fBprctl\fR utility allows the examination and modification of the resource
22 controls associated with an active process, task, or project on the system. It
23 allows access to the basic and privileged limits and the current usage on
24 the specified entity.
25 .sp
26 .LP
27 See \fBresource_controls\fR(5) for a description of the resource controls
28 supported in the current release of the Solaris operating system.
29 .SH OPTIONS
30 .sp
31 .LP
32 If none of the \fB-s\fR, \fB-r\fR, \fB-x\fR, \fB-v\fR, \fB-d\fR, or \fB-e\fR
33 options are specified, the invocation is considered a get operation. Otherwise,
34 it is considered a modify operation.
35 .sp
36 .LP
37 The following options are supported:
38 .sp
39 .ne 2
40 .na
41 \fB\fB-d\fR | \fB-e\fR \fIaction\fR\fR
42 .ad
43 .sp .6
44 .RS 4n
45 Disables (\fB-d\fR) or enables (\fB-e\fR) the specified \fIaction\fR on the
46 resource control value specified by \fB-v\fR, \fB-t\fR, and \fB-p\fR. If any of
47 the \fB-v\fR, \fB-t\fR, or \fB-p\fR options are unspecified, they match any
48 value, privilege, or recipient pid. For example, specifying only \fB-v\fR
49 modifies the first resource control with matching value, matching any privilege
50 and recipient pid. If no matching resource control value is found, a new value
51 is added as if \fB-s\fR were specified.
52 .sp
53 \fBActions:\fR
54 .sp
55 .ne 2
56 .na
222 See \fBresource_controls\fR(5) for a description of unit modifiers and scaling
223 factors you can use to express large values when setting a resource control
224 value.
225 .RE
226
227 .sp
228 .ne 2
229 .na
230 \fB\fB-x\fR\fR
231 .ad
232 .sp .6
233 .RS 4n
234 Deletes the specified resource control value. If the delete option is not
235 provided, the default operation of \fBprctl\fR is to modify a resource control
236 value of matching value and privilege, or insert a new value with the given
237 privilege. The matching criteria are discussed more fully in \fBsetrctl\fR(2).
238 .RE
239
240 .sp
241 .LP
242 If none of the \fB-d\fR, \fB-e\fR, \fB-v\fR, or \fB-x\fR options is specified,
243 the invocation is considered a get operation.
244 .SH OPERANDS
245 .sp
246 .LP
247 The following operand is supported:
248 .sp
249 .ne 2
250 .na
251 \fB\fIid\fR\fR
252 .ad
253 .RS 6n
254 The \fBID\fR of the entity (\fBprocess\fR, \fBtask\fR, \fBproject\fR, or
255 \fBzone\fR) to interrogate. If the invoking user's credentials are unprivileged
256 and the entity being interrogated possesses different credentials, the
257 operation fails. If no \fIid\fR is specified, an error message is returned.
258 .RE
259
260 .SH EXAMPLES
261 .LP
262 \fBExample 1 \fRDisplaying Current Resource Control Settings
263 .sp
|
1 '\" te
2 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
4 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH PRCTL 1 "Oct 30, 2013"
7 .SH NAME
8 prctl \- get or set the resource controls of running processes, tasks, and
9 projects
10 .SH SYNOPSIS
11 .LP
12 .nf
13 \fBprctl\fR [\fB-P\fR] [\fB-t\fR [basic | privileged | system]]
14 [\fB-n\fR \fIname\fR [\fB-srx\fR] [\fB-v\fR \fIvalue\fR] [\fB-e\fR | \fB-d\fR \fIaction\fR] [\fB-p\fR \fIpid\fR]]
15 [\fB-i\fR \fIidtype\fR] \fIid\fR...
16 .fi
17
18 .SH DESCRIPTION
19 .sp
20 .LP
21 The \fBprctl\fR utility allows the examination and modification of the resource
22 controls associated with an active process, task, or project on the system. It
23 allows access to the basic and privileged limits and the current usage on
24 the specified entity.
25 .sp
26 .LP
27 See \fBresource_controls\fR(5) for a description of the resource controls
28 supported in the current release of the Solaris operating system.
29 .SH OPTIONS
30 .sp
31 .LP
32 The following options are supported:
33 .sp
34 .ne 2
35 .na
36 \fB\fB-d\fR | \fB-e\fR \fIaction\fR\fR
37 .ad
38 .sp .6
39 .RS 4n
40 Disables (\fB-d\fR) or enables (\fB-e\fR) the specified \fIaction\fR on the
41 resource control value specified by \fB-v\fR, \fB-t\fR, and \fB-p\fR. If any of
42 the \fB-v\fR, \fB-t\fR, or \fB-p\fR options are unspecified, they match any
43 value, privilege, or recipient pid. For example, specifying only \fB-v\fR
44 modifies the first resource control with matching value, matching any privilege
45 and recipient pid. If no matching resource control value is found, a new value
46 is added as if \fB-s\fR were specified.
47 .sp
48 \fBActions:\fR
49 .sp
50 .ne 2
51 .na
217 See \fBresource_controls\fR(5) for a description of unit modifiers and scaling
218 factors you can use to express large values when setting a resource control
219 value.
220 .RE
221
222 .sp
223 .ne 2
224 .na
225 \fB\fB-x\fR\fR
226 .ad
227 .sp .6
228 .RS 4n
229 Deletes the specified resource control value. If the delete option is not
230 provided, the default operation of \fBprctl\fR is to modify a resource control
231 value of matching value and privilege, or insert a new value with the given
232 privilege. The matching criteria are discussed more fully in \fBsetrctl\fR(2).
233 .RE
234
235 .sp
236 .LP
237 If none of the \fB-s\fR, \fB-r\fR, \fB-x\fR, \fB-v\fR, \fB-d\fR, or \fB-e\fR
238 options are specified, the invocation is considered a get operation. Otherwise,
239 it is considered a modify operation.
240 .SH OPERANDS
241 .sp
242 .LP
243 The following operand is supported:
244 .sp
245 .ne 2
246 .na
247 \fB\fIid\fR\fR
248 .ad
249 .RS 6n
250 The \fBID\fR of the entity (\fBprocess\fR, \fBtask\fR, \fBproject\fR, or
251 \fBzone\fR) to interrogate. If the invoking user's credentials are unprivileged
252 and the entity being interrogated possesses different credentials, the
253 operation fails. If no \fIid\fR is specified, an error message is returned.
254 .RE
255
256 .SH EXAMPLES
257 .LP
258 \fBExample 1 \fRDisplaying Current Resource Control Settings
259 .sp
|