*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> renice (8)              



NAME    [Toc]    [Back]

       renice - Alters the priority of a running process

SYNOPSIS    [Toc]    [Back]

       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

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

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

       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).

EXIT STATUS    [Toc]    [Back]

       The following exit values are returned:

       Successful completion An error occurred

EXAMPLES    [Toc]    [Back]

       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


       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.

FILES    [Toc]    [Back]

       Specifies the command path

SEE ALSO    [Toc]    [Back]

       Commands: nice(1)

       Functions: getpriority(2)

       Others: standards(5)

[ Back ]
 Similar pages
Name OS Title
renice IRIX alter priority of running processes
renice FreeBSD alter priority of running processes
renice HP-UX alter priority of running processes
renice Linux alter priority of running processes
renice OpenBSD alter priority of running processes
kill Tru64 Sends a signal to a running process
gcore FreeBSD get core images of running process
pidof Linux find the process ID of a running program.
sigqueue Tru64 Queues a signal and data to a running process
coredump Tru64 Creates a core snapshot of a running process
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service