projects / unix-history / blame
| 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. |