dispadmin(1M)

NAME

SYNOPSIS

dispadmin-ldispadmin-cclass-g [-rres]dispadmin-cclass-sfile

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 outputting
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 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 priority levels) as the table being overwritten. The sys_config privilege is required for the -s
option to succeed.

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 parameters 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 parameters 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.

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

dispadmin -c TS -s ts.config

SUMMARY OF TRUSTED SOLARIS CHANGES

To succeed with the -s option, this command needs
the sys_config privilege.