Print this page 
9842 man page typos and spelling
Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1/priocntl.1
          +++ new/usr/src/man/man1/priocntl.1
↓ open down ↓ 23 lines elided ↑ open up ↑ 
  24   24       [\fB-i\fR \fIidtype\fR] [\fIidlist\fR]
  25   25  .fi
  26   26  
  27   27  .LP
  28   28  .nf
  29   29  \fBpriocntl\fR \fB-e\fR [\fB-c\fR \fIclass\fR] [\fIclass-specific\fR \fIoptions\fR] \fIcommand\fR
  30   30       [\fIargument(s)\fR]
  31   31  .fi
  32   32  
  33   33  .SH DESCRIPTION
  34      -.sp
  35   34  .LP
  36   35  The \fBpriocntl\fR command displays or sets scheduling parameters of the
  37   36  specified process(es). It can also be used to display the current configuration
  38   37  information for the system's process scheduler or execute a command with
  39   38  specified scheduling parameters.
  40   39  .sp
  41   40  .LP
  42   41  Processes fall into distinct classes with a separate scheduling policy applied
  43   42  to each class. The process classes currently supported are the real-time class,
  44   43  time-sharing class, interactive class, fair-share class, and the fixed priority
↓ open down ↓ 119 lines elided ↑ open up ↑ 
 164  163  .in -2
 165  164  .sp
 166  165  
 167  166  .sp
 168  167  .LP
 169  168  executes the specified command with the class and scheduling parameters
 170  169  specified on the command line (\fIarguments\fR are the arguments to the
 171  170  command). If the \fB-c\fR \fIclass\fR option is omitted the command is run in
 172  171  the user's current class.
 173  172  .SH OPTIONS
 174      -.sp
 175  173  .LP
 176  174  The following options are supported:
 177  175  .sp
 178  176  .ne 2
 179  177  .na
 180  178  \fB\fB-c\fR \fIclass\fR\fR
 181  179  .ad
 182  180  .RS 13n
 183  181  Specifies the \fIclass\fR to be set. (The valid \fIclass\fR arguments are
 184  182  \fBRT\fR for real-time, \fBTS\fR for time-sharing, \fBIA\fR for inter-active,
↓ open down ↓ 304 lines elided ↑ open up ↑ 
 489  487  .na
 490  488  \fB\fB-t\fR \fItqntm\fR\fR
 491  489  .ad
 492  490  .RS 16n
 493  491  [\fB-r\fR \fIres\fR] Sets the time quantum of the specified process(es) to
 494  492  \fItqntm\fR. You can optionally specify a resolution as explained below.
 495  493  .RE
 496  494  
 497  495  .SH USAGE
 498  496  .SS "Real-Time Class"
 499      -.sp
 500  497  .LP
 501  498  The real-time class provides a fixed priority preemptive scheduling policy for
 502  499  those processes requiring fast and deterministic response and absolute
 503  500  user/application control of scheduling priorities. If the real-time class is
 504  501  configured in the system, it should have exclusive control of the highest range
 505  502  of scheduling priorities on the system. This ensures that a runnable real-time
 506  503  process is given \fBCPU\fR service before any process belonging to any other
 507  504  class.
 508  505  .sp
 509  506  .LP
↓ open down ↓ 94 lines elided ↑ open up ↑ 
 604  601  invoking \fBpriocntl\fR must either be super-user, or must currently be in the
 605  602  real-time class (shell running as a real-time process) with a real or effective
 606  603  user \fBID\fR matching the real or effective user \fBID\fR of the target
 607  604  process.
 608  605  .sp
 609  606  .LP
 610  607  The real-time priority, time quantum, and time quantum signal are inherited
 611  608  across the \fBfork\fR(2) and \fBexec\fR(2) system calls. When using the time
 612  609  quantum signal with a user defined signal handler across the \fBexec\fR(2)
 613  610  system call, the new image must install an appropriate user defined signal
 614      -handler before the time quantum expires. Otherwise, unpredicable behavior would
      611 +handler before the time quantum expires. Otherwise, unpredictable behavior would
 615  612  result.
 616  613  .SS "Time-Sharing Class"
 617      -.sp
 618  614  .LP
 619  615  The time-sharing scheduling policy provides for a fair and effective allocation
 620  616  of the \fBCPU\fR resource among processes with varying \fBCPU\fR consumption
 621  617  characteristics. The objectives of the time-sharing policy are to provide good
 622  618  response time to interactive processes and good throughput to \fBCPU\fR-bound
 623  619  jobs, while providing a degree of user/application control over scheduling.
 624  620  .sp
 625  621  .LP
 626  622  The time-sharing class has a range of time-sharing user priority (\fItsupri\fR)
 627  623  values that can be assigned to processes within the class. User priorities
↓ open down ↓ 65 lines elided ↑ open up ↑ 
 693  689  \fItsuprilim\fR which is being set. If an option is omitted when changing the
 694  690  class of a process to time-sharing from some other class, the associated
 695  691  parameter is set to a default value. The default value for \fItsuprilim\fR is
 696  692  \fB0\fR and the default for \fItsupri\fR is to set it equal to the
 697  693  \fItsuprilim\fR value which is being set.
 698  694  .sp
 699  695  .LP
 700  696  The time-sharing user priority and user priority limit are inherited across the
 701  697  \fBfork\fR(2) and \fBexec\fR(2) system calls.
 702  698  .SS "Inter-Active Class"
 703      -.sp
 704  699  .LP
 705  700  The inter-active scheduling policy provides for a fair and effective allocation
 706  701  of the \fBCPU\fR resource among processes with varying \fBCPU\fR consumption
 707  702  characteristics while providing good responsiveness for user interaction. The
 708  703  objectives of the inter-active policy are to provide good response time to
 709  704  interactive processes and good throughput to \fBCPU\fR-bound jobs. The
 710  705  priorities of processes in the inter-active class can be changed in the same
 711  706  manner as those in the time-sharing class, though the modified priorities
 712  707  continue to be adjusted to provide good responsiveness for user interaction.
 713  708  .sp
↓ open down ↓ 3 lines elided ↑ open up ↑ 
 717  712  equivalent to \fItsuprilim\fR.
 718  713  .sp
 719  714  .LP
 720  715  Inter-active class processes that have the \fIiamode\fR ("interactive mode")
 721  716  bit set are given a priority boost value of \fB10\fR, which is factored into
 722  717  the user mode priority of the process when that calculation is made, that is,
 723  718  every time a process's priority is adjusted. This feature is used by the X
 724  719  windowing system, which sets this bit for those processes that run inside of
 725  720  the current active window to give them a higher priority.
 726  721  .SS "Fair-Share Class"
 727      -.sp
 728  722  .LP
 729  723  The fair-share scheduling policy provides a fair allocation of system \fBCPU\fR
 730  724  resources among projects, independent of the number of processes they own.
 731  725  Projects are given "shares" to control their entitlement to \fBCPU\fR
 732  726  resources. Resource usage is remembered over time, so that entitlement is
 733  727  reduced  for heavy usage, and increased for light usage, with respect to other
 734  728  projects. \fBCPU\fR time is scheduled among processes according to their
 735  729  owner's entitlements, independent of the number of processes each project owns.
 736  730  .sp
 737  731  .LP
↓ open down ↓ 5 lines elided ↑ open up ↑ 
 743  737  \fIfssupri\fR values receive time slices more  frequently than normal.  Notice
 744  738  that user priorities do not interfere with shares. That is, changing a
 745  739  \fIfssupri\fR value of a process is not going to affect its project's overall
 746  740  \fBCPU\fR usage which only relates to the amount of shares it is allocated
 747  741  compared to other projects.
 748  742  .sp
 749  743  .LP
 750  744  The priorities of processes in the fair-share class can be changed in the same
 751  745  manner as those in the time-share class.
 752  746  .SS "Fixed-Priority Class"
 753      -.sp
 754  747  .LP
 755  748  The fixed-priority class provides a fixed priority preemptive scheduling policy
 756  749  for those processes requiring that the scheduling priorities do not get
 757  750  dynamically adjusted by the system and that the user/application have control
 758  751  of the scheduling priorities.
 759  752  .sp
 760  753  .LP
 761  754  The fixed-priority class shares the same range of scheduling priorities with
 762  755  the time-sharing class, by default. The fixed-priority class has a range of
 763  756  fixed-priority user priority (\fIfxupri\fR) values that can be assigned to
↓ open down ↓ 62 lines elided ↑ open up ↑ 
 826  819  \fIfxupri\fR and on the system configuration. See \fBfx_dptbl\fR(4).
 827  820  .sp
 828  821  .LP
 829  822  The time quantum of processes in the fixed-priority class      can be changed
 830  823  in the same manner as those in the real-time class.
 831  824  .sp
 832  825  .LP
 833  826  The fixed-priority user priority, user priority limit, and time quantum are
 834  827  inherited across the \fBfork\fR(2) and \fBexec\fR(2) system calls.
 835  828  .SH EXAMPLES
 836      -.sp
 837  829  .LP
 838  830  The following are real-time class examples:
 839  831  .LP
 840  832  \fBExample 1 \fRSetting the Class
 841  833  .sp
 842  834  .LP
 843  835  The following example sets the class of any non-real-time processes selected by
 844  836  \fIidtype\fR and \fIidlist\fR to real-time and sets their real-time priority to
 845  837  the default value of \fB0\fR. The real-time priorities of any processes
 846  838  currently in the real-time class are unaffected. The time quantums of all of
↓ open down ↓ 85 lines elided ↑ open up ↑ 
 932  924  
 933  925  .sp
 934  926  .in +2
 935  927  .nf
 936  928  example% \fBpriocntl -e -c FX -m 20 -p 10 -t 250 command\fR
 937  929  .fi
 938  930  .in -2
 939  931  .sp
 940  932  
 941  933  .SH EXIT STATUS
 942      -.sp
 943  934  .LP
 944  935  The following exit values are returned:
 945  936  .sp
 946  937  .LP
 947  938  For options \fB-d\fR, \fB-l\fR, and \fB-s\fR:
 948  939  .sp
 949  940  .ne 2
 950  941  .na
 951  942  \fB\fB0\fR\fR
 952  943  .ad
↓ open down ↓ 20 lines elided ↑ open up ↑ 
 973  964  .sp
 974  965  .ne 2
 975  966  .na
 976  967  \fB\fB1\fR\fR
 977  968  .ad
 978  969  .RS 5n
 979  970  Command could not be executed at the specified priority.
 980  971  .RE
 981  972  
 982  973  .SH ATTRIBUTES
 983      -.sp
 984  974  .LP
 985  975  See \fBattributes\fR(5) for descriptions of the following attributes:
 986  976  .sp
 987  977  
 988  978  .sp
 989  979  .TS
 990  980  box;
 991  981  c | c
 992  982  l | l .
 993  983  ATTRIBUTE TYPE  ATTRIBUTE VALUE
 994  984  _
 995  985  CSI     Enabled
 996  986  .TE
 997  987  
 998  988  .SH SEE ALSO
 999      -.sp
1000  989  .LP
1001  990  \fBkill\fR(1), \fBnice\fR(1), \fBps\fR(1), \fBdispadmin\fR(1M), \fBexec\fR(2),
1002  991  \fBfork\fR(2), \fBpriocntl\fR(2), \fBfx_dptbl\fR(4), \fBprocess\fR(4),
1003  992  \fBrt_dptbl\fR(4), \fBattributes\fR(5), \fBzones\fR(5), \fBFSS\fR(7)
1004  993  .sp
1005  994  .LP
1006  995  \fISystem Administration Guide: Basic Administration\fR
1007  996  .SH DIAGNOSTICS
1008      -.sp
1009  997  .LP
1010  998  \fBpriocntl\fR prints the following error messages:
1011  999  .sp
1012 1000  .ne 2
1013 1001  .na
1014 1002  \fB\fBProcess(es) not found\fR\fR
1015 1003  .ad
1016 1004  .sp .6
1017 1005  .RS 4n
1018 1006  None of the specified processes exists.
↓ open down ↓ 23 lines elided ↑ open up ↑ 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX