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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
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 dif-
       ferent 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 schedul-
       ing 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	must be	in the range 1-19; if not specified, an	incre-
	     ment of 10	is assumed. An increment greater than 19 is equivalent
	     to	19.

	     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:  LC_CTYPE,  LC_MESSAGES,  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 values:

       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			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       csh(1),	 ksh(1),   nohup(1),  priocntl(1),  sh(1),  shell_builtins(1),
       nice(2),	attributes(5), environ(5), XPG4(5)

SunOS 5.9			  2 Jan	2002			       nice(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | ENVIRONMENT VARIABLES | EXIT STATUS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=nice&sektion=1&manpath=SunOS+5.9>

home | help