]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
14179682 MB |
2 | //// |
3 | Copyright (c) 1983, 1991, 1993 | |
4 | The Regents of the University of California. All rights reserved. | |
5 | ||
6 | Redistribution and use in source and binary forms, with or without | |
7 | modification, are permitted provided that the following conditions | |
8 | are met: | |
9 | 1. Redistributions of source code must retain the above copyright | |
10 | notice, this list of conditions and the following disclaimer. | |
11 | 2. Redistributions in binary form must reproduce the above copyright | |
12 | notice, this list of conditions and the following disclaimer in the | |
13 | documentation and/or other materials provided with the distribution. | |
14 | 3. All advertising materials mentioning features or use of this software | |
15 | must display the following acknowledgement: | |
16 | This product includes software developed by the University of | |
17 | California, Berkeley and its contributors. | |
18 | 4. Neither the name of the University nor the names of its contributors | |
19 | may be used to endorse or promote products derived from this software | |
20 | without specific prior written permission. | |
21 | ||
22 | THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
23 | ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
24 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
25 | ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
26 | FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
27 | DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
28 | OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
29 | HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
30 | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
31 | OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
32 | SUCH DAMAGE. | |
33 | ||
34 | @(#)renice.8 8.1 (Berkeley) 6/9/93 | |
35 | //// | |
36 | = renice(1) | |
37 | :doctype: manpage | |
f42ed819 | 38 | :man manual: User Commands |
14179682 MB |
39 | :man source: util-linux {release-version} |
40 | :page-layout: base | |
41 | :command: renice | |
42 | ||
43 | == NAME | |
44 | ||
45 | renice - alter priority of running processes | |
46 | ||
47 | == SYNOPSIS | |
48 | ||
56ce8f61 | 49 | *renice* [*--priority|--relative*] _priority_ [*-g*|*-p*|*-u*] _identifier_... |
14179682 MB |
50 | |
51 | == DESCRIPTION | |
52 | ||
53 | *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 altered. | |
54 | ||
56ce8f61 DA |
55 | If no *-n*, *--priority* or *--relative* option is used, then the priority is set as *absolute*. |
56 | ||
14179682 MB |
57 | == OPTIONS |
58 | ||
56ce8f61 | 59 | *-n* _priority_:: |
9c8bf580 | 60 | Specify the *absolute* or *relative* (depending on environment variable POSIXLY_CORRECT) scheduling _priority_ to be used for the process, process group, or user. Use of the option *-n* is optional, but when used, it must be the first argument. See *NOTES* for more information. |
56ce8f61 DA |
61 | |
62 | *--priority* _priority_:: | |
63 | Specify an *absolute* scheduling _priority_. _Priority_ is set to the given value. This is the default, when no option is specified. | |
64 | ||
65 | *--relative* _priority_:: | |
9c8bf580 | 66 | Specify a *relative* scheduling _priority_. Same as the standard POSIX *-n* option. _Priority_ gets _incremented/decremented_ by the given value. |
14179682 MB |
67 | |
68 | *-g*, *--pgrp*:: | |
4eab78d3 | 69 | Interpret the succeeding arguments as process group IDs. |
14179682 MB |
70 | |
71 | *-p*, *--pid*:: | |
4eab78d3 | 72 | Interpret the succeeding arguments as process IDs (the default). |
14179682 MB |
73 | |
74 | *-u*, *--user*:: | |
4eab78d3 | 75 | Interpret the succeeding arguments as usernames or UIDs. |
14179682 | 76 | |
2b2d3172 | 77 | include::man-common/help-version.adoc[] |
14179682 MB |
78 | |
79 | == FILES | |
80 | ||
81 | _/etc/passwd_:: | |
4eab78d3 | 82 | to map user names to user IDs |
14179682 MB |
83 | |
84 | == NOTES | |
85 | ||
86 | 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 *getrlimit*(2)). | |
87 | ||
88 | 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). | |
89 | ||
9c8bf580 | 90 | For historical reasons in this implementation, the *-n* option did not follow the POSIX specification. Therefore, instead of setting a *relative* priority, it sets an *absolute* priority by default. As this may not be desirable, this behavior can be controlled by setting the environment variable POSIXLY_CORRECT to be fully POSIX compliant. See the *-n* option for details. See *--relative* and *--priority* for options that do not change behavior depending on environment variables. |
56ce8f61 | 91 | |
14179682 MB |
92 | == HISTORY |
93 | ||
94 | The *renice* command appeared in 4.0BSD. | |
95 | ||
96 | == EXAMPLES | |
97 | ||
98 | 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: | |
99 | ||
100 | *renice +1 987 -u daemon root -p 32* | |
101 | ||
102 | == SEE ALSO | |
103 | ||
104 | *nice*(1), | |
105 | *chrt*(1), | |
106 | *getpriority*(2), | |
107 | *setpriority*(2), | |
108 | *credentials*(7), | |
109 | *sched*(7) | |
110 | ||
625e9c61 | 111 | include::man-common/bugreports.adoc[] |
14179682 | 112 | |
625e9c61 | 113 | include::man-common/footer.adoc[] |
14179682 MB |
114 | |
115 | ifdef::translation[] | |
625e9c61 | 116 | include::man-common/translation.adoc[] |
14179682 | 117 | endif::[] |