xref: /csrg-svn/usr.bin/nice/nice.1 (revision 50532)
143083Scael.\" Copyright (c) 1980, 1990 The Regents of the University of California.
243083Scael.\" All rights reserved.
319230Smckusick.\"
419230Smckusick.\"
5*50532Scael.\" %sccs.include.redist.roff%
643083Scael.\"
7*50532Scael.\"	@(#)nice.1	6.7 (Berkeley) 07/24/91
8*50532Scael.\"
943083Scael.Dd
1043083Scael.Dt NICE 1
1143083Scael.Os BSD 4
1243083Scael.Sh NAME
1343083Scael.Nm nice
1443083Scael.Nd execute a command at a low scheduling priority
1543083Scael.Sh SYNOPSIS
1643083Scael.Nm nice
17*50532Scael.Op Fl Ns Ar number
1843083Scael.Ar command
1943083Scael.Op Ar arguments
2043083Scael.Sh DESCRIPTION
2143083Scael.Nm Nice
2243083Scaelruns
2343083Scael.Ar command
2443083Scaelat a low priority.
2543083Scael(Think of low and slow).
2643083ScaelIf
27*50532Scael.Fl Ns Ar number
2843083Scaelis specified, and if it is greater than or equal
2943083Scaelto 10 (the default),
3043083Scael.Nm nice
3143083Scaelwill execute
3243083Scael.Ar command
3343083Scaelat that priority.
3443083ScaelThe upper bound, or lowest priority that
3543083Scael.Nm nice
3643083Scaelwill run a command is 20.
3743083ScaelThe lower bounds or
3843083Scaelhigher priorities (integers less than 10)
3943083Scaelcan only be requested by the super-user.
4043083ScaelNegative numbers are expressed as
41*50532Scael.Fl - Ns Ar number .
4243083Scael.Pp
4343083ScaelThe returned exit status is the exit value from the
4443083Scaelcommand executed by
4543083Scael.Nm nice .
4643083Scael.Sh SEE ALSO
4743083Scael.Xr csh 1 ,
4843083Scael.Xr renice 8
4943083Scael.Sh HISTORY
50*50532ScaelA
51*50532Scael.Nm nice
52*50532Scaelcommand appeared in
53*50532Scael.At v6 .
5443083Scael.Sh BUGS
5543083Scael.Nm Nice
5638088Sbosticis particular to
5743083Scael.Xr sh  1  .
5819230SmckusickIf you use
5943083Scael.Xr csh  1  ,
6019230Smckusickthen commands executed with ``&'' are automatically immune to hangup
6119230Smckusicksignals while in the background.
6243083Scael.Pp
6343083Scael.Nm Nice
6419230Smckusickis built into
6543083Scael.Xr csh  1
6619230Smckusickwith a slightly different syntax than described here.  The form
67*50532Scael.Ql nice +10
68*50532Scaelnices to positive nice, and
69*50532Scael.Ql nice \-10
70*50532Scaelcan be used
7119230Smckusickby the super-user to give a process more of the processor.
72