home | help
NICE(1) 		     General Commands Manual			 NICE(1)

NAME
     nice -- execute a utility at an altered scheduling priority

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

DESCRIPTION
     The  nice utility runs utility at an altered scheduling priority, by incre-
     menting its "nice" value by the specified increment, or a default value  of
     10.   The lower the nice value of a process, the higher its scheduling pri-
     ority.

     The superuser may specify a negative increment in order to  run  a  utility
     with a higher scheduling prority.

     Some  shells may provide a builtin nice command which is similar or identi-
     cal to this utility.  Consult the builtin(1) manual page.

EXAMPLES
     $ nice -n 5 date

     Execute utility `date' at priority 5 assuming the priority of the shell  is
     0.

     # nice -n 16 nice -n -35 date

     Execute  utility  `date' at priority -19 assuming the priority of the shell
     is 0 and you are the super-user.

DIAGNOSTICS
     If utility is invoked, the exit status  of  nice  is  the	exit  status  of
     utility.

     An  exit  status  of 126 indicates utility was found, but could not be exe-
     cuted.  An exit status of 127 indicates utility could not be found.

SEE ALSO
     builtin(1), csh(1), idprio(1), rtprio(1),	getpriority(2),  setpriority(2),
     renice(8)

COMPATIBILITY
     The  traditional  -increment  option  has been deprecated but is still sup-
     ported.

STANDARDS
     The nice utility conforms to IEEE Std 1003.1-2001 ("POSIX.1").

HISTORY
     A nice utility appeared in Version 4 AT&T UNIX.

FreeBSD 4.7			  June 6, 1993				 NICE(1)

home | help