version 1.17, 2007/05/31 19:20:15 |
version 1.18, 2008/12/08 21:23:10 |
|
|
.Nd alter priority of running processes |
.Nd alter priority of running processes |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm renice |
.Nm renice |
.Ar priority |
.Fl n Ar increment |
.Oo |
.Oo |
.Op Fl g |
.Op Fl g |
.Ar pgrp ... |
.Ar pgrp ... |
|
|
.Oc |
.Oc |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
alters the scheduling |
alters the scheduling priority of one or more running processes by |
.Em priority |
.Ar increment . |
of one or more running processes. |
|
Processes may be selected using the parameters |
Processes may be selected using the parameters |
.Ar pid |
.Ar pid |
(process ID), |
(process ID), |
|
|
(process group ID), |
(process group ID), |
and |
and |
.Ar user |
.Ar user |
(user name). |
(user name or ID). |
If no flag is specified, |
If no flag is specified, |
the default is to select by process ID. |
the default is to select by process ID. |
.Pp |
.Pp |
|
|
.It Fl g Ar pgrp |
.It Fl g Ar pgrp |
Alter the scheduling priority of all processes in process group |
Alter the scheduling priority of all processes in process group |
.Ar pgrp . |
.Ar pgrp . |
|
.It Fl n Ar increment |
|
A positive or negative decimal integer used to modify the |
|
scheduling priority. |
.It Fl p Ar pid |
.It Fl p Ar pid |
Alter the scheduling priority of process |
Alter the scheduling priority of process |
.Ar pid . |
.Ar pid . |
.It Fl u Ar user |
.It Fl u Ar user |
Alter the scheduling priority of all processes belonging to user |
Alter the scheduling priority of all processes belonging to |
.Ar user . |
.Ar user , |
|
which may be a user name or ID. |
.El |
.El |
.Sh FILES |
.Sh FILES |
.Bl -tag -width /etc/passwd -compact |
.Bl -tag -width /etc/passwd -compact |
|
|
changes the priority of process IDs 987 and 32, |
changes the priority of process IDs 987 and 32, |
and all processes owned by users daemon and root: |
and all processes owned by users daemon and root: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
# renice +1 987 -u daemon root -p 32 |
# renice -n +1 987 -u daemon root -p 32 |
.Ed |
.Ed |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr nice 1 , |
.Xr nice 1 , |
|
|
.St -p1003.1-2004 |
.St -p1003.1-2004 |
specification, |
specification, |
but its presence is optional. |
but its presence is optional. |
|
.Pp |
|
The historical behavior of passing the increment as the first |
|
argument is supported for backwards compatibility. |
.Pp |
.Pp |
The arguments to flags |
The arguments to flags |
.Op Fl gpu |
.Op Fl gpu |