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

EXAMPLES

42       The  following  command would change the priority of the processes with
43       PIDs 987 and 32, plus all processes owned by the users daemon and root:
44
45              renice +1 987 -u daemon root -p 32
46

NOTES

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

FILES

61       /etc/passwd
62              to map user names to user IDs
63

SEE ALSO

65       nice(1), getpriority(2), setpriority(2), credentials(7), sched(7)
66

HISTORY

68       The renice command appeared in 4.0BSD.
69

AVAILABILITY

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