From cedd678ff727d95d3d9c442e29e24ae9f9e85e06 Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Tue, 20 Sep 2005 17:43:58 +0000
Subject: [PATCH] Further reworking of discussion or RLIMIT_NICE and
 RLIMIT_RTPRIO

---
 man2/getrlimit.2 | 23 ++++++++---------------
 1 file changed, 8 insertions(+), 15 deletions(-)

diff --git a/man2/getrlimit.2 b/man2/getrlimit.2
index 1e73bbbaf..accc392be 100644
--- a/man2/getrlimit.2
+++ b/man2/getrlimit.2
@@ -59,7 +59,7 @@
 .\" 2005-07-13, mtk, documented RLIMIT_MSGQUEUE limit.
 .\" 2005-07-28, mtk, Added descriptions of RLIMIT_NICE and RLIMIT_RTPRIO
 .\"
-.TH GETRLIMIT 2 2005-07-28 "Linux" "Linux Programmer's Manual"
+.TH GETRLIMIT 2 2005-09-20 "Linux" "Linux Programmer's Manual"
 .SH NAME
 getrlimit, setrlimit \- get/set resource limits
 .SH SYNOPSIS
@@ -246,22 +246,15 @@ create an unlimited number of zero-length messages (such messages
 nevertheless each consume some system memory for bookkeeping overhead).
 .TP
 .BR RLIMIT_NICE " (since kernel 2.6.12, but see BUGS below)"
-Specifies a ceiling to which the process nice value can be raised using
+Specifies a ceiling to which the process's nice value can be raised using
 .BR setpriority (2)
 or
 .BR nice (2).
 The actual ceiling for the nice value is calculated as
 .IR "20\ \-\ rlim_cur" .
-(This strangeness occurs because of the differences in user-land
-and kernel representations of the nice value, as described in
-.BR getpriority (2).
-Eventually, glibc might hide things to make the range given to
-.BR RLIMIT_NICE
-to be the same as
-.BR setrlimit (2).)
-.\" FIXME (28 Jul 05) -- must check later whether glibc hides this issue
-.\"          by performing a calculation similar to "unice == 20 - knice"
-.\"	     (like [gs]setpriority()) when dealing with RLIMIT_NICE
+(This strangeness occurs because negative numbers cannot be specified
+as resource limit values, since they typically have special meanings.
+For example, RLIM_INFINITY typically is the same as \-1.)
 .TP
 .B RLIMIT_NOFILE
 Specifies a value one greater than the maximum file descriptor number
@@ -292,8 +285,8 @@ specifying
 .\"       -- MTK, Jul 05
 .TP
 .BR RLIMIT_RTPRIO " (Since Linux 2.6.12, but see BUGS)"
-Specifies a ceiling on the real-time priority that the calling
-process may set using
+Specifies a ceiling on the real-time priority that may be set for 
+this process using
 .BR sched_setscheduler (2)
 and
 .BR sched_setparam (2).
@@ -365,7 +358,7 @@ between the priority ranges returned by getpriority(2) and
 This had the effect that actual ceiling for the nice value 
 was calculated as
 .IR "19\ \-\ rlim_cur" .
-This was fixed in kernel 2.6.13
+This was fixed in kernel 2.6.13.
 .\" see http://marc.theaimsgroup.com/?l=linux-kernel&m=112256338703880&w=2
 .SH "CONFORMING TO"
 SVr4, 4.3BSD.