version 1.4, 1998/09/27 16:57:48 |
version 1.5, 1999/06/05 01:21:35 |
|
|
.\" |
.\" |
.Dd June 6, 1993 |
.Dd June 6, 1993 |
.Dt NICE 1 |
.Dt NICE 1 |
.Os |
.Os |
.Sh NAME |
.Sh NAME |
.Nm nice |
.Nm nice |
.Nd execute a utility with an altered scheduling priority |
.Nd execute a utility with an altered scheduling priority |
|
|
.Ar utility |
.Ar utility |
.Op Ar argument ... |
.Op Ar argument ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm nice |
.Nm |
runs |
runs |
.Ar utility |
.Ar utility |
at an altered scheduling priority. |
at an altered scheduling priority. |
If an |
If an |
.Ar increment |
.Ar increment |
is given, it is used; otherwise |
is given, it is used; otherwise |
an increment of 10 is assumed. |
an increment of 10 is assumed. |
The super-user can run utilities with priorities higher than normal by using |
The super-user can run utilities with priorities higher than normal by using |
a negative |
a negative |
.Ar increment . |
.Ar increment . |
The priority can be adjusted over a |
The priority can be adjusted over a |
range of -20 (the highest) to 20 (the lowest). |
range of \-20 (the highest) to 20 (the lowest). |
.Pp |
.Pp |
Available options: |
Available options: |
.Bl -tag -width indent |
.Bl -tag -width indent |
.It Fl n Ar increment |
.It Fl n Ar increment |
A positive or negative decimal integer used to modify the system scheduling |
A positive or negative decimal integer used to modify the system scheduling |
priority of |
priority of |
.Ar utility . |
.Ar utility . |
.El |
.El |
.Sh DIAGNOSTICS |
.Sh DIAGNOSTICS |
The |
The |
.Nm nice |
.Nm |
utility shall exit with one of the following values: |
utility shall exit with one of the following values: |
.Bl -tag -width indent |
.Bl -tag -width indent |
.It 1-125 |
.It 1\-125 |
An error occurred in the |
An error occurred in the |
.Nm nice |
.Nm |
utility. |
utility. |
.It 126 |
.It 126 |
The |
The |
.Ar utility |
.Ar utility |
was found but could not be invoked. |
was found but could not be invoked. |
.It 127 |
.It 127 |
The |
The |
.Ar utility |
.Ar utility |
could not be found. |
could not be found. |
.El |
.El |
.Pp |
.Pp |
Otherwise, the exit status of |
Otherwise, the exit status of |
.Nm nice |
.Nm |
shall be that of |
shall be that of |
.Ar utility . |
.Ar utility . |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
The historic |
The historic |
.Fl Ns Ar increment |
.Fl Ns Ar increment |
option has been deprecated but is still supported in this implementation. |
option has been deprecated but is still supported in this implementation. |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr csh 1 , |
.Xr csh 1 , |
|
|
.Xr renice 8 |
.Xr renice 8 |
.Sh STANDARDS |
.Sh STANDARDS |
The |
The |
.Nm nice |
.Nm |
utility conforms to |
utility conforms to |
.St -p1003.2-92 . |
.St -p1003.2-92 . |
.Sh HISTORY |
.Sh HISTORY |
A |
A |
.Nm nice |
.Nm |
utility appeared in |
utility appeared in |
.At v6 . |
.At v6 . |
.Sh BUGS |
.Sh BUGS |
.Nm nice |
.Nm |
is built into |
is built into |
.Xr csh 1 |
.Xr csh 1 |
with a slightly different syntax than described here. The form |
with a slightly different syntax than described here. The form |