]>
Commit | Line | Data |
---|---|---|
6dbe3af9 KZ |
1 | .\" Copyright (c) 1983, 1991, 1993 |
2 | .\" The Regents of the University of California. All rights reserved. | |
3 | .\" | |
4 | .\" Redistribution and use in source and binary forms, with or without | |
5 | .\" modification, are permitted provided that the following conditions | |
6 | .\" are met: | |
7 | .\" 1. Redistributions of source code must retain the above copyright | |
8 | .\" notice, this list of conditions and the following disclaimer. | |
9 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
10 | .\" notice, this list of conditions and the following disclaimer in the | |
11 | .\" documentation and/or other materials provided with the distribution. | |
12 | .\" 3. All advertising materials mentioning features or use of this software | |
13 | .\" must display the following acknowledgement: | |
14 | .\" This product includes software developed by the University of | |
15 | .\" California, Berkeley and its contributors. | |
16 | .\" 4. Neither the name of the University nor the names of its contributors | |
17 | .\" may be used to endorse or promote products derived from this software | |
18 | .\" without specific prior written permission. | |
19 | .\" | |
20 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
21 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
22 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
23 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
24 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
25 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
26 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
27 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
28 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
30 | .\" SUCH DAMAGE. | |
31 | .\" | |
3a60b1c2 | 32 | .\" @(#)renice.8 8.1 (Berkeley) 6/9/93 |
6dbe3af9 | 33 | .\" |
cf8e0bae | 34 | .TH RENICE "1" "July 2014" "util-linux" "User Commands" |
9ef94a60 SK |
35 | .SH NAME |
36 | renice \- alter priority of running processes | |
37 | .SH SYNOPSIS | |
38 | .B renice | |
5cc224f5 BS |
39 | .RB [ \-n ] |
40 | .I priority | |
cf8e0bae | 41 | .RB [ \-g | \-p | \-u ] |
5cc224f5 | 42 | .IR identifier ... |
9ef94a60 | 43 | .SH DESCRIPTION |
5cc224f5 | 44 | .B renice |
9ef94a60 | 45 | alters the scheduling priority of one or more running processes. The |
5cc224f5 BS |
46 | first argument is the \fIpriority\fR value to be used. |
47 | The other arguments are interpreted as process IDs (by default), | |
48 | process group IDs, user IDs, or user names. | |
49 | .BR renice 'ing | |
9ef94a60 SK |
50 | a process group causes all processes in the process group to have their |
51 | scheduling priority altered. | |
5cc224f5 | 52 | .BR renice 'ing |
9ef94a60 | 53 | a user causes all processes owned by the user to have their scheduling |
5cc224f5 | 54 | priority altered. |
9ef94a60 SK |
55 | .PP |
56 | .SH OPTIONS | |
57 | .TP | |
5cc224f5 BS |
58 | .BR \-n , " \-\-priority " \fIpriority\fR |
59 | Specify the scheduling | |
9ef94a60 | 60 | .I priority |
5cc224f5 | 61 | to be used for the process, process group, or user. Use of the option |
9ef94a60 | 62 | .BR \-n " or " \-\-priority |
5cc224f5 | 63 | is optional, but when used it must be the first argument. |
9ef94a60 | 64 | .TP |
cf8e0bae BS |
65 | .BR \-g , " \-\-pgrp |
66 | Interpret the succeeding arguments as process group IDs. | |
9ef94a60 | 67 | .TP |
cf8e0bae BS |
68 | .BR \-p , " \-\-pid |
69 | Interpret the succeeding arguments as process IDs | |
5cc224f5 | 70 | (the default). |
9ef94a60 | 71 | .TP |
cf8e0bae BS |
72 | .BR \-u , " \-\-user |
73 | Interpret the succeeding arguments as usernames or UIDs. | |
74 | .TP | |
5cc224f5 | 75 | .BR \-V , " \-\-version" |
b4362b6f | 76 | Display version information and exit. |
5e43af7e BS |
77 | .TP |
78 | .BR \-h , " \-\-help" | |
79 | Display help text and exit. | |
67e63c12 | 80 | .SH FILES |
9ef94a60 | 81 | .TP |
67e63c12 MK |
82 | .I /etc/passwd |
83 | to map user names to user IDs | |
9ef94a60 | 84 | .SH NOTES |
bb3e5808 | 85 | Users other than the superuser may only alter the priority of processes they |
f0742932 MK |
86 | own. Furthermore, an unprivileged user can only |
87 | .I increase | |
88 | the ``nice value'' (i.e., choose a lower priority) | |
89 | and such changes are irreversible unless (since Linux 2.6.12) | |
90 | the user has a suitable ``nice'' resource limit (see | |
dbeb1d73 | 91 | .BR ulimit (1p) |
f0742932 MK |
92 | and |
93 | .BR getrlimit (2)). | |
94 | ||
95 | The superuser may alter the priority of any process and set the priority to any | |
e8f34803 PS |
96 | value in the range \-20 to 19. |
97 | Useful priorities are: 19 (the affected processes will run only when nothing | |
9ef94a60 SK |
98 | else in the system wants to), 0 (the ``base'' scheduling priority), anything |
99 | negative (to make things go very fast). | |
ade04bb8 MK |
100 | .SH HISTORY |
101 | The | |
102 | .B renice | |
103 | command appeared in 4.0BSD. | |
67e63c12 MK |
104 | .SH EXAMPLE |
105 | The following command would change the priority of the processes with | |
106 | PIDs 987 and 32, plus all processes owned by the users daemon and root: | |
107 | .TP | |
108 | .B " renice" +1 987 \-u daemon root \-p 32 | |
9ef94a60 | 109 | .SH SEE ALSO |
51278ec0 | 110 | .BR nice (1), |
d6cfb754 | 111 | .BR chrt (1), |
9ef94a60 | 112 | .BR getpriority (2), |
248874b1 | 113 | .BR setpriority (2), |
c0cf01b5 | 114 | .BR credentials (7), |
248874b1 | 115 | .BR sched (7) |
9ef94a60 | 116 | .SH AVAILABILITY |
601d12fb | 117 | The renice command is part of the util-linux package and is available from |
d673b74e | 118 | .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |
9ef94a60 SK |
119 | Linux Kernel Archive |
120 | .UE . |