renice(1) — Linux manual page


RENICE(1)                     User Commands                    RENICE(1)

NAME         top

       renice - alter priority of running processes

SYNOPSIS         top

       renice [-n] priority [-g|-p|-u] identifier...

DESCRIPTION         top

       renice alters the scheduling priority of one or more running
       processes.  The first argument is the priority value to be used.
       The other arguments are interpreted as process IDs (by default),
       process group IDs, user IDs, or user names.  renice'ing a process
       group causes all processes in the process group to have their
       scheduling priority altered.  renice'ing a user causes all
       processes owned by the user to have their scheduling priority

OPTIONS         top

       -n, --priority priority
              Specify the scheduling priority to be used for the
              process, process group, or user.  Use of the option -n or
              --priority is optional, but when used it must be the first

       -g, --pgrp
              Interpret the succeeding arguments as process group IDs.

       -p, --pid
              Interpret the succeeding arguments as process IDs (the

       -u, --user
              Interpret the succeeding arguments as usernames or UIDs.

       -V, --version
              Display version information and exit.

       -h, --help
              Display help text and exit.

FILES         top

              to map user names to user IDs

NOTES         top

       Users other than the superuser may only alter the priority of
       processes they own.  Furthermore, an unprivileged user can only
       increase the ``nice value'' (i.e., choose a lower priority) and
       such changes are irreversible unless (since Linux 2.6.12) the
       user has a suitable ``nice'' resource limit (see ulimit(1p) and

       The superuser may alter the priority of any process and set the
       priority to any value in the range -20 to 19.  Useful priorities
       are: 19 (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).

HISTORY         top

       The renice command appeared in 4.0BSD.

EXAMPLES         top

       The following command would change the priority of the processes
       with PIDs 987 and 32, plus all processes owned by the users
       daemon and root:

              renice +1 987 -u daemon root -p 32

SEE ALSO         top

       nice(1), chrt(1), getpriority(2), setpriority(2), credentials(7),

AVAILABILITY         top

       The renice command is part of the util-linux package and is
       available from Linux Kernel Archive 

COLOPHON         top

       This page is part of the util-linux (a random collection of Linux
       utilities) project.  Information about the project can be found
       at ⟨⟩.  If you
       have a bug report for this manual page, send it to  This page was obtained from the
       project's upstream Git repository
       ⟨git://⟩ on
       2021-03-21.  (At that time, the date of the most recent commit
       that was found in the repository was 2021-03-19.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to

util-linux                      July 2014                      RENICE(1)

Pages that refer to this page: chrt(1)kill(1@@procps-ng)nice(1)skill(1)taskset(1)uclampset(1)getpriority(2)nice(2)