HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

201

202

203

204

205

206

207

208

209

210

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man1m/naaagt.1m

________________________________________________________________

___ ___

renice(1M) renice(1M)

NAME

renice - alter priority of running processes

SYNOPSIS

renice [-n newoffset][-g-p-u] id ...

DESCRIPTION

The renice command alters the system nice value (used in the system scheduling priority) of one or more

running processes speciﬁed by id .... The new system nice value is set to 20 + newoffset, and is limited to

the range 0 to 39. However if the UNIX95 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 -l option of the ps command shows the current prior-

ity (PRI) and nice value (NI) 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 appropriate privileges. Otherwise, users cannot decrease the system nice value of a pro-

cess 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. Other-

wise, users can only affect processes that they own.

Options

renice recognizes the following options. If no -g, -p,or-u option is speciﬁed, the default is

-p.

-g id ... 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.

-n newoffset Change the system nice value of each affected process to 20 + newoffset. If the

UNIX95 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 UNIX95 environment 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.

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

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

%1),

as used by some shells.

-u id ... Interpret each id as a user name or user ID number. All processes owned by each

speciﬁed 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

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

EXTERNAL INFLUENCES

Single-byte character code sets are supported.

DIAGNOSTICS

renice reports the old and new newoffset values (system nice value − 20) of the affected processes if the

operation requested completes successfully. Otherwise, an error message is displayed to indicate the rea-

son for failure.

However, if the

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

EXAMPLES

Use renice default values to decrease the priority of process 923. The id type defaults to -p, and

newoffset defaults to 10, setting the process to a system nice value of 30.

renice 923

Change the system nice value for all processes owned by user john and user 123 to 33 (newoffset=13).

(Affecting other users processes requires appropriate privileges.)

Section 1M−−702 − 1 − HP-UX Release 11i: December 2000

___