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 dis-
		       played 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	scheduler,  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	sched-
		       uling 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/dispad-
		       min.conf. Only super-users can set the default schedul-
		       ing class.

       -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). 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  retrieve  the table	at the same time you are over-
		       writing 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 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 res-
		       olution,	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 con-
		       trol 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 lev-
		       els) as the table being overwritten. Super-user	privi-
		       leges are required in order to use the -s option.

		       Specify	time  quantum values for scheduling classes in
		       system clock ticks, and	not  in	 constant-time	units.
		       Time  quantum values are	based on the value of the ker-
		       nel's hz	variable.  If kernel  variable	hires_tick  is
		       set  to	1 to get higher	resolution clock behavior, the
		       actual time quanta will be reduced by the order of 10.

		       The -g and -s options are mutually exclusive:  you  may
		       not  retrieve  the table	at the same time you are over-
		       writing 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.10			  7 Oct	2002			 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.10>

home | help