hpux man page for renice

renice(1M)																renice(1M)

NAME
       renice - alter priority of running processes

SYNOPSIS
       newoffset] id ...

DESCRIPTION
       The  command  alters  the  system nice value (used in the system scheduling priority) of one or more running processes specified by id ....
       The new system nice value is set to 20 + newoffset, and is limited to the range 0 to 39.  However if the environment variable is  set,  the
       new  system  nice  value is set to current nice value + newoffset.  Processes with lower system nice values run at higher system priorities
       than processes with higher system nice values.  The option of the command shows the current priority and nice  value  for  processes.   See
       also nice(1).

       To  reduce the system nice value of a process, or to set it to a value less than 20 (with a negative newoffset), a user must have appropri-
       ate privileges.	Otherwise, users cannot decrease the system nice value of a process and can only increase it within the range 20 to 39, to
       prevent overriding any current administrative restrictions.

       To  alter  the system nice value of another user's process, a user must have appropriate privileges.  Otherwise, users can only affect pro-
       cesses that they own.

   Options
       recognizes the following options.  If no or option is specified, the default is

	      Interpret each id as a process group ID.	All processes in each process group have their system nice value altered.  Only users with
			     appropriate privileges can use this option.

	      Change the system nice value of each affected process to 20 +
			     newoffset.  If the environment variable is set, the  system nice value of each affected process is changed to current
			     nice value + newoffset.

			     If newoffset is negative, the system nice value is set to 20 minus the absolute value of newoffset.  If the  environ-
			     ment  variable  is  set  and  the newoffset is negative, the system nice value is set to current nice value minus the
			     absolute value of newoffset.  Only users with appropriate privileges can reduce the system nice value or  set  it	to
			     less than 20.  If this option is omitted, newoffset defaults to 10.

	      Interpret each id as a process ID.  This is the default.

			     Note: id is a process ID as reported by the command, not a job number (e.g., as used by some shells.

	      Interpret each id  as  a	user  name  or	user  ID number.  All processes owned by each specified user have their system nice values
			     altered.  Only users with appropriate privileges can use this option for user names and IDs other than their own.

RETURN VALUES
       returns a 0 when successful, and a non-zero value when unsuccessful.

EXTERNAL INFLUENCES
       Single-byte character code sets are supported.

DIAGNOSTICS
       reports the old and new newoffset values (system nice value - 20) of the affected processes if the operation requested  completes  success-
       fully.  Otherwise, an error message is displayed to indicate the reason for failure.

       However, if the environment variable is set, no reporting is done unless the command fails.

EXAMPLES
       Use  default  values  to decrease the priority of process The id type defaults to and newoffset defaults to setting the process to a system
       nice value of 30.

       Change the system nice value for all processes owned by user and user to 33 (newoffset=13).   (Affecting  other	users  processes  requires
       appropriate privileges.)

       Change  the system nice value of all processes in process group 20 to (Lowering the system nice value of a process group requires appropri-
       ate privileges.)

WARNINGS
       Users who do not have appropriate privileges cannot reduce the system nice values of their own processes, even if they  increased  them	in
       the first place.

FILES
       Maps user names to user
			   ID's

SEE ALSO
       nice(1), ps(1), getpriority(2), nice(2).

STANDARDS CONFORMANCE
																	renice(1M)