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