unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



renice(8)							    renice(8)



NAME

  renice - Alters the priority of a running process

SYNOPSIS

  The following	syntax format is recommended:

  /usr/sbin/renice [-n increment] [-p] [-g  | -u] ID...

  The following	syntax format is obsolescent:

  /usr/sbin/renice priority [-p] pid...	[-g pgrp...] [-u user...]

STANDARDS

  Interfaces documented	on this	reference page conform to industry standards
  as follows:

  renice: XCU5.0

  Refer	to the standards(5) reference page for more information	about indus-
  try standards	and associated tags.

OPTIONS

  -n increment
      Takes the	current	priority and adds the increment.  A negative value
      for increment causes the process to run at a lower numbered, therefore
      faster, priority.

  -g  Interprets operands following the	option as process group	IDs.

  -u  Interprets operands following the	option as user names.

  -p  Resets renice operand interpretation to be process IDs (the default).

OPERANDS

  priority
      A	value interpreted as the actual	system scheduling priority, rather
      than as an increment to the existing system scheduling priority as
      specified	in the recommended form	of the command.	The priority value
      may be any integer from -20 to 20, including 0, as explained in the
      DESCRIPTION section.

  user
      A	user name or user ID.  All processes with a set_user_ID	equal to the
      specified	value are affected.

  pgrp
      A	process	group ID.  All processes in the	process	group are affected.

  pid A	process	ID.  Only this process is affected.

  ID  A	value interpreted as a user name, user ID, a process group ID, or a
      process ID, depending on the option specified.  If no options are
      specified, the value is interpreted as a process ID.


DESCRIPTION

  The renice command alters the	scheduling priority of one or more running
  processes.  The ID operands (in the recommended syntax format) or the
  option arguments (in the obsolescent syntax format) are interpreted as pro-
  cess IDs, process group IDs, or user names.  When you	issue the renice com-
  mand with the	-g option, all processes in the	process	group have their
  scheduling priority altered.	When you run the renice	command	with the -u
  option, all processes	owned by the user have their scheduling	priority
  altered.  By default,	the processes affected are specified by	their process
  IDs.

  Only root can	alter the priority of other user's processes and can set the
  priority to any value	in the range from -20 to 20.  Users without root
  privileges are restricted to altering	the priority of	processes they own
  and can only increase	their "nice value" within the range of 0 to 20.

  The following	priorities are particularly useful:

  20  Runs affected processes when no other processes are running on the sys-
      tem.

  0   Runs at the base scheduling priority.

  negative number
      Runs affected processes very quickly.

  [Tru64 UNIX]	The preceding values are mapped	by the command to those	actu-
  ally used by the kernel.

  [Tru64 UNIX]	Users who do not have root privileges cannot increase the
  scheduling priorities	of their own processes (even if	they had originally
  decreased those priorities).

EXIT STATUS

  The following	exit values are	returned:

  0   Successful completion

  >>0  An error occurred

EXAMPLES

  To change the	priority of process IDs	987 and	32, and	all processes owned
  by the daemon	and root users,	enter:

       renice +1 987 -u	daemon root -p 32

ENVIRONMENT VARIABLES

  The following	environment variables affect the execution of renice:

  LANG
      Provides a default value for the internationalization variables that
      are unset	or null. If LANG is unset or null, the corresponding value
      from the default locale is used. If any of the internationalization
      variables	contain	an invalid setting, the	utility	behaves	as if none of
      the variables had	been defined.

  LC_ALL
      If set to	a non-empty string value, overrides the	values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for	the interpretation of sequences	of bytes of
      text data	as characters (for example, single-byte	as opposed to multi-
      byte characters in arguments).

  LC_MESSAGES
      Determines the locale for	the format and contents	of diagnostic mes-
      sages written to standard	error.

  NLSPATH
      Determines the location of message catalogues for	the processing of
      LC_MESSAGES.

FILES

  /usr/sbin/renice
      Specifies	the command path

SEE ALSO

  Commands: nice(1)

  Functions: getpriority(2)

  Others: standards(5)