renice - Alters the priority of a running process
The following syntax format is recommended:
/usr/sbin/renice [-n increment] [-p] [-g | -u] ID...
The following syntax format is obsolescent:
/usr/sbin/renice priority [-p] pid... [-g pgrp...] [-u
user...]
Interfaces documented on this reference page conform to
industry standards as follows:
renice: XCU5.0
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
Takes the current priority and adds the increment. A negative
value for increment causes the process to run at a
lower numbered, therefore faster, priority. Interprets
operands following the option as process group IDs.
Interprets operands following the option as user names.
Resets renice operand interpretation to be process IDs
(the default).
A value interpreted as the actual system scheduling priority,
rather than as an increment to the existing system
scheduling priority as specified in the recommended form
of the command. The priority value may be any integer from
-20 to 20, including 0, as explained in the DESCRIPTION
section. A user name or user ID. All processes with a
set_user_ID equal to the specified value are affected. A
process group ID. All processes in the process group are
affected. A process ID. Only this process is affected.
A value interpreted as a user name, user ID, a process
group ID, or a process ID, depending on the option specified.
If no options are specified, the value is interpreted
as a process ID.
The renice command alters the scheduling priority of one
or more running processes. The ID operands (in the recommended
syntax format) or the option arguments (in the
obsolescent syntax format) are interpreted as process IDs,
process group IDs, or user names. When you issue the
renice command with the -g option, all processes in the
process group have their scheduling priority altered.
When you run the renice command with the -u option, all
processes owned by the user have their scheduling priority
altered. By default, the processes affected are specified
by their process IDs.
Only root can alter the priority of other user's processes
and can set the priority to any value in the range from
-20 to 20. Users without root privileges are restricted
to altering the priority of processes they own and can
only increase their "nice value" within the range of 0 to
20.
The following priorities are particularly useful: Runs
affected processes when no other processes are running on
the system. Runs at the base scheduling priority. Runs
affected processes very quickly.
[Tru64 UNIX] The preceding values are mapped by the command
to those actually used by the kernel.
[Tru64 UNIX] Users who do not have root privileges cannot
increase the scheduling priorities of their own processes
(even if they had originally decreased those priorities).
The following exit values are returned:
Successful completion An error occurred
To change the priority of process IDs 987 and 32, and all
processes owned by the daemon and root users, enter:
renice +1 987 -u daemon root -p 32
ENVIRONMENT VARIABLES [Toc] [Back] The following environment variables affect the execution
of renice: Provides a default value for the internationalization
variables that are unset or null. If LANG is unset
or null, the corresponding value from the default locale
is used. If any of the internationalization variables contain
an invalid setting, the utility behaves as if none of
the variables had been defined. If set to a non-empty
string value, overrides the values of all the other internationalization
variables. Determines the locale for the
interpretation of sequences of bytes of text data as characters
(for example, single-byte as opposed to multibyte
characters in arguments). Determines the locale for the
format and contents of diagnostic messages written to
standard error. Determines the location of message catalogues
for the processing of LC_MESSAGES.
Specifies the command path
Commands: nice(1)
Functions: getpriority(2)
Others: standards(5)
renice(8)
[ Back ] | 