RENICE(1)               COMMAND REFERENCE               RENICE(1)



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 pid, pgrp, and user parameters are process
     ID's, process group ID's, or user names.  Executing renice
     on a process group causes all processes in the process group
     to have their scheduling priority altered.  (The process
     group ID is the process ID of the parent process.) Executing
     renice on a user causes all processes owned by the user to
     have their scheduling priority altered.  By default, the
     processes to be affected are specified by their process
     ID's.  To force parameters to be interpreted as process
     group ID's, a -g may be specified.  To force the parameters
     to be interpreted as user names, a -u may be given.
     Supplying -p will reset parameters to (the default) process
     ID's.

     Users other than the superuser can only alter the priority
     of processes they own, and can only monotonically increase
     their nice value within the range 0 to PRIO_MIN (20).  (This
     prevents overriding administrative fiats.) The superuser can
     alter the priority of any process and set the priority to
     any value in the range PRIO_MAX (-20) to PRIO_MIN (20).
     Useful priorities are: 19 (the affected processes will run
     only when nothing else in the system wants to); 0 (the base
     scheduling priority); and anything negative (to make things
     go very fast).

OPTIONS
     -gpgrp Interpret arguments up to the next option as process
            group ID's.

     -ppid  Interpret arguments up to the next option as process
            ID's.

     -uuser Interpret arguments up to the next option as user
            ID's.

EXAMPLES
     The following example changes the priority of process ID's
     987 and 32, and all processes owned by the user's daemon and
     root.

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





Printed 5/12/88                                                 1

RENICE(1)               COMMAND REFERENCE               RENICE(1)



FILES
     /etc/passwd
               Used to map user names to user ID's

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [P_WARN]       A system error occurred. Execution continues.
                    See intro(2) for more information on system
                    errors.

CAVEATS
     If you make the priority very negative, then the process
     cannot be interrupted.  To regain control, you make the
     priority greater than zero.

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

SEE ALSO
     nice(1), getpriority(2), and setpriority(2).






























Printed 5/12/88                                                 2

%%index%%
na:288,96;
sy:384,380;
de:764,1844;
op:2608,415;
ex:3023,283;
fi:3666,143;
rv:3809,442;
ca:4251,406;
se:4657,214;
%%index%%000000000147