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