Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at
http://www.opengroup.org/bookstore/.
The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
This notice shall appear on any product containing this material.
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. 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 the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
renice [-n increment] [-i idtype] ID...
renice [-n increment] [-g | -p | -u] ID...
renice priority [-p] pid... [-g gid]... [-p pid]... [-u user]...
renice priority -g gid... [-g gid]... [-p pid]... [-u user]...
renice priority -u user... [-g gid]... [-p pid]... [-u user]...
The renice command alters the scheduling priority of one or more running processes. By default, the processes to be affected are specified by their process IDs.
If the first operand is a number within the valid range of priorities (-20 to 20), renice will treat it as a priority (as in all but the first synopsis form). Otherwise, renice will treat it as an ID (as in the first synopsis form).
Users other than the privileged user may only alter the priority of processes they own, and can only monotonically increase their "nice value" within the range 0 to 19. This prevents overriding administrative fiats. The privileged user may alter the priority of any process and set the priority to any value in the range -20 to 19. Useful priorities are: 19 (the affected processes will run only when nothing else in the system wants to); 0 (the "base" scheduling priority),; and any negative value (to make things go very fast). 20 is an acceptable nice value, but will be rounded down to 19.
renice supports the following option features:
The first operand, priority, must precede the options and can have the appearance of a multi-digit option.
The -g, -p, and -u options can each take multiple option-arguments.
The pid option-argument can be used without its -p option.
The -i option can be used to specify the ID type for the ID list. This is preferred in specifying ID type over the use of the -g | -p | -u syntax, which is now obsolete. See NOTES.
The following options are supported:
-g
Interprets all operands or just the gid arguments as unsigned decimal integer process group IDs.
-i
This option, together with the ID list arguments, specifies a class of processes to which the renice command is to apply. The interpretation of the ID list depends on the value of idtype. The valid idtype arguments are: pid, pgid, uid, gid, sid, taskid, projid, and zoneid.
-n increment
Specifies how the system scheduling priority of the specified process or processes is to be adjusted. The increment option-argument is a positive or negative decimal integer that will be used to modify the system scheduling priority of the specified process or processes. Positive increment values cause a lower system scheduling priority. Negative increment values may require appropriate privileges and will cause a higher system scheduling priority.
-p
Interprets all operands or just the pid arguments as unsigned decimal integer process IDs. The -p option is the default if no options are specified.
-u
Interprets all operands or just the user argument as users. If a user exists with a user name equal to the operand, then the user ID of that user will be used in further processing. Otherwise, if the operand represents an unsigned decimal integer, it will be used as the numeric user ID of the user.
The following operands are supported:
ID
priority
The value specified is taken as the actual system scheduling priority, rather than as an increment to the existing system scheduling priority. Specifying a scheduling priority higher than that of the existing process may require appropriate privileges.
Example 1 Adjusting the scheduling priority of process IDs
Adjust the system scheduling priority so that process IDs 987 and 32 would have a lower scheduling priority:
example% renice -n 5 -p 987 32
Example 2 Adjusting the scheduling priority of group IDs
Adjust the system scheduling priority so that group IDs 324 and 76 would have a higher scheduling priority, if the user has the appropriate privileges to do so:
example% renice -n -4 -g 324 76
Example 3 Adjusting the scheduling priority of a user ID and user name
Adjust the system scheduling priority so that numeric user ID 8 and user sas would have a lower scheduling priority:
example% renice -n 4 -u 8 sas
See environ(5) for descriptions of the following environment variables that affect the execution of renice: LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, and NLSPATH.
The following exit values are returned:
0
Successful completion.
>0
An error occurred.
map user names to user IDs
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Interface Stability | Standard |
nice(1), passwd(1), priocntl(1), attributes(5), environ(5), standards(5)
The renice syntax
renice [-n increment] [-i idtype] ID ...
is preferred over the old syntax
renice [-n increment] [-g | -p| -u] ID ...
which is now obsolete.
If you make the priority very negative, then the process cannot be interrupted.
To regain control you must make the priority greater than 0.
Users other than the privileged user cannot increase scheduling priorities of their own processes, even if they were the ones that decreased the priorities in the first place.
The priocntl command subsumes the function of renice.