Maintenance Commands                                dispadmin(1M)

NAME
     dispadmin - process scheduler administration

SYNOPSIS
     dispadmin -l

     dispadmin -c class  -g  [ -r res ]

     dispadmin -c class  -s file

DESCRIPTION
     The dispadmin command displays or changes process  scheduler
     parameters while the system is running.

     dispadmin does limited checking on the  values  supplied  in
     file  to  verify that they are within their required bounds.
     The checking, however,  does  not  attempt  to  analyze  the
     effect  that  the  new values have on the performance of the
     system. Inappropriate values can have a negative  effect  on
     system performance. (See System Administration Guide, Volume
     1

OPTIONS
     -l    Lists the scheduler classes  currently  configured  in
           the system.

     -c class
           Specifies  the  class  whose  parameters  are  to   be
           displayed  or  changed. Valid class values are: RT for
           the real-time class, TS for  the  time-sharing  class,
           and  IA  for the inter-active class.  The time-sharing
           and inter-active classes share the same scheduler,  so
           changes  to  the  scheduling  parameters  of  one will
           change those of the other.

     -g    Gets the parameters for the specified class and writes
           them  to the standard output. Parameters for the real-
           time class are described  in  rt_dptbl(4).  Parameters
           for  the  time-sharing  and  inter-active  classes are
           described in ts_dptbl(4).

     -r res
           When using the -g option  you  may  also  use  the  -r
           option  to specify a resolution to be used for output-
           ting the time quantum  values.  If  no  resolution  is
           specified, time quantum values are in milliseconds. If
           res is specified it must be a positive integer between
           1 and 1000000000 inclusive, and the resolution used is
           the reciprocal of res in seconds. For example,  a  res
           value  of  10  yields time quantum values expressed in
           tenths of a second; a res value of 1000000 yields time
           quantum  values expressed in microseconds. If the time

SunOS 5.8            Last change: 3 Apr 1997                    1

Maintenance Commands                                dispadmin(1M)

           quantum cannot be  expressed  as  an  integer  in  the
           specified  resolution,  it  is  rounded up to the next
           integral multiple of the specified resolution.

     -s file
           Sets scheduler  parameters  for  the  specified  class
           using  the  values in file. These values overwrite the
           current values in memory-they  become  the  parameters
           that  control scheduling of processes in the specified
           class. The values in file must be in the format output
           by the -g option. Moreover, the values must describe a
           table that is the same size (has same number of prior-
           ity levels) as the table being overwritten. Super-user
           privileges are required in order to use the -s option.

     Note: The -g and -s options are mutually exclusive: you  may
     not  retrieve the table at the same time you are overwriting
     it.

EXAMPLES
     Example 1: Retrieving the current scheduler  parameters  for
     the real-time class.

     The following command retrieves the current scheduler param-
     eters  for the real-time class from kernel memory and writes
     them to the standard output.  Time  quantum  values  are  in
     microseconds.

     dispadmin -c RT -g -r 1000000

     Example 2: Overwriting the current scheduler parameters  for
     the real-time class.

     The  following  command  overwrites  the  current  scheduler
     parameters for the real-time class with the values specified
     in rt.config.

     dispadmin -c RT -s rt.config

     Example 3: Retrieving the current scheduler  parameters  for
     the time-sharing class.

     The following command retrieves the current scheduler param-
     eters  for  the  time-sharing  class  from kernel memory and
     writes them to the standard output. Time quantum values  are
     in nanoseconds.

     dispadmin -c TS -g -r 1000000000

     Example 4: Overwriting the current scheduler parameters  for
     the time-sharing class.

SunOS 5.8            Last change: 3 Apr 1997                    2

Maintenance Commands                                dispadmin(1M)

     The  following  command  overwrites  the  current  scheduler
     parameters for the time-sharing class with the values speci-
     fied in ts.config.

     dispadmin -c TS -s ts.config

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO
     priocntl(1), priocntl(2), rt_dptbl(4),  ts_dptbl(4),  attributes(5)
     

     System Administration Guide, Volume 1 System Interface Guide

DIAGNOSTICS
     dispadmin prints an appropriate  diagnostic  message  if  it
     fails  to  overwrite the current scheduler parameters due to
     lack of required permissions or a problem with the specified
     input file.

SunOS 5.8            Last change: 3 Apr 1997                    3