dispadmin

 

---

 
 
 
 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),  attri-
      butes(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
 
 
 

---