renice

NAME

renice - Windows command-line utility to set the scheduling priorities of running processes

SYNOPSIS

renice [-n increment] 
	 {-g groupname... | -j jobname... | -u username... | [-p] pid...}

renice {-n increment | nicevalue} [-p] pid... [-g groupname...] 
	 [-p pid...] [-j jobname...] [-u username...]

renice {-n increment | nicevalue} -g groupname... [-g groupname...] 
	 [-p pid...] [-j jobname...] [-u username...]

renice {-n increment | nicevalue} -u username... [-g groupname...] 
	 [-p pid...] [-j jobname...] [-u username...]

DESCRIPTION

The renice(1w) utility requests that the scheduling priorities of one or more running processes be changed.

To use renice, the user must have permission to increase scheduling priority. For information about how to grant this permission, refer to the Windows operating system documentation.

If increment is specified, the scheduling priority of the process is computed based on the base priority of the process and the increment specified. If nicevalue is specified, it is taken as the scheduling priority. The utility is invoked with this scheduling priority. If this value exceeds the range (above real time (32) or below idle (0)), the utility is invoked with real time or idle priority as appropriate, and displays a warning message.

The renice utility will not alter the scheduling priorities of any process unless the user requesting such a change has appropriate permission to do so.

OPTIONS

The renice utility supports the following options:

-n
Specifies how the scheduling priority of the specified process or processes is to be adjusted.
-p
Interprets all operands as unsigned decimal integer PIDs. If no options are specified, the -p option is the default.
-u
Interprets all operands as user names.
-g
Interprets all operands as group names.
-j
Interprets all operands as job names. The -j option is valid only for Windows 2000.

ARGUMENTS

The renice utility supports the following arguments:

increment
The increment is a positive or negative decimal integer that is used to modify the scheduling priority of the specified process or processes. Positive increment values cause a lower scheduling priority. Negative increment values require appropriate permissions and will cause a higher scheduling priority.
nicevalue
The actual scheduling priority, in the range 0 to 32. The user must have appropriate permissions to specify a scheduling priority higher than that of the existing process.
pid
Unique process identifier of a process whose scheduling priority is to be changed.
username
User name of the process. When a user is reniced, the request applies to all processes whose user name matches the given username.
groupname
Group name. When a group is reniced, the request applies to all processes whose user name belongs to the given groupname.
jobname
Job name. When a job is reniced, the request applies to all processes of the job.

DIAGNOSTICS

Possible exit-status values are:

0
At least one requested process was reniced.
1
No process was reniced.

SEE ALSO

nice(1w)