Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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(3) 						     Library Functions Manual							   nice(3)

NAME
nice - Changes the scheduling priority of a process LIBRARY
Standard C Library (libc) Berkeley Compatibility Library (libbsd) SYNOPSIS
#include <unistd.h> int nice( int increment); STANDARDS
Interfaces documented on this reference page conform to industry standards as follows: nice(): XSH4.2 Refer to the standards(5) reference page for more information about industry standards and associated tags. PARAMETERS
Specifies a value that is added to the current process priority. You can specify a negative value. DESCRIPTION
The nice() function adds the value specified in the increment parameter to the nice value of the calling process. The nice value is a non- negative number; a higher nice value gives the process a lower CPU priority. When you are using the Standard C Library version of the nice() function, the maximum nice value for a process is 39 (2 * {NZERO} -1) and the minimum is 0 (zero). Requests for values outside these limits result in the nice value being set to the corresponding limit. [XPG4-UNIX] If execution of the Standard C Library nice() function fails, the system does not alter the specified priority. Any process can lower its priority (numerically raise its nice value). A process must have superuser privileges to raise its priority (numerically lower its nice value). [Tru64 UNIX] For backward compatibility, a version of the nice() function is supported that allows nice values in the range of -20 to 20. Requests for values above or below these limits result in the nice value being set to the corresponding limit. To use the backward-compat- ible version of nice(), compile with the Berkeley Compatibility Library (libbsd.a). RETURN VALUES
Upon successful completion, the nice() function returns the new nice value minus 20 ({NZERO}). Otherwise, the function returns -1 and sets errno to indicate the error. ERRORS
The Standard C Library version of nice() sets errno to the specified values for the following conditions: The calling process does not have appropriate privilege. [Tru64 UNIX] The libbsd.a version of nice() sets errno to the same values as the setpriority() function. For information about possible return values for the setpriority() function, see setpriority(2). RELATED INFORMATION
Functions: exec(2), getpriority(2), setpriority(2) Standards: standards(5) delim off nice(3)
Man Page