Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dispadmin(1M)		System Administration Commands		 dispadmin(1M)

NAME
       dispadmin - process scheduler administration

SYNOPSIS
       dispadmin -l

       dispadmin -c class -g [-r res]

       dispadmin -d [class]

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  ver-
       ify  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 ef-
       fect on system performance. (See	System Administration Guide: Basic Ad-
       ministration

OPTIONS
       The following options are supported:

       -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, IA for the inter-active class, FSS
	     for the fair-share	class, and FX for  the	fixed-priority	class.
	     The  time-sharing	and inter-active classes share the same	sched-
	     uler, so changes to the scheduling	parameters of one will	change
	     those of the other.

       -d [class]
	     Sets  or  displays	the name of the	default	scheduling class to be
	     used on reboot by	the  startup  script  /etc/init.d/sysetup.  If
	     class  name  is  not  specified, the name and description	of the
	     current default scheduling	class is displayed. If class  name  is
	     specified	and is a valid scheduling class	name, then it is saved
	     in	dispadmin's private  configuration  file  /etc/dispadmin.conf.
	     Only super-users can set the default scheduling class.

       -g    Gets  the	parameters  for	the specified class and	writes them to
	     the standard output. Parameters for the real-time class  are  de-
	     scribed  in  rt_dptbl(4). Parameters for the time-sharing and in-
	     ter-active	classes	are described  in  ts_dptbl(4).Parameters  for
	     the  fair-share class are described in FSS(7). Parameters for the
	     fixed-priority class are described	in fx_dptbl(4).

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

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

       -r res
	     When  using the -g	option you may also use	the -r option to spec-
	     ify a resolution to be used for outputting	the time quantum  val-
	     ues.  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  mi-
	     croseconds. If the	time quantum cannot be expressed as an integer
	     in	the specified resolution, it is	rounded	up to the  next	 inte-
	     gral multiple of the specified resolution.

       -s file
	     Sets  scheduler parameters	for the	specified class	using the val-
	     ues in file. These	values overwrite the current  values  in  mem-
	     ory--they	become	the parameters that control scheduling of pro-
	     cesses in the specified class. The	values in file must be in  the
	     format  output  by	 the  -g option. Moreover, the values must de-
	     scribe a table that is the	same size (has same number of priority
	     levels) as	the table being	overwritten. Super-user	privileges are
	     required in order to use the -s option.

	     The -g and	-s options are mutually	exclusive:  you	 may  not  re-
	     trieve 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	 stan-
       dard 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

FILES
       /etc/dispadmin.conf

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       priocntl(1),  priocntl(2),  fx_dptbl(4),	 rt_dptbl(4), ts_dptbl(4), at-
       tributes(5), FSS(7)

       System Administration Guide: Basic  Administration  Programming	Inter-
       faces Guide

DIAGNOSTICS
       dispadmin prints	an appropriate diagnostic message if it	fails to over-
       write the current scheduler parameters due to lack of required  permis-
       sions or	a problem with the specified input file.

SunOS 5.9			  28 Jul 2001			 dispadmin(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | FILES | ATTRIBUTES | SEE ALSO | DIAGNOSTICS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dispadmin&sektion=1m&manpath=SunOS+5.9>

home | help