Commit | Line | Data |
---|---|---|
b5dc1377 CL |
1 | .\" Copyright (c) 1980, 1990 The Regents of the University of California. |
2 | .\" All rights reserved. | |
36b987e5 | 3 | .\" |
36b987e5 | 4 | .\" |
020b3fff CL |
5 | .\" %sccs.include.redist.roff% |
6 | .\" | |
7 | .\" @(#)nice.1 6.7 (Berkeley) %G% | |
b5dc1377 CL |
8 | .\" |
9 | .Dd | |
10 | .Dt NICE 1 | |
11 | .Os BSD 4 | |
12 | .Sh NAME | |
13 | .Nm nice | |
14 | .Nd execute a command at a low scheduling priority | |
15 | .Sh SYNOPSIS | |
16 | .Nm nice | |
020b3fff | 17 | .Op Fl Ns Ar number |
b5dc1377 CL |
18 | .Ar command |
19 | .Op Ar arguments | |
20 | .Sh DESCRIPTION | |
21 | .Nm Nice | |
22 | runs | |
23 | .Ar command | |
24 | at a low priority. | |
25 | (Think of low and slow). | |
26 | If | |
020b3fff | 27 | .Fl Ns Ar number |
b5dc1377 CL |
28 | is specified, and if it is greater than or equal |
29 | to 10 (the default), | |
30 | .Nm nice | |
31 | will execute | |
32 | .Ar command | |
33 | at that priority. | |
34 | The upper bound, or lowest priority that | |
35 | .Nm nice | |
36 | will run a command is 20. | |
37 | The lower bounds or | |
38 | higher priorities (integers less than 10) | |
39 | can only be requested by the super-user. | |
40 | Negative numbers are expressed as | |
020b3fff | 41 | .Fl - Ns Ar number . |
b5dc1377 CL |
42 | .Pp |
43 | The returned exit status is the exit value from the | |
44 | command executed by | |
45 | .Nm nice . | |
46 | .Sh SEE ALSO | |
47 | .Xr csh 1 , | |
b5dc1377 CL |
48 | .Xr renice 8 |
49 | .Sh HISTORY | |
020b3fff CL |
50 | A |
51 | .Nm nice | |
52 | command appeared in | |
53 | .At v6 . | |
b5dc1377 CL |
54 | .Sh BUGS |
55 | .Nm Nice | |
1cc467a3 | 56 | is particular to |
b5dc1377 | 57 | .Xr sh 1 . |
36b987e5 | 58 | If you use |
b5dc1377 | 59 | .Xr csh 1 , |
36b987e5 KM |
60 | then commands executed with ``&'' are automatically immune to hangup |
61 | signals while in the background. | |
b5dc1377 CL |
62 | .Pp |
63 | .Nm Nice | |
36b987e5 | 64 | is built into |
b5dc1377 | 65 | .Xr csh 1 |
36b987e5 | 66 | with a slightly different syntax than described here. The form |
020b3fff CL |
67 | .Ql nice +10 |
68 | nices to positive nice, and | |
69 | .Ql nice \-10 | |
70 | can be used | |
36b987e5 | 71 | by the super-user to give a process more of the processor. |