RENICE(8)                            BSD                             RENICE(8)



NAME
     renice - alter priority of running processes

SYNOPSIS
     /etc/renice priority [ [ -p ] pid ... ] [ [ -g ] pgrp ... ] [ [ -u ] user
     ... ]

DESCRIPTION
     renice alters the scheduling priority of one or more running processes.
     The who parameters are interpreted as process IDs, process group IDs, or
     usernames.  Running renice on a process group alters the scheduling
     priority of all processes in the process group.  Running renice followed
     by a username alters the scheduling priority of all processes owned by
     the user.  By default, the processes to be affected are specified by
     their process IDs.

     Users other than the super-user may only alter the priority of processes
     they own, and can only monotonically increase their "nice value" within
     the range 0 to PRIO_MAX (20).  (This prevents overriding administrative
     fiats.)  The super-user may alter the priority of any process and set the
     priority to any value in the range PRIO_MIN (-20) to PRIO_MAX.  Useful
     priorities are:

     ⊕  20 (the affected processes will run only when nothing else in the
        system wants to)
     ⊕  0 (the "base" scheduling priority)
     ⊕  Anything negative (to make things go very fast)


OPTIONS
     -g        Force who parameters to be interpreted as process group IDs.

     -u        Force the who parameters to be interpreted as user names.

     -p        Reset who interpretation to process IDs (the default).

EXAMPLE
     The following example changes the priority of process IDs 987 and 32, and
     all processes owned by users daemon and root.

     /etc/renice +1 987 -u daemon root -p 32


BUGS
     Non super-users can not increase scheduling priorities of their own
     processes, even if they were the ones that decreased the priorities in
     the first place.

FILES
     /etc/passwd    to map usernames to user IDs

SEE ALSO
     getpriority(2), setpriority(2)