renice(8)						      System Manager's Manual							 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 industry standards and associated tags.

OPTIONS

       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.  Interprets operands following the option as process group IDs.  Interprets operands following the option as user  names.
       Resets renice operand interpretation to be process IDs (the default).

OPERANDS

       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.  A user name or user ID.  All processes with a set_user_ID equal to the specified value are affected.  A process group
       ID.  All processes in the process group are affected.  A process ID.  Only this process is affected.  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 process IDs, process group IDs, or user names.  When you issue
       the renice command 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  with-
       out 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: Runs affected processes when no other processes are running on the system.  Runs  at  the
       base scheduling priority.  Runs affected processes very quickly.

       [Tru64 UNIX]  The preceding values are mapped by the command to those actually 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).

ENVIRONMENT VARIABLES

       The following environment variables affect the execution of renice: 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.	 If  set  to  a  non-empty  string
       value,  overrides the values of all the other internationalization variables.  Determines the locale for the interpretation of sequences of
       bytes of text data as characters (for example, single-byte as opposed to multibyte characters in arguments).  Determines the locale for the
       format  and contents of diagnostic messages written to standard error.  Determines the location of message catalogues for the processing of
       LC_MESSAGES.

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

FILES

       Specifies the command path

EXIT VALUES

       The following exit values are returned:

       Successful completion An error occurred

RELATED INFORMATION

       Commands: nice(1)

       Functions: getpriority(2)

       Others: standards(5) delim off

																	 renice(8)