dispadmin(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SUMMARY OF TRUSTED SOLARIS CHANGES | ATTRIBUTES | SEE ALSO | DIAGNOSTICS

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

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu

SEE ALSO

Trusted Solaris 8 Reference Manual

priocntl(2)

SunOS 5.8 Reference Manual

priocntl(1), rt_dptbl(4), ts_dptbl(4), attributes(5)

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.

Trusted Solaris 8  Last Revised 3 Apr 1997

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SUMMARY OF TRUSTED SOLARIS CHANGES | ATTRIBUTES | SEE ALSO | DIAGNOSTICS