man-pages/man1/renice.1.html
2021-03-31 01:06:50 +01:00

171 lines
4.2 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of RENICE</TITLE>
</HEAD><BODY>
<H1>RENICE</H1>
Section: User Commands (1)<BR>Updated: July 2014<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
renice - alter priority of running processes
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>renice</B>
[<B>-n</B>]
<I>priority</I>
[<B>-g</B>|<B>-p</B>|<B>-u</B>]
<I>identifier</I>...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>renice</B>
alters the scheduling priority of one or more running processes. The
first argument is the <I>priority</I> value to be used.
The other arguments are interpreted as process IDs (by default),
process group IDs, user IDs, or user names.
<B>renice</B>'ing
a process group causes all processes in the process group to have their
scheduling priority altered.
<B>renice</B>'ing
a user causes all processes owned by the user to have their scheduling
priority altered.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-n</B>,<B> --priority </B><I>priority</I>
<DD>
Specify the scheduling
<I>priority</I>
to be used for the process, process group, or user. Use of the option
<B>-n</B> or <B>--priority</B>
is optional, but when used it must be the first argument.
<DT id="2"><B>-g</B>,<B> --pgrp</B>
<DD>
Interpret the succeeding arguments as process group IDs.
<DT id="3"><B>-p</B>,<B> --pid</B>
<DD>
Interpret the succeeding arguments as process IDs
(the default).
<DT id="4"><B>-u</B>,<B> --user</B>
<DD>
Interpret the succeeding arguments as usernames or UIDs.
<DT id="5"><B>-V</B>,<B> --version</B>
<DD>
Display version information and exit.
<DT id="6"><B>-h</B>,<B> --help</B>
<DD>
Display help text and exit.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>EXAMPLES</H2>
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:
<DL COMPACT>
<DT id="7"><B> renice +1 987 -u daemon root -p 32</B>
<DD>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>NOTES</H2>
Users other than the superuser may only alter the priority of processes they
own. Furthermore, an unprivileged user can only
<I>increase</I>
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
<B><A HREF="/cgi-bin/man/man2html?1+ulimit">ulimit</A></B>(1)
and
<B><A HREF="/cgi-bin/man/man2html?2+getrlimit">getrlimit</A></B>(2)).
<P>
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).
<A NAME="lbAH">&nbsp;</A>
<H2>FILES</H2>
<DL COMPACT>
<DT id="8"><I>/etc/passwd</I>
<DD>
to map user names to user IDs
</DL>
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+nice">nice</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?2+getpriority">getpriority</A></B>(2),
<B><A HREF="/cgi-bin/man/man2html?2+setpriority">setpriority</A></B>(2),
<B><A HREF="/cgi-bin/man/man2html?7+credentials">credentials</A></B>(7),
<B><A HREF="/cgi-bin/man/man2html?7+sched">sched</A></B>(7)
<A NAME="lbAJ">&nbsp;</A>
<H2>HISTORY</H2>
The
<B>renice</B>
command appeared in 4.0BSD.
<A NAME="lbAK">&nbsp;</A>
<H2>AVAILABILITY</H2>
The renice command is part of the util-linux package and is available from
Linux Kernel Archive
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="9"><A HREF="#lbAB">NAME</A><DD>
<DT id="10"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="11"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="12"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="13"><A HREF="#lbAF">EXAMPLES</A><DD>
<DT id="14"><A HREF="#lbAG">NOTES</A><DD>
<DT id="15"><A HREF="#lbAH">FILES</A><DD>
<DT id="16"><A HREF="#lbAI">SEE ALSO</A><DD>
<DT id="17"><A HREF="#lbAJ">HISTORY</A><DD>
<DT id="18"><A HREF="#lbAK">AVAILABILITY</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:26 GMT, March 31, 2021
</BODY>
</HTML>