1dispadmin(1M) System Administration Commands dispadmin(1M)
2
3
4
6 dispadmin - process scheduler administration
7
9 dispadmin -l
10
11
12 dispadmin -c class {-g [-r res] | -s file}
13
14
15 dispadmin -d [class]
16
17
19 The dispadmin command displays or changes process scheduler parameters
20 while the system is running.
21
22
23 dispadmin does limited checking on the values supplied in file to ver‐
24 ify that they are within their required bounds. The checking, however,
25 does not attempt to analyze the effect that the new values have on the
26 performance of the system. Inappropriate values can have a negative
27 effect on system performance. (See System Administration Guide:
28 Advanced Administration.)
29
31 The following options are supported:
32
33 -c class
34
35 Specifies the class whose parameters are to be displayed or
36 changed. Valid class values are: RT for the real-time class, TS for
37 the time-sharing class, IA for the inter-active class, FSS for the
38 fair-share class, and FX for the fixed-priority class. The time-
39 sharing and inter-active classes share the same scheduler, so
40 changes to the scheduling parameters of one will change those of
41 the other.
42
43
44 -d [class]
45
46 Sets or displays the name of the default scheduling class to be
47 used on reboot when starting svc:/system/scheduler:default. If
48 class name is not specified, the name and description of the cur‐
49 rent default scheduling class is displayed. If class name is speci‐
50 fied and is a valid scheduling class name, then it is saved in dis‐
51 padmin's private configuration file /etc/dispadmin.conf. Only
52 super-users can set the default scheduling class.
53
54
55 -g
56
57 Gets the parameters for the specified class and writes them to the
58 standard output. Parameters for the real-time class are described
59 in rt_dptbl(4). Parameters for the time-sharing and inter-active
60 classes are described in ts_dptbl(4). Parameters for the fair-share
61 class are described in FSS(7). Parameters for the fixed-priority
62 class are described in fx_dptbl(4).
63
64 The -g and -s options are mutually exclusive: you may not retrieve
65 the table at the same time you are overwriting it.
66
67
68 -l
69
70 Lists the scheduler classes currently configured in the system.
71
72
73 -r res
74
75 When using the -g option you may also use the -r option to specify
76 a resolution to be used for outputting the time quantum values. If
77 no resolution is specified, time quantum values are in millisec‐
78 onds. If res is specified it must be a positive integer between 1
79 and 1000000000 inclusive, and the resolution used is the reciprocal
80 of res in seconds. For example, a res value of 10 yields time quan‐
81 tum values expressed in tenths of a second; a res value of 1000000
82 yields time quantum values expressed in microseconds. If the time
83 quantum cannot be expressed as an integer in the specified resolu‐
84 tion, it is rounded up to the next integral multiple of the speci‐
85 fied resolution.
86
87
88 -s file
89
90 Sets scheduler parameters for the specified class using the values
91 in file. These values overwrite the current values in memory—they
92 become the parameters that control scheduling of processes in the
93 specified class. The values in file must be in the format output by
94 the -g option. Moreover, the values must describe a table that is
95 the same size (has same number of priority levels) as the table
96 being overwritten. Super-user privileges are required in order to
97 use the -s option.
98
99 Specify time quantum values for scheduling classes in system clock
100 ticks, and not in constant-time units. Time quantum values are
101 based on the value of the kernel's hz variable. If kernel variable
102 hires_tick is set to 1 to get higher resolution clock behavior, the
103 actual time quanta will be reduced by the order of 10.
104
105 The -g and -s options are mutually exclusive: you may not retrieve
106 the table at the same time you are overwriting it.
107
108
110 Example 1 Retrieving the Current Scheduler Parameters for the real-time
111 class
112
113
114 The following command retrieves the current scheduler parameters for
115 the real-time class from kernel memory and writes them to the standard
116 output. Time quantum values are in microseconds.
117
118
119 dispadmin -c RT -g -r 1000000
120
121
122
123 Example 2 Overwriting the Current Scheduler Parameters for the Real-
124 time Class
125
126
127 The following command overwrites the current scheduler parameters for
128 the real-time class with the values specified in rt.config.
129
130
131 dispadmin -c RT -s rt.config
132
133
134
135 Example 3 Retrieving the Current Scheduler Parameters for the Time-
136 sharing Class
137
138
139 The following command retrieves the current scheduler parameters for
140 the time-sharing class from kernel memory and writes them to the stan‐
141 dard output. Time quantum values are in nanoseconds.
142
143
144 dispadmin -c TS -g -r 1000000000
145
146
147
148 Example 4 Overwriting the Current Scheduler Parameters for the Time-
149 sharing Class
150
151
152 The following command overwrites the current scheduler parameters for
153 the time-sharing class with the values specified in ts.config.
154
155
156 dispadmin -c TS -s ts.config
157
158
159
161 /etc/dispadmin.conf
162
163 Possible location for argument to -s option.
164
165
167 See attributes(5) for descriptions of the following attributes:
168
169
170
171
172 ┌─────────────────────────────┬─────────────────────────────┐
173 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
174 ├─────────────────────────────┼─────────────────────────────┤
175 │Availability │SUNWcsu │
176 └─────────────────────────────┴─────────────────────────────┘
177
179 priocntl(1), svcs(1), svcadm(1M), priocntl(2), fx_dptbl(4),
180 rt_dptbl(4), ts_dptbl(4), attributes(5), smf(5), FSS(7)
181
182
184 dispadmin prints an appropriate diagnostic message if it fails to over‐
185 write the current scheduler parameters due to lack of required permis‐
186 sions or a problem with the specified input file.
187
189 The default scheduling class setting facility is managed by the service
190 management facility, smf(5), under the service identifier:
191
192 svc:/system/scheduler:default
193
194
195
196 Administrative actions on this service, such as enabling, disabling, or
197 requesting restart, can be performed using svcadm(1M). Note that dis‐
198 abling the service while it is running will not change anything. The
199 service's status can be queried using the svcs(1) command.
200
201
202
203SunOS 5.11 7 Oct 2008 dispadmin(1M)