summaryrefslogtreecommitdiff
path: root/usr.bin/renice/renice.8
diff options
context:
space:
mode:
Diffstat (limited to 'usr.bin/renice/renice.8')
-rw-r--r--usr.bin/renice/renice.826
1 files changed, 16 insertions, 10 deletions
diff --git a/usr.bin/renice/renice.8 b/usr.bin/renice/renice.8
index a0490ce9364..28053c972cd 100644
--- a/usr.bin/renice/renice.8
+++ b/usr.bin/renice/renice.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: renice.8,v 1.17 2007/05/31 19:20:15 jmc Exp $
+.\" $OpenBSD: renice.8,v 1.18 2008/12/08 21:23:10 millert Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" from: @(#)renice.8 8.1 (Berkeley) 6/9/93
.\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: December 8 2008 $
.Dt RENICE 8
.Os
.Sh NAME
@@ -37,7 +37,7 @@
.Nd alter priority of running processes
.Sh SYNOPSIS
.Nm renice
-.Ar priority
+.Fl n Ar increment
.Oo
.Op Fl g
.Ar pgrp ...
@@ -52,9 +52,8 @@
.Oc
.Sh DESCRIPTION
.Nm
-alters the scheduling
-.Em priority
-of one or more running processes.
+alters the scheduling priority of one or more running processes by
+.Ar increment .
Processes may be selected using the parameters
.Ar pid
(process ID),
@@ -62,7 +61,7 @@ Processes may be selected using the parameters
(process group ID),
and
.Ar user
-(user name).
+(user name or ID).
If no flag is specified,
the default is to select by process ID.
.Pp
@@ -95,12 +94,16 @@ The options are as follows:
.It Fl g Ar pgrp
Alter the scheduling priority of all processes in process group
.Ar pgrp .
+.It Fl n Ar increment
+A positive or negative decimal integer used to modify the
+scheduling priority.
.It Fl p Ar pid
Alter the scheduling priority of process
.Ar pid .
.It Fl u Ar user
-Alter the scheduling priority of all processes belonging to user
-.Ar user .
+Alter the scheduling priority of all processes belonging to
+.Ar user ,
+which may be a user name or ID.
.El
.Sh FILES
.Bl -tag -width /etc/passwd -compact
@@ -112,7 +115,7 @@ The following example
changes the priority of process IDs 987 and 32,
and all processes owned by users daemon and root:
.Bd -literal -offset indent
-# renice +1 987 -u daemon root -p 32
+# renice -n +1 987 -u daemon root -p 32
.Ed
.Sh SEE ALSO
.Xr nice 1 ,
@@ -126,6 +129,9 @@ utility is compliant with the
specification,
but its presence is optional.
.Pp
+The historical behavior of passing the increment as the first
+argument is supported for backwards compatibility.
+.Pp
The arguments to flags
.Op Fl gpu
are extensions to that specification.