nice(3) [netbsd man page]

NICE(3) 						   BSD Library Functions Manual 						   NICE(3)

NAME

     nice -- set program scheduling priority

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <unistd.h>

     int
     nice(int incr);

DESCRIPTION

     This interface is obsoleted by setpriority(2).

     The nice() function obtains the scheduling priority of the process from the system and sets it to the priority value specified in incr.  The
     priority is a value in the range -20 to 20.  The default priority is 0; lower priorities cause more favorable scheduling.	Only a process
     with appropriate privileges may lower priorities.

     Children inherit the priority of their parent processes via fork(2).

RETURN VALUES

     Upon successful completion, nice() returns the new nice value minus NZERO.  Otherwise, -1 is returned, the process' nice value is not
     changed, and errno is set to indicate the error.

ERRORS

     The nice() function will fail if:

     [EPERM]		The incr argument is negative and the caller does not have appropriate privileges.

SEE ALSO

     nice(1), fork(2), setpriority(2), renice(8)

STANDARDS

     The nice() function conforms to X/Open Portability Guide Issue 4, Version 2 (``XPG4.2'').

HISTORY

     A nice() syscall appeared in Version 6 AT&T UNIX.

BSD
								  April 30, 2011							       BSD

NICE(1) 						    BSD General Commands Manual 						   NICE(1)

NAME

     nice -- execute a utility with an altered scheduling priority

SYNOPSIS

     nice [-n increment] utility [argument ...]

DESCRIPTION

     nice runs utility at an altered scheduling priority.  If an increment is given, it is used; otherwise an increment of 10 is assumed.  The
     super-user can run utilities with priorities higher than normal by using a negative increment.  The priority can be adjusted over a range of
     -20 (the highest) to 20 (the lowest).

     Available options:

     -n increment
	     A positive or negative decimal integer used to modify the system scheduling priority of utility.

DIAGNOSTICS

     The nice utility shall exit with one of the following values:

     1-125   An error occurred in the nice utility.

     126     The utility was found but could not be invoked.

     127     The utility could not be found.

     Otherwise, the exit status of nice shall be that of utility.

COMPATIBILITY

     The historic -increment option has been deprecated but is still supported in this implementation.

SEE ALSO

     csh(1), getpriority(2), setpriority(2), renice(8)

STANDARDS

     The nice utility conforms to IEEE Std 1003.2-1992 (``POSIX.2'').

HISTORY

     A nice utility appeared in Version 6 AT&T UNIX.

BUGS

     nice is built into csh(1) with a slightly different syntax than described here.  The form 'nice +10' nices to positive nice, and 'nice -10'
     can be used by the super-user to give a process more of the processor.

BSD
								   June 6, 1993 							       BSD