.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" @(#)renice.8 8.1 (Berkeley) 6/9/93
+.\" @(#)renice.8 8.1 (Berkeley) 6/9/93
.\"
.TH RENICE "1" "July 2014" "util-linux" "User Commands"
.SH NAME
.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, and can only monotonically increase their ``nice value'' (for security
-reasons) within the range 0 to 19,
-unless a nice resource limit is set (Linux 2.6.12 and higher). The
-superuser may alter the priority of any process and set the priority to any
+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 (1p)
+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
-.B /etc/passwd
+.I /etc/passwd
to map user names to user IDs
.SH SEE ALSO
+.BR nice (1),
.BR getpriority (2),
-.BR setpriority (2)
-.SH BUGS
-Non-superusers cannot increase scheduling priorities of their own processes,
-even if they were the ones that decreased the priorities in the first place.
-.PP
-The Linux kernel (at least version 2.0.0) and linux libc (at least version
-5.2.18) does not agree entirely on what the specifics of the systemcall
-interface to set nice values is. Thus causes renice to report bogus previous
-nice values.
+.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 ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
+.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
Linux Kernel Archive
.UE .