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

renice(1)							   User Commands							 renice(1)

NAME
renice - alter priority of running processes SYNOPSIS
renice [-n increment] [-i idtype] ID... renice [-n increment] [-g | -p | -u] ID... renice priority [-p] pid... [-g gid]... [-p pid]... [-u user]... renice priority -g gid... [-g gid]... [-p pid]... [-u user]... renice priority -u user... [-g gid]... [-p pid]... [-u user]... DESCRIPTION
The renice command alters the scheduling priority of one or more running processes. By default, the processes to be affected are specified by their process IDs. If the first operand is a number within the valid range of priorities (-20 to 20), renice will treat it as a priority (as in all but the first synopsis form). Otherwise, renice will treat it as an ID (as in the first synopsis form). Altering Process Priority Users other than the privileged user may only alter the priority of processes they own, and can only monotonically increase their "nice value" within the range 0 to 19. This prevents overriding administrative fiats. The privileged user may alter the priority of any process and set the priority to any value in the range -20 to 19. Useful priorities are: 19 (the affected processes will run only when nothing else in the system wants to); 0 (the "base" scheduling priority),; and any negative value (to make things go very fast). 20 is an acceptable nice value, but will be rounded down to 19. OPTIONS
renice supports the following option features: o The first operand, priority, must precede the options and can have the appearance of a multi-digit option. o The -g, -p, and -u options can each take multiple option-arguments. o The pid option-argument can be used without its -p option. o The -i option can be used to specify the ID type for the ID list. This is preferred in specifying ID type over the use of the -g | -p | -u syntax, which is now obsolete. See NOTES. The following options are supported: -g Interprets all operands or just the gid arguments as unsigned decimal integer process group IDs. -i This option, together with the ID list arguments, specifies a class of processes to which the renice command is to apply. The interpretation of the ID list depends on the value of idtype. The valid idtype arguments are: pid, pgid, uid, gid, sid, taskid, projid, and zoneid. -n increment Specifies how the system scheduling priority of the specified process or processes is to be adjusted. The increment option- argument is a positive or negative decimal integer that will be used to modify the system scheduling priority of the speci- fied process or processes. Positive increment values cause a lower system scheduling priority. Negative increment values may require appropriate privileges and will cause a higher system scheduling priority. -p Interprets all operands or just the pid arguments as unsigned decimal integer process IDs. The -p option is the default if no options are specified. -u Interprets all operands or just the user argument as users. If a user exists with a user name equal to the operand, then the user ID of that user will be used in further processing. Otherwise, if the operand represents an unsigned decimal inte- ger, it will be used as the numeric user ID of the user. OPERANDS
The following operands are supported: ID A process ID, process group ID, or user name/user ID, depending on the option selected. priority The value specified is taken as the actual system scheduling priority, rather than as an increment to the existing system scheduling priority. Specifying a scheduling priority higher than that of the existing process may require appropriate privi- leges. EXAMPLES
Example 1 Adjusting the scheduling priority of process IDs Adjust the system scheduling priority so that process IDs 987 and 32 would have a lower scheduling priority: example% renice -n 5 -p 987 32 Example 2 Adjusting the scheduling priority of group IDs Adjust the system scheduling priority so that group IDs 324 and 76 would have a higher scheduling priority, if the user has the appropriate privileges to do so: example% renice -n -4 -g 324 76 Example 3 Adjusting the scheduling priority of a user ID and user name Adjust the system scheduling priority so that numeric user ID 8 and user sas would have a lower scheduling priority: example% renice -n 4 -u 8 sas ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables that affect the execution of renice: LANG, LC_ALL, LC_CTYPE, LC_MES- SAGES, and NLSPATH. EXIT STATUS
The following exit values are returned: 0 Successful completion. >0 An error occurred. FILES
/etc/passwd map user names to user IDs ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ SEE ALSO
nice(1), passwd(1), priocntl(1), attributes(5), environ(5), standards(5) NOTES
The renice syntax renice [-n increment] [-i idtype] ID ... is preferred over the old syntax renice [-n increment] [-g | -p| -u] ID ... which is now obsolete. If you make the priority very negative, then the process cannot be interrupted. To regain control you must make the priority greater than 0. Users other than the privileged user cannot increase scheduling priorities of their own processes, even if they were the ones that decreased the priorities in the first place. The priocntl command subsumes the function of renice. SunOS 5.11 9 Jan 2004 renice(1)
Man Page

Featured Tech Videos