]>
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. | |
9ef94a60 | 80 | .SH EXAMPLES |
5cc224f5 BS |
81 | The following command would change the priority of the processes with |
82 | PIDs 987 and 32, plus all processes owned by the users daemon and root: | |
9ef94a60 | 83 | .TP |
1c4c6024 | 84 | .B " renice" +1 987 \-u daemon root \-p 32 |
9ef94a60 | 85 | .SH NOTES |
bb3e5808 | 86 | Users other than the superuser may only alter the priority of processes they |
f0742932 MK |
87 | own. Furthermore, an unprivileged user can only |
88 | .I increase | |
89 | the ``nice value'' (i.e., choose a lower priority) | |
90 | and such changes are irreversible unless (since Linux 2.6.12) | |
91 | the user has a suitable ``nice'' resource limit (see | |
dbeb1d73 | 92 | .BR ulimit (1p) |
f0742932 MK |
93 | and |
94 | .BR getrlimit (2)). | |
95 | ||
96 | The superuser may alter the priority of any process and set the priority to any | |
e8f34803 PS |
97 | value in the range \-20 to 19. |
98 | Useful priorities are: 19 (the affected processes will run only when nothing | |
9ef94a60 SK |
99 | else in the system wants to), 0 (the ``base'' scheduling priority), anything |
100 | negative (to make things go very fast). | |
101 | .SH FILES | |
102 | .TP | |
46f057ed | 103 | .I /etc/passwd |
5cc224f5 | 104 | to map user names to user IDs |
9ef94a60 | 105 | .SH SEE ALSO |
51278ec0 | 106 | .BR nice (1), |
9ef94a60 | 107 | .BR getpriority (2), |
248874b1 | 108 | .BR setpriority (2), |
c0cf01b5 | 109 | .BR credentials (7), |
248874b1 | 110 | .BR sched (7) |
9ef94a60 | 111 | .SH HISTORY |
6dbe3af9 | 112 | The |
9ef94a60 SK |
113 | .B renice |
114 | command appeared in 4.0BSD. | |
115 | .SH AVAILABILITY | |
601d12fb | 116 | The renice command is part of the util-linux package and is available from |
d673b74e | 117 | .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |
9ef94a60 SK |
118 | Linux Kernel Archive |
119 | .UE . |