Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NICE(3)			    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  adds  incr  to  the  scheduling  priority	of the
       process.	 The priority is a value in the	range -20 to 20.  The  default
       priority	 is 0; lower priorities	cause more favorable scheduling.  Only
       the super-user may lower	priorities.

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

RETURN VALUES
       Upon successful completion, nice() returns 0, and errno	is  unchanged.
       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 IEEE Std	1003.1-2008 ("POSIX.1")	except
       for  the	 return	 value.	 This implementation returns 0 upon successful
       completion but the standard requires  returning	the  new  nice	value,
       which could be -1.

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

FreeBSD	15.0		       February	28, 2015		       NICE(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nice&sektion=3&manpath=FreeBSD+15.0-RELEASE+and+Ports>

home | help