1RENICE(1)                        User Commands                       RENICE(1)
2
3
4

NAME

6       renice - alter priority of running processes
7

SYNOPSIS

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

DESCRIPTION

12       renice alters the scheduling priority of one or more running processes.
13       The first argument is the priority value to be used.  The  other  argu‐
14       ments  are  interpreted as process IDs (by default), process group IDs,
15       user IDs, or user names.  renice'ing a process group  causes  all  pro‐
16       cesses  in the process group to have their scheduling priority altered.
17       renice'ing a user causes all processes owned by the user to have  their
18       scheduling priority altered.
19

OPTIONS

21       -n, --priority priority
22              Specify  the  scheduling  priority  to  be used for the process,
23              process group, or user.  Use of the option -n or  --priority  is
24              optional, but when used it must be the first argument.
25
26       -g, --pgrp
27              Interpret the succeeding arguments as process group IDs.
28
29       -p, --pid
30              Interpret the succeeding arguments as process IDs (the default).
31
32       -u, --user
33              Interpret the succeeding arguments as usernames or UIDs.
34
35       -V, --version
36              Display version information and exit.
37
38       -h, --help
39              Display help text and exit.
40

FILES

42       /etc/passwd
43              to map user names to user IDs
44

NOTES

46       Users other than the superuser may only alter the priority of processes
47       they own.  Furthermore, an unprivileged  user  can  only  increase  the
48       ``nice  value''  (i.e.,  choose  a lower priority) and such changes are
49       irreversible unless (since  Linux  2.6.12)  the  user  has  a  suitable
50       ``nice'' resource limit (see ulimit(1p) and getrlimit(2)).
51
52       The  superuser may alter the priority of any process and set the prior‐
53       ity to any value in the range -20 to 19.   Useful  priorities  are:  19
54       (the  affected  processes will run only when nothing else in the system
55       wants to), 0 (the ``base'' scheduling priority), anything negative  (to
56       make things go very fast).
57

HISTORY

59       The renice command appeared in 4.0BSD.
60

EXAMPLES

62       The  following  command would change the priority of the processes with
63       PIDs 987 and 32, plus all processes owned by the users daemon and root:
64
65              renice +1 987 -u daemon root -p 32
66

SEE ALSO

68       nice(1),  chrt(1),  getpriority(2),   setpriority(2),   credentials(7),
69       sched(7)
70

AVAILABILITY

72       The  renice  command is part of the util-linux package and is available
73       from Linux Kernel Archive ⟨https://www.kernel.org/pub/linux/utils/util-
74       linux/⟩.
75
76
77
78util-linux                         July 2014                         RENICE(1)
Impressum