nice(1) [opensolaris man page]

nice(1) 							   User Commands							   nice(1)

NAME

       nice - invoke a command with an altered scheduling priority

SYNOPSIS

       /usr/bin/nice [-increment | -n increment] command
	    [argument]...

       /usr/xpg4/bin/nice [-increment | -n increment] command
	    [argument]...

   csh Builtin
       nice [-increment | +increment] [command]

DESCRIPTION

       The  nice utility invokes command, requesting that it be run with a different system scheduling priority. The priocntl(1) command is a more
       general interface to scheduler functions.

       The invoking process (generally the user's shell) must be in a scheduling class that supports nice.

       If the C shell (see csh(1)) is used, the full path of the command must be specified. Otherwise, the csh built-in version of  nice  will	be
       invoked. See csh Builtin below.

   /usr/bin/nice
       If nice executes commands with arguments, it uses the default shell /usr/bin/sh (see sh(1)).

   /usr/xpg4/bin/nice
       If nice executes commands with arguments, it uses /usr/xpg4/bin/sh (see ksh(1)).

   csh Builtin
       nice is also a csh built-in command with behavior different from the utility versions.  See csh(1) for description.

OPTIONS

       The following options are supported:

       -increment | -n increment    increment  is  a positive or negative decimal integer that has the same effect on the execution of the utility
				    as if the utility had called the nice() function with the numeric value of the increment option-argument.  See
				    nice(2). nice() errors, other than EINVAL, are ignored. If not specified, an increment of 10 is assumed.

				    The  super-user may run commands with priority higher than normal by using a negative increment such as -10. A
				    negative increment assigned by an unprivileged user is ignored.

OPERANDS

       The following operands are supported:

       command	   The name of a command that is to be invoked. If command names any of the special built-in  utilities  (see  shell_builtins(1)),
		   the results are undefined.

       argument    Any string to be supplied as an argument when invoking command.

ENVIRONMENT VARIABLES

       See  environ(5)	for descriptions of the following environment variables that affect the execution of nice: LANG, LC_ALL, LC_CTYPE, LC_MES-
       SAGES, PATH, and NLSPATH.

EXIT STATUS

       If command is invoked, the exit status of nice will be the exit status of command. Otherwise, nice will exit with one of the following val-
       ues:

       1-125	An error occurred.

       126	command was found but could not be invoked.

       127	command could not be found.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

   /usr/bin/nice
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+

   /usr/xpg4/bin/nice
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWxcu4			   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       csh(1), ksh(1), nohup(1), priocntl(1), sh(1), shell_builtins(1), nice(2), attributes(5), environ(5), standards(5)

SunOS 5.11							    23 Jan 2004 							   nice(1)

Check Out this Related Man Page

nice(2) 							   System Calls 							   nice(2)

NAME

       nice - change priority of a process

SYNOPSIS

       #include <unistd.h>

       int nice(int incr);

DESCRIPTION

       The nice() function allows a process to change its priority.  The invoking  process must be in a scheduling class that supports the nice().

       The  nice()  function adds the value of	incr to the nice value of the calling process. A process's nice value is a non-negative number for
       which a greater positive value results in lower CPU priority.

       A maximum nice value of (2 * NZERO) -1 and a minimum nice value of 0 are imposed by the system. NZERO  is  defined  in  <limits.h>  with  a
       default	value of 20. Requests for values above or below these limits result in the nice value being set to the corresponding limit. A nice
       value of 40 is treated as 39.

       Calling the nice() function has no effect on the priority of processes or threads with policy SCHED_FIFO or SCHED_RR.

       Only a process with the {PRIV_PROC_PRIOCNTL} privilege can lower the nice value.

RETURN VALUES

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

ERRORS

       The nice() function will fail if:

       EINVAL	 The nice() function is called by a process in a scheduling class other than time-sharing or fixed-priority.

       EPERM	 The  incr  argument is negative or greater than 40 and the {PRIV_PROC_PRIOCNTL} privilege is not asserted in the effective set of
		 the calling process.

USAGE

       The priocntl(2) function is a more general interface to scheduler functions.

       Since -1 is a permissible return value in a successful situation, an application wishing to check for error situations should set errno	to
       0, then call nice(), and if it returns -1, check to see if errno is non-zero.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Async-Signal-Safe 	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       nice(1), exec(2), priocntl(2), getpriority(3C), attributes(5), privileges(5), standards(5)

SunOS 5.11							    1 Apr 2004								   nice(2)

Linux and UNIX Man Pages

nice(1) [opensolaris man page]

Check Out this Related Man Page