scriptreplay: check for EOF

[thirdparty/util-linux.git] / sys-utils / renice.1

diff --git a/sys-utils/renice.1 b/sys-utils/renice.1
index 5a4fcab74ab9c3ff98419733af374c73918ad673..513d984227b442d88c7b93aa355319887cfa57d0 100644 (file)
--- a/sys-utils/renice.1
+++ b/sys-utils/renice.1
@@ -29,7 +29,7 @@
 .\" 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
@@ -72,11 +72,11 @@ Interpret the succeeding arguments as process IDs
 .BR \-u , " \-\-user
 Interpret the succeeding arguments as usernames or UIDs.
 .TP
-.BR \-h , " \-\-help"
-Display help text and exit.
-.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:
@@ -84,35 +84,36 @@ PIDs 987 and 32, plus all processes owned by the users daemon and root:
 .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 .