120 lines
4.4 KiB
Groff
120 lines
4.4 KiB
Groff
.\" Copyright (c) 1983, 1991, 1993
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" @(#)renice.8 8.1 (Berkeley) 6/9/93
|
|
.\"
|
|
.TH RENICE "1" "July 2014" "util-linux" "User Commands"
|
|
.SH NAME
|
|
renice \- alter priority of running processes
|
|
.SH SYNOPSIS
|
|
.B renice
|
|
.RB [ \-n ]
|
|
.I priority
|
|
.RB [ \-g | \-p | \-u ]
|
|
.IR identifier ...
|
|
.SH DESCRIPTION
|
|
.B renice
|
|
alters the scheduling priority of one or more running processes. The
|
|
first argument is the \fIpriority\fR value to be used.
|
|
The other arguments are interpreted as process IDs (by default),
|
|
process group IDs, user IDs, or user names.
|
|
.BR renice 'ing
|
|
a process group causes all processes in the process group to have their
|
|
scheduling priority altered.
|
|
.BR renice 'ing
|
|
a user causes all processes owned by the user to have their scheduling
|
|
priority altered.
|
|
.PP
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-n , " \-\-priority " \fIpriority\fR
|
|
Specify the scheduling
|
|
.I priority
|
|
to be used for the process, process group, or user. Use of the option
|
|
.BR \-n " or " \-\-priority
|
|
is optional, but when used it must be the first argument.
|
|
.TP
|
|
.BR \-g , " \-\-pgrp
|
|
Interpret the succeeding arguments as process group IDs.
|
|
.TP
|
|
.BR \-p , " \-\-pid
|
|
Interpret the succeeding arguments as process IDs
|
|
(the default).
|
|
.TP
|
|
.BR \-u , " \-\-user
|
|
Interpret the succeeding arguments as usernames or UIDs.
|
|
.TP
|
|
.BR \-V , " \-\-version"
|
|
Display version information and exit.
|
|
.TP
|
|
.BR \-h , " \-\-help"
|
|
Display help text and exit.
|
|
.SH EXAMPLES
|
|
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:
|
|
.TP
|
|
.B " renice" +1 987 -u daemon root -p 32
|
|
.SH NOTES
|
|
Users other than the superuser may only alter the priority of processes they
|
|
own. Furthermore, an unprivileged user can only
|
|
.I 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
|
|
.BR ulimit (1)
|
|
and
|
|
.BR getrlimit (2)).
|
|
|
|
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).
|
|
.SH FILES
|
|
.TP
|
|
.I /etc/passwd
|
|
to map user names to user IDs
|
|
.SH SEE ALSO
|
|
.BR nice (1),
|
|
.BR getpriority (2),
|
|
.BR setpriority (2),
|
|
.BR credentials (7),
|
|
.BR sched (7)
|
|
.SH HISTORY
|
|
The
|
|
.B renice
|
|
command appeared in 4.0BSD.
|
|
.SH AVAILABILITY
|
|
The renice command is part of the util-linux package and is available from
|
|
.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
|
|
Linux Kernel Archive
|
|
.UE .
|