renice - change priority of a running process


renice [-n increment] [-g|-p|-u] ID ...

renice nice_value [-p] pid [-g gid ...] [-p pid ...] [-u user] renice nice_value[-g gid] [-p pid ...] [-u user]
renice nice_value[-u user] [-p pid ...] [-u user]


The renice(1) command changes the priority of running processes; the processes can be specified by process identifier (ID), group ID, or user. The renice(1) command can only be run by a user with the appropriate privileges, and there is no way to get the appropriate privileges on Windows NT.

The first syntax given is the standard version; the other synopses reflect obsolescent versions. The change in priority is given by increment; if you do not give the -n option, the priority is not changed.

In the obsolescent versions, the priority of the processes is changed to nice_value, which is an absolute priority, not a change in priority.

The renice(1) utility takes the following options:

Treat all operands as process group IDs.
-n increment
Adjust the scheduling priority of the command by increment, a decimal integer. A positive value for increment lowers the priority; a negative value increases the priority.
Treat all operands as process IDs. This is the default if no options are specified.
Treat all operands as users, either as a user name (if a user exists with that name) or as a user ID.


On success, renice(1) exits with status 0; if an error occurred, it exits with status >0.