Linux and Unix priocntrl command

Quick links

About priocntrl
Syntax
Examples
Related commands
Linux and Unix main page

About priocntrl

Display's or set scheduling parameters of specified process(es)

Syntax

priocntrl [-l] [-d] [-s] [-e] [-i idtype] [idlist] [-c class] [class-specific options] [arguments]

-lDisplay a list of the classes currently configured in the system along with class-specific information about each class. The format of the class specific information displayed is described under USAGE.
-dDisplay the scheduling parameters associated with a set of processes.
-sSet the scheduling parameters associated with a set of processes.
-eExecute a specified command with the class and scheduling parameters associated with a set of processes.
-i idtypeThis option together with the idlist arguments (if any), specify one or more processes to which the priocntl command is to apply. The interpretation of idlist depends on the value of idtype. The valid idtype arguments and corresponding interpretations of idlist are as follows: 
-i pididlist is a list of process IDs. The priocntl command applies to the specified processes.
-i ppididlist is a list of parent process IDs. The priocntl command applies to all processes whose parent process ID is in
-i pgididlist is a list of process group IDs. The priocntl command applies to all processes in the specified process groups.
-i sididlist is a list of session IDs. The priocntl command applies to all processes in the specified sessions.
-i classidlist consists of a single class name (RT for real-time or TS for time-sharing or IA for inter-active). The priocntl command applies to all processes in the specified class.
-i uididlist is a list of user IDs. The priocntl command applies to all processes with an effective user ID equal to an ID from the list.
-i gididlist is a list of group IDs. The priocntl command applies to all processes with an effective group ID equal to an ID from the list.
-i allThe priocntl command applies to all existing processes. No idlist should be specified (if one is it is ignored). The permission restrictions described below still apply.

If the -i idtype option is omitted when using the -d or -s options the default idtype of pid is assumed.

-c classSpecifies the class to be set. (The valid class arguments are RT for real-time or TS for time-sharing or IA for inter-active.) If the specified class is not already configured, it will automatically be configured.
class-specific optionsThe valid class-specific options for setting real-time parameters are:
-p rtpriSet the real-time priority of the specified process(es) to rtpri.
-t tqntm [-r res]Set the time quantum of the specified process(es) to tqntm. You may optionally specify a resolution as explained below.

The valid class-specific options for setting time-sharing parameters are:

-m tsuprilimSet the user priority limit of the specified process(es) to tsuprilim.
-p tsupriSet the user priority of the specified process(es) to tsupri.

The valid class-specific options for setting inter-active
parameters are:

-m iauprilimSet the user priority limit of the specified process(es) to iauprilim.
-p iaupriSet the user priority of the specified process(es) to iaupri.
argumentsAdditional arguments to the priocntrl command.

Examples

priocntl -s -c RT -t 1 -r 10 -i idtype idlist

Sets the class of any non-real-time processes selected by idtype and idlist to real-time and sets their real-time priority to the default value of 0.

Related commands

nice
ps