Annotation of src/usr.bin/renice/renice.8, Revision 1.15
1.15 ! jmc 1: .\" $OpenBSD: renice.8,v 1.14 2003/06/03 02:56:15 millert Exp $
1.10 aaron 2: .\"
1.6 millert 3: .\" Copyright (c) 1983, 1991, 1993
4: .\" The Regents of the University of California. All rights reserved.
1.1 deraadt 5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
1.14 millert 14: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 15: .\" may be used to endorse or promote products derived from this software
16: .\" without specific prior written permission.
17: .\"
18: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28: .\" SUCH DAMAGE.
29: .\"
1.6 millert 30: .\" from: @(#)renice.8 8.1 (Berkeley) 6/9/93
1.1 deraadt 31: .\"
1.6 millert 32: .Dd June 9, 1993
1.1 deraadt 33: .Dt RENICE 8
1.7 aaron 34: .Os
1.1 deraadt 35: .Sh NAME
36: .Nm renice
37: .Nd alter priority of running processes
38: .Sh SYNOPSIS
39: .Nm renice
40: .Ar priority
41: .Oo
1.15 ! jmc 42: .Op Fl g
! 43: .Ar pgrp ...
! 44: .Oc
! 45: .Oo
1.1 deraadt 46: .Op Fl p
47: .Ar pid ...
48: .Oc
49: .Oo
50: .Op Fl u
51: .Ar user ...
52: .Oc
53: .Sh DESCRIPTION
1.8 aaron 54: .Nm
1.11 aaron 55: alters the scheduling
1.15 ! jmc 56: .Em priority
! 57: of one or more running processes.
! 58: Processes may be selected using the parameters
! 59: .Ar pid
! 60: (process ID),
! 61: .Ar pgrp
! 62: (process group ID),
! 63: and
! 64: .Ar user
! 65: (user name).
! 66: If no flag is specified,
! 67: the default is to select by process ID.
1.1 deraadt 68: .Pp
1.11 aaron 69: Users other than the superuser may only alter the priority of
1.1 deraadt 70: processes they own,
1.10 aaron 71: and can only monotonically increase their
72: .Dq nice value
1.1 deraadt 73: within the range 0 to
74: .Dv PRIO_MAX
75: (20).
76: (This prevents overriding administrative fiats.)
1.11 aaron 77: The superuser
1.1 deraadt 78: may alter the priority of any process
79: and set the priority to any value in the range
80: .Dv PRIO_MIN
81: (\-20)
82: to
83: .Dv PRIO_MAX .
1.15 ! jmc 84: .Pp
1.1 deraadt 85: Useful priorities are:
86: 20 (the affected processes will run only when nothing else
87: in the system wants to),
1.10 aaron 88: 0 (the
89: .Dq base
90: scheduling priority),
1.1 deraadt 91: anything negative (to make things go very fast).
1.15 ! jmc 92: .Pp
! 93: The options are as follows:
! 94: .Bl -tag -width Ds
! 95: .It Fl g Ar pgrp
! 96: Alter the scheduling priority of all processes in process group
! 97: .Ar pgrp .
! 98: .It Fl p Ar pid
! 99: Alter the scheduling priority of process
! 100: .Ar pid .
! 101: .It Fl u Ar user
! 102: Alter the scheduling priority of all processes belonging to user
! 103: .Ar user .
! 104: .El
1.1 deraadt 105: .Sh FILES
106: .Bl -tag -width /etc/passwd -compact
107: .It Pa /etc/passwd
1.9 aaron 108: for mapping user names to user IDs
1.1 deraadt 109: .El
1.15 ! jmc 110: .Sh EXAMPLES
! 111: The following example
! 112: changes the priority of process IDs 987 and 32,
! 113: and all processes owned by users daemon and root:
! 114: .Bd -literal -offset indent
! 115: # renice +1 987 -u daemon root -p 32
! 116: .Ed
1.1 deraadt 117: .Sh SEE ALSO
1.4 deraadt 118: .Xr nice 1 ,
1.1 deraadt 119: .Xr getpriority 2 ,
120: .Xr setpriority 2
121: .Sh HISTORY
122: The
123: .Nm
124: command appeared in
125: .Bx 4.0 .
1.12 aaron 126: .Sh BUGS
127: Non-superusers cannot increase scheduling priorities of their own processes,
128: even if they were the ones that decreased the priorities in the first place.