priocntl Command

The priocntl utility performs four different control interfaces on the scheduling of a process:

priocntl -l

Displays configuration information

priocntl -d

Displays the scheduling parameters of processes

priocntl -s

Sets the scheduling parameters of processes

priocntl -e

Executes a command with the specified scheduling parameters

The following examples demonstrate the use of the priocntl command:

  • The -l option for the default configuration produces the following output:

    $ priocntl -l
    CONFIGURED CLASSES
    ==================
    
    SYS (System Class)
    
    TS (Time Sharing)
    Configured TS User Priority Range -60 through 60
    
    RT (Real Time)
    Maximum Configured RT Priority: 59
  • Display information about all processes, by using the following:

    $ priocntl -d -i all
    
  • Display information about all time-sharing processes, by using the following:

    $ priocntl -d -i class TS
    
  • Display information about all processes with user ID 103 or 6626, by using the following:

    $ priocntl -d -i uid 103 6626
    
  • Make the process with ID 24668 a real-time process with default parameters, by using the following:

    $ priocntl -s -c RT -i pid 24668
    
  • Make 3608 RT with priority 55 and a one-fifth second time slice, by using the following:

    $ priocntl -s -c RT -p 55 -t 1 -r 5 -i pid 3608
    
  • Change all processes into time-sharing processes, by using the following:

    $ priocntl -s -c TS -i all
    
  • Reduce TS user priority and user priority limit to -10 for uid 1122, by using the following:

    $ priocntl -s -c TS -p -10 -m -10 -i uid 1122
    
  • Start a real-time shell with default real-time priority, by using the following:

    $ priocntl -e -c RT /bin/sh
    
  • Run make with a time-sharing user priority of -10, by using the following:

    $ priocntl -e -c TS -p -10 make bigprog
    

priocntl(1) includes the interface of the nice utility. nice works only on time-sharing processes and uses higher numbers to assign lower priorities. The previous example is equivalent to using nice to set an increment of 10:

$ nice -10 make bigprog

For more information, see the priocntl(1) and nice(1) man pages.