RENICE(8,C)                 AIX Commands Reference                  RENICE(8,C)



-------------------------------------------------------------------------------
renice



PURPOSE

Alters priority of running processes.

SYNTAX


                         +------+
                       +-|      |--- pid ----+
                       | +- -p -+ ^        | |
                       |          +--------+ |
                       | +------+            |
renice --- priority ---+-|      |--- pgrp ---+---|
                     ^ | +- -q -+ ^        | | |
                     | |          +--------+ | |
                     | | +------+            | |
                     | +-|      |--- user ---+ |
                     |   +- -u -+ ^        |   |
                     |            +--------+   |
                     +-------------------------+


Warning: See restrictions, Chapter 18, AIX Programming Tools and Interfaces.

DESCRIPTION

The renice command alters the scheduling priority of one or more running
processes.  The who parameters are interpreted as process IDs, process group
IDs, or user names.  When you renice a process group it causes all processes in
the process group to have their scheduling priority altered.  When you renice a
user it 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 IDs.  To force who parameters to be interpreted as process group
IDs, a -g may be specified.  To force the who parameters to be interpreted as
user names, a -u may be given.  Supplying the -p will reset who interpretation
to be (the default) process IDs.  For example,

    renice +1 987 -u daemon root -p 32

would change the priority of process IDs 987 and 32, and all processes owned by
users daemon and root.

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



Processed November 8, 1990        RENICE(8,C)                                 1

RENICE(8,C)                 AIX Commands Reference                  RENICE(8,C)



only when nothing else in the system wants to), 0 (the "base" scheduling
priority), anything negative (to make things go very fast).

These values are mapped by the command to those actually used by the kernel.

FILES

/etc/passwd To map user names to user IDs

RELATED INFORMATION

See the following command:  "nice."

See "getpriority" "setpriority" in nice in AIX Technical Reference.









































Processed November 8, 1990        RENICE(8,C)                                 2