1*3957bea1Swiz.\" $NetBSD: nice.1,v 1.15 2012/03/22 07:58:19 wiz Exp $ 262803f02Sjtc.\" 362803f02Sjtc.\" Copyright (c) 1980, 1990, 1993 462803f02Sjtc.\" The Regents of the University of California. All rights reserved. 561f28255Scgd.\" 661f28255Scgd.\" Redistribution and use in source and binary forms, with or without 761f28255Scgd.\" modification, are permitted provided that the following conditions 861f28255Scgd.\" are met: 961f28255Scgd.\" 1. Redistributions of source code must retain the above copyright 1061f28255Scgd.\" notice, this list of conditions and the following disclaimer. 1161f28255Scgd.\" 2. Redistributions in binary form must reproduce the above copyright 1261f28255Scgd.\" notice, this list of conditions and the following disclaimer in the 1361f28255Scgd.\" documentation and/or other materials provided with the distribution. 1489aaa1bbSagc.\" 3. Neither the name of the University nor the names of its contributors 1561f28255Scgd.\" may be used to endorse or promote products derived from this software 1661f28255Scgd.\" without specific prior written permission. 1761f28255Scgd.\" 1861f28255Scgd.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 1961f28255Scgd.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 2061f28255Scgd.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 2161f28255Scgd.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 2261f28255Scgd.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 2361f28255Scgd.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2461f28255Scgd.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2561f28255Scgd.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2661f28255Scgd.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2761f28255Scgd.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 2861f28255Scgd.\" SUCH DAMAGE. 2961f28255Scgd.\" 3062803f02Sjtc.\" @(#)nice.1 8.1 (Berkeley) 6/6/93 3161f28255Scgd.\" 3262803f02Sjtc.Dd June 6, 1993 3361f28255Scgd.Dt NICE 1 347b5c7989Sjtc.Os 3561f28255Scgd.Sh NAME 3661f28255Scgd.Nm nice 377b5c7989Sjtc.Nd execute a utility with an altered scheduling priority 3861f28255Scgd.Sh SYNOPSIS 39c9af5d97Slukem.Nm 407b5c7989Sjtc.Op Fl n Ar increment 417b5c7989Sjtc.Ar utility 427b5c7989Sjtc.Op Ar argument ... 4361f28255Scgd.Sh DESCRIPTION 44c9af5d97Slukem.Nm 4561f28255Scgdruns 467b5c7989Sjtc.Ar utility 477b5c7989Sjtcat an altered scheduling priority. 487b5c7989SjtcIf an 497b5c7989Sjtc.Ar increment 507b5c7989Sjtcis given, it is used; otherwise 517b5c7989Sjtcan increment of 10 is assumed. 527b5c7989SjtcThe super-user can run utilities with priorities higher than normal by using 537b5c7989Sjtca negative 547b5c7989Sjtc.Ar increment . 557b5c7989SjtcThe priority can be adjusted over a 56be8ae688Sgrantrange of -20 (the highest) to 20 (the lowest). 57be8ae688SgrantA priority of 19 or 20 58cf4d2683Srosswill prevent a process from taking any cycles from others at nice 0 or 59cf4d2683Srossbetter. 6061f28255Scgd.Pp 617b5c7989SjtcAvailable options: 627b5c7989Sjtc.Bl -tag -width indent 637b5c7989Sjtc.It Fl n Ar increment 647b5c7989SjtcA positive or negative decimal integer used to modify the system scheduling 657b5c7989Sjtcpriority of 667b5c7989Sjtc.Ar utility . 677b5c7989Sjtc.El 684918722aSkleink.Sh EXIT STATUS 697b5c7989SjtcThe 70c9af5d97Slukem.Nm 714918722aSkleinkutility exits with one of the following values: 727b5c7989Sjtc.Bl -tag -width indent 737b5c7989Sjtc.It 1-125 742c7d5d92SjtcAn error occurred in the 75c9af5d97Slukem.Nm 767b5c7989Sjtcutility. 777b5c7989Sjtc.It 126 787b5c7989SjtcThe 797b5c7989Sjtc.Ar utility 807b5c7989Sjtcwas found but could not be invoked. 817b5c7989Sjtc.It 127 827b5c7989SjtcThe 837b5c7989Sjtc.Ar utility 847b5c7989Sjtccould not be found. 857b5c7989Sjtc.El 867b5c7989Sjtc.Pp 877b5c7989SjtcOtherwise, the exit status of 88c9af5d97Slukem.Nm 894918722aSkleinkwill be that of 907b5c7989Sjtc.Ar utility . 917b5c7989Sjtc.Sh COMPATIBILITY 927b5c7989SjtcThe historic 937b5c7989Sjtc.Fl Ns Ar increment 947b5c7989Sjtcoption has been deprecated but is still supported in this implementation. 9561f28255Scgd.Sh SEE ALSO 9661f28255Scgd.Xr csh 1 , 978287c17dSkleink.Xr getpriority 2 , 988287c17dSkleink.Xr setpriority 2 , 9961f28255Scgd.Xr renice 8 1007b5c7989Sjtc.Sh STANDARDS 1017b5c7989SjtcThe 102c9af5d97Slukem.Nm 1037b5c7989Sjtcutility conforms to 1047b5c7989Sjtc.St -p1003.2-92 . 10561f28255Scgd.Sh HISTORY 10661f28255ScgdA 107c9af5d97Slukem.Nm 1087b5c7989Sjtcutility appeared in 10961f28255Scgd.At v6 . 11061f28255Scgd.Sh BUGS 111c9af5d97Slukem.Nm 11261f28255Scgdis built into 11361f28255Scgd.Xr csh 1 114be8ae688Sgrantwith a slightly different syntax than described here. 115be8ae688SgrantThe form 11661f28255Scgd.Ql nice +10 11761f28255Scgdnices to positive nice, and 11861f28255Scgd.Ql nice \-10 11961f28255Scgdcan be used 12061f28255Scgdby the super-user to give a process more of the processor. 121