1*d37082b2SThomas Cort.\" $NetBSD: nice.1,v 1.15 2012/03/22 07:58:19 wiz Exp $ 2*d37082b2SThomas Cort.\" 3*d37082b2SThomas Cort.\" Copyright (c) 1980, 1990, 1993 4*d37082b2SThomas Cort.\" The Regents of the University of California. All rights reserved. 5*d37082b2SThomas Cort.\" 6*d37082b2SThomas Cort.\" Redistribution and use in source and binary forms, with or without 7*d37082b2SThomas Cort.\" modification, are permitted provided that the following conditions 8*d37082b2SThomas Cort.\" are met: 9*d37082b2SThomas Cort.\" 1. Redistributions of source code must retain the above copyright 10*d37082b2SThomas Cort.\" notice, this list of conditions and the following disclaimer. 11*d37082b2SThomas Cort.\" 2. Redistributions in binary form must reproduce the above copyright 12*d37082b2SThomas Cort.\" notice, this list of conditions and the following disclaimer in the 13*d37082b2SThomas Cort.\" documentation and/or other materials provided with the distribution. 14*d37082b2SThomas Cort.\" 3. Neither the name of the University nor the names of its contributors 15*d37082b2SThomas Cort.\" may be used to endorse or promote products derived from this software 16*d37082b2SThomas Cort.\" without specific prior written permission. 17*d37082b2SThomas Cort.\" 18*d37082b2SThomas Cort.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 19*d37082b2SThomas Cort.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20*d37082b2SThomas Cort.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21*d37082b2SThomas Cort.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 22*d37082b2SThomas Cort.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23*d37082b2SThomas Cort.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24*d37082b2SThomas Cort.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25*d37082b2SThomas Cort.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26*d37082b2SThomas Cort.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27*d37082b2SThomas Cort.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28*d37082b2SThomas Cort.\" SUCH DAMAGE. 29*d37082b2SThomas Cort.\" 30*d37082b2SThomas Cort.\" @(#)nice.1 8.1 (Berkeley) 6/6/93 31*d37082b2SThomas Cort.\" 32*d37082b2SThomas Cort.Dd June 6, 1993 33*d37082b2SThomas Cort.Dt NICE 1 34*d37082b2SThomas Cort.Os 35*d37082b2SThomas Cort.Sh NAME 36*d37082b2SThomas Cort.Nm nice 37*d37082b2SThomas Cort.Nd execute a utility with an altered scheduling priority 38*d37082b2SThomas Cort.Sh SYNOPSIS 39*d37082b2SThomas Cort.Nm 40*d37082b2SThomas Cort.Op Fl n Ar increment 41*d37082b2SThomas Cort.Ar utility 42*d37082b2SThomas Cort.Op Ar argument ... 43*d37082b2SThomas Cort.Sh DESCRIPTION 44*d37082b2SThomas Cort.Nm 45*d37082b2SThomas Cortruns 46*d37082b2SThomas Cort.Ar utility 47*d37082b2SThomas Cortat an altered scheduling priority. 48*d37082b2SThomas CortIf an 49*d37082b2SThomas Cort.Ar increment 50*d37082b2SThomas Cortis given, it is used; otherwise 51*d37082b2SThomas Cortan increment of 10 is assumed. 52*d37082b2SThomas CortThe super-user can run utilities with priorities higher than normal by using 53*d37082b2SThomas Corta negative 54*d37082b2SThomas Cort.Ar increment . 55*d37082b2SThomas CortThe priority can be adjusted over a 56*d37082b2SThomas Cortrange of -20 (the highest) to 20 (the lowest). 57*d37082b2SThomas CortA priority of 19 or 20 58*d37082b2SThomas Cortwill prevent a process from taking any cycles from others at nice 0 or 59*d37082b2SThomas Cortbetter. 60*d37082b2SThomas Cort.Pp 61*d37082b2SThomas CortAvailable options: 62*d37082b2SThomas Cort.Bl -tag -width indent 63*d37082b2SThomas Cort.It Fl n Ar increment 64*d37082b2SThomas CortA positive or negative decimal integer used to modify the system scheduling 65*d37082b2SThomas Cortpriority of 66*d37082b2SThomas Cort.Ar utility . 67*d37082b2SThomas Cort.El 68*d37082b2SThomas Cort.Sh EXIT STATUS 69*d37082b2SThomas CortThe 70*d37082b2SThomas Cort.Nm 71*d37082b2SThomas Cortutility exits with one of the following values: 72*d37082b2SThomas Cort.Bl -tag -width indent 73*d37082b2SThomas Cort.It 1-125 74*d37082b2SThomas CortAn error occurred in the 75*d37082b2SThomas Cort.Nm 76*d37082b2SThomas Cortutility. 77*d37082b2SThomas Cort.It 126 78*d37082b2SThomas CortThe 79*d37082b2SThomas Cort.Ar utility 80*d37082b2SThomas Cortwas found but could not be invoked. 81*d37082b2SThomas Cort.It 127 82*d37082b2SThomas CortThe 83*d37082b2SThomas Cort.Ar utility 84*d37082b2SThomas Cortcould not be found. 85*d37082b2SThomas Cort.El 86*d37082b2SThomas Cort.Pp 87*d37082b2SThomas CortOtherwise, the exit status of 88*d37082b2SThomas Cort.Nm 89*d37082b2SThomas Cortwill be that of 90*d37082b2SThomas Cort.Ar utility . 91*d37082b2SThomas Cort.Sh COMPATIBILITY 92*d37082b2SThomas CortThe historic 93*d37082b2SThomas Cort.Fl Ns Ar increment 94*d37082b2SThomas Cortoption has been deprecated but is still supported in this implementation. 95*d37082b2SThomas Cort.Sh SEE ALSO 96*d37082b2SThomas Cort.Xr csh 1 , 97*d37082b2SThomas Cort.Xr getpriority 2 , 98*d37082b2SThomas Cort.Xr setpriority 2 , 99*d37082b2SThomas Cort.Xr renice 8 100*d37082b2SThomas Cort.Sh STANDARDS 101*d37082b2SThomas CortThe 102*d37082b2SThomas Cort.Nm 103*d37082b2SThomas Cortutility conforms to 104*d37082b2SThomas Cort.St -p1003.2-92 . 105*d37082b2SThomas Cort.Sh HISTORY 106*d37082b2SThomas CortA 107*d37082b2SThomas Cort.Nm 108*d37082b2SThomas Cortutility appeared in 109*d37082b2SThomas Cort.At v6 . 110*d37082b2SThomas Cort.Sh BUGS 111*d37082b2SThomas Cort.Nm 112*d37082b2SThomas Cortis built into 113*d37082b2SThomas Cort.Xr csh 1 114*d37082b2SThomas Cortwith a slightly different syntax than described here. 115*d37082b2SThomas CortThe form 116*d37082b2SThomas Cort.Ql nice +10 117*d37082b2SThomas Cortnices to positive nice, and 118*d37082b2SThomas Cort.Ql nice \-10 119*d37082b2SThomas Cortcan be used 120*d37082b2SThomas Cortby the super-user to give a process more of the processor. 121