version 1.14, 2003/06/03 02:56:15 |
version 1.15, 2007/03/16 16:36:06 |
|
|
.Nm renice |
.Nm renice |
.Ar priority |
.Ar priority |
.Oo |
.Oo |
.Op Fl p |
|
.Ar pid ... |
|
.Oc |
|
.Oo |
|
.Op Fl g |
.Op Fl g |
.Ar pgrp ... |
.Ar pgrp ... |
.Oc |
.Oc |
.Oo |
.Oo |
|
.Op Fl p |
|
.Ar pid ... |
|
.Oc |
|
.Oo |
.Op Fl u |
.Op Fl u |
.Ar user ... |
.Ar user ... |
.Oc |
.Oc |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
alters the scheduling |
alters the scheduling |
.Ar priority |
.Em priority |
(an integer) of one or more running processes. |
of one or more running processes. |
The following |
Processes may be selected using the parameters |
.Ar who |
.Ar pid |
parameters (pid, pgrp and user) are interpreted as process IDs, process group |
(process ID), |
IDs, or user names. |
.Ar pgrp |
.Nm renice Ns ing |
(process group ID), |
a process group causes all processes in the process group |
and |
to have their scheduling priority altered. |
.Ar user |
.Nm renice Ns ing |
(user name). |
a user causes all processes owned by the user to have |
If no flag is specified, |
their scheduling priority altered. |
the default is to select by process ID. |
By default, the processes to be affected are specified by |
|
their process IDs. |
|
.Pp |
.Pp |
The options are as follows: |
|
.Bl -tag -width Ds |
|
.It Fl g |
|
Force |
|
.Ar who |
|
parameters to be interpreted as process group IDs. |
|
.It Fl u |
|
Force the |
|
.Ar who |
|
parameters to be interpreted as user names. |
|
.It Fl p |
|
Resets the |
|
.Ar who |
|
interpretation to be (the default) process IDs. |
|
.El |
|
.Pp |
|
For example, |
|
.Bd -literal -offset |
|
# renice +1 987 -u daemon root -p 32 |
|
.Ed |
|
.Pp |
|
would change the priority of process IDs 987 and 32, and |
|
all processes owned by users daemon and root. |
|
.Pp |
|
Users other than the superuser may only alter the priority of |
Users other than the superuser may only alter the priority of |
processes they own, |
processes they own, |
and can only monotonically increase their |
and can only monotonically increase their |
|
|
(\-20) |
(\-20) |
to |
to |
.Dv PRIO_MAX . |
.Dv PRIO_MAX . |
|
.Pp |
Useful priorities are: |
Useful priorities are: |
20 (the affected processes will run only when nothing else |
20 (the affected processes will run only when nothing else |
in the system wants to), |
in the system wants to), |
|
|
.Dq base |
.Dq base |
scheduling priority), |
scheduling priority), |
anything negative (to make things go very fast). |
anything negative (to make things go very fast). |
|
.Pp |
|
The options are as follows: |
|
.Bl -tag -width Ds |
|
.It Fl g Ar pgrp |
|
Alter the scheduling priority of all processes in process group |
|
.Ar pgrp . |
|
.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 . |
|
.El |
.Sh FILES |
.Sh FILES |
.Bl -tag -width /etc/passwd -compact |
.Bl -tag -width /etc/passwd -compact |
.It Pa /etc/passwd |
.It Pa /etc/passwd |
for mapping user names to user IDs |
for mapping user names to user IDs |
.El |
.El |
|
.Sh EXAMPLES |
|
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 |
|
.Ed |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr nice 1 , |
.Xr nice 1 , |
.Xr getpriority 2 , |
.Xr getpriority 2 , |