| blob | ad87c5611aae5202ba78589c981ed5e9a15b0a20 |
1 '\" te
2 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH FBCONF_XORG 1M "Jan 26, 2009"
7 .SH NAME
8 fbconf_xorg \- configure frame buffer devices for Xorg
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fB/usr/lib/fbconfig/fbconf_xorg\fR [\fB-dev\fR \fIdevice-file\fR]
13 [\fB-file\fR machine | system | \fIconfig-path\fR]
14 [\fB-res\fR \fIvideo-mode\fR [nocheck | noconfirm]]
15 [\fIdevice-specific-options\fR]
16 [\fB-defaults\fR] [\fB-prconf\fR] [\fB-predid\fR [raw] [parsed]] [\fB-propt\fR]
17 .fi
19 .LP
20 .nf
21 \fB/usr/lib/fbconfig/fbconf_xorg\fR [\fB-dev\fR \fIdevice-file\fR] [\fB-prconf\fR] [\fB-propt\fR]
22 .fi
24 .LP
25 .nf
26 \fB/usr/lib/fbconfig/fbconf_xorg\fR [\fB-dev\fR \fIdevice-file\fR] [\fB-help\fR] [\fB-res\fR ?]
27 .fi
29 .LP
30 .nf
31 For \fBkfb\fR devices:
32 .fi
34 .LP
35 .nf
36 \fB/usr/lib/fbconfig/fbconf_xorg\fR [\fB-dev\fR \fIdevice-file\fR]
37 [\fB-file\fR machine | system | \fIconfig-path\fR]
38 [\fB-res\fR \fIvideo-mode\fR [nocheck | noconfirm]]
39 [\fB-deflinear\fR true | false] [\fB-defoverlay\fR true | false]
40 [\fB-deftransparent\fR true | false]
41 [\fB-doublehigh\fR enable | disable]
42 [\fB-g\fR \fIgamma-correction-value\fR]
43 [\fB-multisample\fR available | disable | forceon]
44 [-\fBoffset\fR \fIx-val\fR \fIy-val\fR] [\fB-samples\fR 1 | 2 | 4 | 8 | 16 ]
45 [\fB-slave\fR disable | multiview] [\fB-stereo\fR true | false]
46 [\fB-defaults\fR] [\fB-prconf\fR] [\fB-predid\fR [raw] [parsed]] [\fB-propt\fR]
47 .fi
49 .SH DESCRIPTION
50 .LP
51 The \fBfbconf_xorg\fR utility configures Frame Buffer devices and some of the
52 X11 window system defaults for Xorg by updating the \fBxorg.conf\fR
53 configuration file.
54 .sp
55 .LP
56 The first \fBfbconf_xorg\fR command form shown in the \fBSYNOPSIS\fR section
57 stores the specified option values in the \fBxorg.conf\fR configuration file.
58 These settings are used to initialize the frame buffer device the next time the
59 window system is run on that device. The persistence of these settings across
60 window system sessions and system reboots is determined by the \fBxorg.conf\fR
61 file.
62 .sp
63 .LP
64 The second and third command forms display information, and do not alter the
65 \fBxorg.conf\fR file. The presence of the \fB-help\fR and/or \fB-res\fR \fB?\fR
66 options will cause any other option (not shown in the third form) to be
67 ignored.
68 .sp
69 .LP
70 You can configure only one frame buffer device at a time. To configure multiple
71 devices, invoke the \fBfbconf_xorg\fR utility separately for each device.
72 .sp
73 .LP
74 Only frame buffer device options can be specified with \fBfbconf_xorg\fR. Use
75 the normal window system options to specify default depth (see
76 \fBsvccfg\fR(1M)), default visual class, and so forth. Specify these as device
77 modifiers on the command line. See\fI Xserver(1)\fR, part of the OpenWindows,
78 not the SunOS, man page collection.
79 .sp
80 .LP
81 You can specify which \fBxorg.conf\fR file to open. By default,
82 \fBfbconf_xorg\fR opens the machine-specific file, \fB/etc/X11/xorg.conf\fR.
83 Use the \fB-file\fR option to specify an alternate file. For example, the
84 system-global file, \fB/usr/X11/xorg.conf\fR, can be opened instead.
85 .sp
86 .LP
87 These standard \fBxorg.conf\fR files can be written only by the superuser or
88 someone with the Primary Administrator role. Consequently, the
89 \fBfbconf_xorg\fR program is run with setuid root permission.
90 .SH OPTIONS
91 .LP
92 The following options are supported for all frame buffer devices:
93 .sp
94 .ne 2
95 .na
96 \fB\fB-defaults\fR\fR
97 .ad
98 .sp .6
99 .RS 4n
100 Sets configuration options for the specified device to their default values.
101 This does not affect the \fB-res\fR video mode setting. See the device-specific
102 portions of the \fBDEFAULTS\fR section below.
103 .RE
105 .sp
106 .ne 2
107 .na
108 \fB\fB-dev\fR \fIdevice-file\fR\fR
109 .ad
110 .sp .6
111 .RS 4n
112 Specifies the frame buffer device by either its full pathname or simple
113 filename (for example, \fB/dev/fbs/kfb0\fR or \fBkfb0\fR). Pathnames of
114 installed devices can be displayed using the \fB-list\fR option to
115 \fBfbconfig\fR(1M). If the \fB-dev\fR option is omitted, the default device,
116 \fB/dev/fb\fR, is used.
117 .RE
119 .sp
120 .ne 2
121 .na
122 \fB\fB-file\fR \fBmachine\fR | \fBsystem\fR | \fIconfig-path\fR\fR
123 .ad
124 .sp .6
125 .RS 4n
126 Specifies which \fBxorg.conf\fR file to open. If \fBmachine\fR is specified,
127 the machine-specific \fB/etc/X11/xorg.conf\fR file is opened. If system is
128 specified, the global \fB/usr/X11/xorg.conf\fR file is opened. The absolute
129 pathname of a configuration file can be used instead. If the specified file
130 does not exist and is to be updated, it will be created. The file system that
131 will contain the \fBxorg.conf\fR file must be writable by someone with
132 superuser-like privileges. This option has no effect unless other options are
133 specified. The default is \fBmachine\fR.
134 .RE
136 .sp
137 .ne 2
138 .na
139 \fB\fB-help\fR\fR
140 .ad
141 .sp .6
142 .RS 4n
143 Display the \fBfbconf_xorg\fR command line options that are supported in
144 conjunction with the frame buffer device, along with a brief explanation of
145 each option. The frame buffer device can be specified using the \fB-dev\fR
146 option.
147 .RE
149 .sp
150 .ne 2
151 .na
152 \fB\fB-prconf\fR\fR
153 .ad
154 .sp .6
155 .RS 4n
156 Display the current configuration for the frame buffer device and attached
157 display device(s). The frame buffer device can be specified using the
158 \fB-dev\fR option.
159 .sp
160 The \fB-prconf\fR output might resemble:
161 .sp
162 .in +2
163 .nf
164 Monitor/Resolution Information:
165 Monitor manufacturer: SUN
166 Product Code: 4
167 Serial Number: 12212555
168 Manufacture date: 2000, week 9
169 EDID Version: 1.1
170 Monitor dimensions: 36x29 cm
171 Default Gamma: 2.62
172 Monitor preferred resolution: SUNW_STD_1280x1024x60
173 Monitor supported resolutions from EDID: SUNW_STD_1280x1024x60,
174 SUNW_STD_1280x1024x76, 1152x900x66, VESA_STD_1280x1024x75,
175 VESA_STD_1280x1024x60, SUNW_STD_1152x900x66,
176 VESA_STD_720x400x70, VESA_STD_640x480x60,
177 VESA_STD_640x480x67, VESA_STD_640x480x72,
178 VESA_STD_640x480x75, VESA_STD_800x600x56,
179 VESA_STD_800x600x60, VESA_STD_800x600x72,
180 VESA_STD_800x600x75, VESA_STD_832x624x75,
181 VESA_STD_1024x768x60, VESA_STD_1024x768x70, 1024x768x75
182 Current resolution setting: FALLBACK_1152x900x66
184 Framelock Configuration:
185 Slave Mode: Disabled
186 .fi
187 .in -2
188 .sp
190 .RE
192 .sp
193 .ne 2
194 .na
195 \fB\fB-predid\fR [\fBraw\fR] [\fBparsed\fR]\fR
196 .ad
197 .sp .6
198 .RS 4n
199 Display the E-EDID (Enhanced Extended Display Identification Data) information
200 obtained from the display device(s), which must be online, connected to the
201 frame buffer. The frame buffer device can be specified using the \fB-dev\fR
202 option. The output will be raw hexadecimal and/or human-readable (parsed) text.
203 The default is parsed.
204 .sp
205 The \fB-predid\fR raw output might resemble:
206 .sp
207 .in +2
208 .nf
209 --- EDID Data for /dev/fbs/kfb0 ---
211 Block 0: EDID Base Block
212 0x00: 00 FF FF FF FF FF FF 00 04 43 06 F2 01 00 00 00
213 0x10: 01 11 01 04 0F 2B 20 78 2B 9C 68 A0 57 4A 9B 26
214 0x20: 12 48 4C FF FF 80 A9 59 A9 4F A9 4A A9 45 81 99
215 0x30: 81 80 61 59 45 59 48 3F 40 30 62 B0 32 40 40 C0
216 0x40: 13 00 AB 40 11 00 00 1E 00 00 00 FD 00 32 5A 1E
217 0x50: 6E 17 04 11 00 C8 90 00 50 3C 00 00 00 F7 00 0A
218 0x60: F7 0F 03 87 C0 00 00 00 00 00 00 00 00 00 00 FC
219 0x70: 00 41 42 43 20 4C 43 44 32 31 0A 20 20 20 00 0B
220 .fi
221 .in -2
222 .sp
224 .RE
226 .sp
227 .ne 2
228 .na
229 \fB\fB-propt\fR\fR
230 .ad
231 .sp .6
232 .RS 4n
233 Display all option settings for the frame buffer device, either as they
234 currently are or as they will be represented in the \fBxorg.conf\fR
235 configuration file when \fBfbconf_xorg\fR completes. The device can be
236 specified using the \fB-dev\fR option, and the file using the \fB-file\fR
237 option.
238 .sp
239 The \fB-propt\fR output might resemble:
240 .sp
241 .in +2
242 .nf
243 --- Graphics Configuration for /dev/fbs/kfb0 ---
245 xorg.conf: machine -- /etc/X11/xorg.conf
246 Screen section: "kfb0"
247 Device section: "kfb0"
248 Monitor section: "kfb0"
250 Video Mode: SUNW_STD_1280x1024x76
251 StereoEnable: False
253 Multisample Information:
254 Multisample Mode: Disable
255 Samples Per Pixel: 4
257 Screen Information:
258 DoubleWide: Disabled
259 DoubleHigh: Disabled
260 Offset/Overlap: [0, 0]
262 Visual Information:
263 Default Visual: Non-Linear Normal Visual
264 Gamma Correction Value: Using gamma value 2.22
265 .fi
266 .in -2
267 .sp
269 .RE
271 .sp
272 .ne 2
273 .na
274 \fB\fB-res\fR \fB?\fR\fR
275 .ad
276 .sp .6
277 .RS 4n
278 Display a list of video modes that can be used with the \fB-res\fR
279 \fIvideo-mode\fR option.
280 .sp
281 The \fB?\fR argument may need to be escaped or placed in quotes (\e?, "?",
282 or '?'), to protect it from misinterpretation by the shell.
283 .sp
284 The \fB-res\fR \fB?\fR output might resemble:
285 .sp
286 .in +2
287 .nf
288 Video modes accepted by the -res option:
289 AUTO [1][2]
290 NONE [1][2]
291 SUNW_STD_1920x1200x75
292 SUNW_STD_1920x1200x70
293 SUNW_DIG_1920x1200x60
294 SUNW_STD_1920x1080x72
295 SUNW_DIG_1920x1080x60
296 ...
297 ...
298 VESA_STD_640x480x75 [1]
299 VESA_STD_640x480x72 [1]
300 VESA_STD_640x480x60 [1]
302 [1] Resolution is supported by monitor
303 [2] Preferred resolution for monitor
304 .fi
305 .in -2
306 .sp
308 Abbreviations such as "\fB1280x1024x75\fR" might also be used.
309 .RE
311 .sp
312 .ne 2
313 .na
314 \fB\fB-res\fR \fIvideo-mode\fR [\fBnocheck\fR | \fBnoconfirm\fR]\fR
315 .ad
316 .sp .6
317 .RS 4n
318 Set the video mode for the display device that is connected to the frame buffer
319 device.
320 .sp
321 A list of video modes can be displayed using the \fB-res\fR \fB?\fR option.
322 .sp
323 The basic format of a video-mode is \fIwidth\fRx\fIheight\fRx\fIrate\fR, where:
324 .RS +4
325 .TP
326 .ie t \(bu
327 .el o
328 \fIwidth\fR is the screen width in pixels.
329 .RE
330 .RS +4
331 .TP
332 .ie t \(bu
333 .el o
334 \fIheight\fR is the screen height in pixels.
335 .RE
336 .RS +4
337 .TP
338 .ie t \(bu
339 .el o
340 \fIrate\fR is the vertical frequency of the screen refresh.
341 .RE
342 A video-mode argument may have an \fB@\fR (at sign) instead of \fBx\fR
343 preceding the refresh rate. For instance, \fB1280x1024x76\fR and
344 \fB1280x1024@76\fR are equivalent.
345 .sp
346 A video-mode name may carry additional information, as with
347 \fBSUNW_STD_1280x1024x76\fR.
348 .sp
349 The \fB-res\fR argument, \fBauto\fR, represents the video mode that is
350 currently programmed into the device. The argument, \fBnone\fR, is a synonym
351 for \fBauto\fR.
352 .sp
353 Note that some video modes might be inappropriate for certain frame buffer
354 devices and/or display devices.
355 .sp
356 The \fB-res\fR option accepts suboption keywords following the video-mode
357 specification.
358 .sp
359 .ne 2
360 .na
361 \fB\fBnocheck\fR\fR
362 .ad
363 .sp .6
364 .RS 4n
365 The \fBnocheck\fR suboption causes the video-mode argument to be accepted,
366 regardless of whether it is supported by the currently attached monitor,
367 whether it is known within the current configuration, and so forth. Note that
368 using an unchecked, inappropriate video mode can leave the system without
369 usable video output. This suboption is useful if a different monitor is to be
370 connected to the frame buffer device. This suboption also implies
371 \fBnoconfirm\fR.
372 .RE
374 .sp
375 .ne 2
376 .na
377 \fB\fBnoconfirm\fR\fR
378 .ad
379 .sp .6
380 .RS 4n
381 If the video-mode argument is unable to be validated, the default action is to
382 display a warning message and ask the user whether to continue. The
383 \fBnoconfirm\fR suboption suppresses this confirmation request. This suboption
384 is useful when \fBfbconf_xorg\fR is being run from a shell script.
385 .RE
387 .RE
389 .sp
390 .LP
391 The following device-specific options are supported for certain frame buffer
392 devices. Unless specified otherwise, these options do not take effect until the
393 user logs out and back in.
394 .sp
395 .ne 2
396 .na
397 \fB\fB-deflinear\fR \fBtrue\fR | \fBfalse\fR\fR
398 .ad
399 .sp .6
400 .RS 4n
401 This option selects the default X visual. Two types of visuals are supported,
402 linear and nonlinear. Linear visuals are gamma corrected. Nonlinear visuals are
403 not.
404 .sp
405 If the value of this option is \fBtrue\fR, the default visual is set to default
406 depth 24 and the default class is \fBTrueColor\fR with gamma correction
407 enabled. If \fBfalse\fR, a nonlinear visual that satisfies the other default
408 visual selection options, such as the default depth and default class, is
409 chosen as the default visual.
410 .sp
411 The \fB-deflinear\fR, \fB-defoverlay\fR, and \fB-deftransparent\fR options each
412 select the default X visual. Only one of these may be enabled at a time.
413 Enabling one causes the others to be disabled.
414 .RE
416 .sp
417 .ne 2
418 .na
419 \fB\fB-defoverlay\fR \fBtrue\fR | \fBfalse\fR\fR
420 .ad
421 .sp .6
422 .RS 4n
423 This option selects the default X visual. The \fBkfb\fR device provides an
424 8-bit PseudoColor visual whose pixels are disjoint from the rest of the
425 visuals. This is called the overlay visual. Windows created in this visual will
426 not damage windows created in other visuals. The converse, however, is not
427 true: Windows created in other visuals will damage overlay windows.
428 .sp
429 If the value of this option is \fBtrue\fR, the overlay visual is the default
430 visual. The default depth is 8-bit and the default class is PseudoColor. If
431 \fBfalse\fR, the non-overlay visual that satisfies the other default visual
432 selection options, such as the default depth and the default class, is chosen
433 as the default visual.
434 .sp
435 The \fB-deflinear\fR, \fB-defoverlay\fR, and \fB-deftransparent\fR options each
436 select the default X visual. Only one of these may be enabled at a time.
437 Enabling one causes the others to be disabled.
438 .RE
440 .sp
441 .ne 2
442 .na
443 \fB\fB-deftransparent\fR \fBtrue\fR | \fBfalse\fR\fR
444 .ad
445 .sp .6
446 .RS 4n
447 This option selects the default X visual. The \fBkfb\fR device provides an
448 8-bit PseudoColor visual whose pixels are disjoint from the rest of the
449 visuals. This is called the overlay visual. Windows created in this visual will
450 not damage windows created in other visuals.
451 .sp
452 If the value of this option is \fBtrue\fR, the overlay visual used as the
453 default is a transparent overlay visual. A visual with transparency supports a
454 colormap with 255 colors and one transparent pixel. The default depth is 8-bit
455 and the default class is PseudoColor. If \fBfalse\fR, the nonoverlay visual
456 that satisfies the other default visual selection options, such as the default
457 depth and the default class, is chosen as the default visual.
458 .sp
459 The \fB-deflinear\fR, \fB-defoverlay\fR, and \fB-deftransparent\fR options each
460 select the default X visual. Only one of these may be enabled at a time.
461 Enabling one causes the others to be disabled.
462 .RE
464 .sp
465 .ne 2
466 .na
467 \fB\fB-doublehigh\fR \fBenable\fR | \fBdisable\fR\fR
468 .ad
469 .sp .6
470 .RS 4n
471 Configures the two outputs of the frame buffer device into one vertical virtual
472 display. The default is \fBdisable\fR. The \fB-doublewide\fR and
473 \fB-doublehigh\fR options are mutually exclusive. Enabling one causes the other
474 to be disabled.
475 .RE
477 .sp
478 .ne 2
479 .na
480 \fB\fB-doublewide\fR \fBenable\fR | \fBdisable\fR\fR
481 .ad
482 .sp .6
483 .RS 4n
484 Configures the two outputs of the frame buffer device into one horizontal
485 virtual display. The default is \fBdisable\fR. The \fB-doublewide\fR and
486 \fB-doublehigh\fR options are mutually exclusive. Enabling one causes the other
487 to be disabled.
488 .RE
490 .sp
491 .ne 2
492 .na
493 \fB\fB-g\fR \fIgamma-correction-value\fR\fR
494 .ad
495 .sp .6
496 .RS 4n
497 Sets the gamma correction value. All linear visuals provide gamma correction.
498 The gamma correction value should be in the range, \fB0.1\fR to \fB10.0\fR. The
499 default is \fB2.22\fR. This option can be used while the window system is
500 running. Changing the gamma correction value affects all of the windows
501 displayed by linear visuals.
502 .RE
504 .sp
505 .ne 2
506 .na
507 \fB\fB-gfile\fR \fIgamma-correction-file\fR\fR
508 .ad
509 .sp .6
510 .RS 4n
511 Loads the gamma correction table from the file specified by
512 \fIgamma-correction-file\fR. This text file specifies the gamma correction
513 values for the R, G, and B channels. Three consecutive values form an RGB
514 triplet. For a \fBkfb\fR device, there must be exactly 256 RGB triplets. A
515 value may be represented in hexadecimal, decimal, or octal format (for example,
516 \fB0x3FF\fR, \fB1023\fR, or \fB01777\fR, respectively). Values are separated by
517 one or more whitespace or new line characters. Comments begin with a hash sign
518 character (\fB#\fR) and end at the end of the line.
519 .sp
520 You can load the gamma correction table with this option while the window
521 system is running. The new gamma correction affects all the windows being
522 displayed using the linear visuals. When gamma correction is done using a
523 user-specified table, the gamma correction value (\fB-g\fR) is undefined. By
524 default, the window system assumes a gamma correction value of \fB2.22\fR and
525 loads the gamma table it creates corresponding to this value.
526 .sp
527 The following is an example of a \fIgamma-correction-file\fR file:
528 .sp
529 .in +2
530 .nf
531 # Gamma Correction Table
532 0x00 0x00 0x00
533 0x01 0x01 0x01
534 0x02 0x02 0x02
535 ... ... ...
536 ... ... ...
537 0xFF 0xFF 0xFF
538 .fi
539 .in -2
540 .sp
542 .RE
544 .sp
545 .ne 2
546 .na
547 \fB\fB-multisample\fR \fBavailable\fR | \fBdisable\fR | \fBforceon\fR\fR
548 .ad
549 .sp .6
550 .RS 4n
551 If set to disable, no multisample is possible. If set to available, multisample
552 is possible but is selected on a per-window basis using a library interface. If
553 set to \fBforceon\fR, all Sun OpenGL windows are rendered using multisampling.
554 To query the number of samples used, specify the \fB-propt\fR option or run the
555 \fBxglinfo\fR utility. The \fBxglinfo\fR utility can return the number of
556 multisamples if \fB-multisample\fR is set to available. The default is
557 \fBdisable\fR. \fBxglinfo\fR is described in the \fBxglinfo(1)\fR man page, in
558 the Sun OpenGL man page collection.
559 .RE
561 .sp
562 .ne 2
563 .na
564 \fB\fB-offset\fR \fIx-val\fR \fIy-val\fR\fR
565 .ad
566 .sp .6
567 .RS 4n
568 Adjusts the position of the specified stream by the value specified. This
569 option is only implemented in \fB-doublewide\fR and \fB-doublehigh\fR modes.
570 For \fB-doublewide\fR, use the \fIx-val\fR to position the rightmost stream.
571 Negative is left (overlaps with the left stream). For \fB-doublehigh\fR, use
572 the \fIy-val\fR to position the bottom stream. Negative is up (overlaps with
573 top stream). The default is \fB[0,0]\fR.
574 .RE
576 .sp
577 .ne 2
578 .na
579 \fB\fB-samples\fR \fB1\fR | \fB2\fR | \fB4\fR | \fB8\fR | \fB16\fR\fR
580 .ad
581 .sp .6
582 .RS 4n
583 Requests the number of samples to compute per display pixel. The requested
584 number of samples per pixel is used if \fB-multisample\fR is not disabled and
585 resources exist for the request. To query the number of samples used, specify
586 the \fB-propt\fR option or run the \fBxglinfo\fR utility. The \fBxglinfo\fR
587 utility can return the number of multisamples after you specify the option
588 \fB-multisample\fR available. The default is \fB4\fR.
589 .RE
591 .sp
592 .ne 2
593 .na
594 \fB\fB-slave\fR \fBdisable\fR | \fBmultiview\fR\fR
595 .ad
596 .sp .6
597 .RS 4n
598 If you set the \fBmultiview\fR argument for the \fB-slave\fR option, the device
599 synchronizes video with a master through the multiview genlock ribbon cable.
600 The system should be powered off whenever connecting or disconnecting this
601 cable. Both devices should be running the same resolution and the option should
602 be issued when the window system is running. The default is \fBdisable\fR.
603 .RE
605 .SH DEFAULTS
606 .LP
607 Certain options have implied default arguments. The default argument is used
608 when the option is not present on the \fBfbconf_xorg\fR command line. For
609 instance, a default argument for \fB-dev\fR is \fB/dev/fb\fR.
610 .sp
611 .LP
612 Options that set configuration state do not have implied defaults. The
613 \fB-res\fR option is one example. If a configuration option is omitted from the
614 \fBfbconf_xorg\fR command line, the corresponding \fBxorg.conf\fR configuration
615 setting will remain unchanged. The exception is that if configuration options
616 are mutually exclusive, setting one will automatically unset each of the
617 others. An example is \fB-deflinear\fR, \fB-defoverlay\fR, and
618 \fB-deftransparent\fR.
619 .sp
620 .LP
621 If a configuration setting is not present in the configura tion file when the
622 window system is run, a default value will be used. For instance, the default
623 state associated with \fB-res\fR is \fBauto\fR. A setting might not be present
624 in the file, or the file itself might not exist, until \fBfbconf_xorg\fR has
625 been invoked with the corresponding command line option.
626 .sp
627 .LP
628 The \fB-defaults\fR option sets the default values for most configuration
629 settings.
630 .sp
631 .LP
632 Options and their defaults are shown below.
633 .sp
634 .LP
635 Device-independent defaults:
636 .sp
637 .in +2
638 .nf
639 Option Default Argument
640 -dev /dev/fb
641 -file machine
643 Option Default State
644 -res auto
645 .fi
646 .in -2
647 .sp
649 .sp
650 .LP
651 \fBkfb\fR-specific defaults:
652 .sp
653 .in +2
654 .nf
655 Option Default State or -defaults Value
656 -deflinear false
657 -defoverlay false
658 -deftransparent false
659 -doublehigh disable
660 -doublewide disable
661 -g 2.22
662 -multisample disable
663 -offset 0 0
664 -samples 4
665 -slave disable
666 -stereo false
667 .fi
668 .in -2
669 .sp
671 .SH EXAMPLES
672 .LP
673 \fBExample 1 \fRSwitching the Resolution of the Monitor Type
674 .sp
675 .LP
676 The following example sets the video mode for the monitor on the
677 \fB/dev/fbs/kfb0\fR device to 1280 x 1024 at 76 Hz:
679 .sp
680 .in +2
681 .nf
682 example% \fBfbconf_xorg -dev kfb0 -res 1280x1024x76\fR
683 .fi
684 .in -2
685 .sp
687 .SH EXIT STATUS
688 .LP
689 The following exit values are returned:
690 .sp
691 .ne 2
692 .na
693 \fB\fB0\fR\fR
694 .ad
695 .sp .6
696 .RS 4n
697 Execution completed successfully.
698 .RE
700 .sp
701 .ne 2
702 .na
703 \fB\fB1\fR\fR
704 .ad
705 .sp .6
706 .RS 4n
707 Invalid command line usage.
708 .RE
710 .sp
711 .ne 2
712 .na
713 \fB\fB2\fR\fR
714 .ad
715 .sp .6
716 .RS 4n
717 An error occurred.
718 .RE
720 .SH FILES
721 .ne 2
722 .na
723 \fB\fB/dev/fb\fR\fR
724 .ad
725 .sp .6
726 .RS 4n
727 Symbolic link to the default frame buffer device.
728 .RE
730 .sp
731 .ne 2
732 .na
733 \fB\fB/dev/fbs/kfb\fIn\fR\fR\fR
734 .ad
735 .sp .6
736 .RS 4n
737 Device special file for a \fBkfb\fR frame buffer
738 .RE
740 .sp
741 .ne 2
742 .na
743 \fB\fB/usr/lib/fbconfig/SunModes_xorg.conf\fR\fR
744 .ad
745 .sp .6
746 .RS 4n
747 Video mode definitions included in new configuration files.
748 .RE
750 .SH ATTRIBUTES
751 .LP
752 See \fBattributes\fR(5) for descriptions of the following attributes:
753 .sp
755 .sp
756 .TS
757 box;
758 c | c
759 l | l .
760 ATTRIBUTE TYPE ATTRIBUTE VALUE
761 _
762 Interface Stability Uncommitted
763 .TE
765 .SH SEE ALSO
766 .LP
767 \fBfbconfig\fR(1M), \fBsvccfg\fR(1M), \fBattributes\fR(5), \fBkfb\fR(7D),
768 \fBfbio\fR(7I)
769 .sp
770 .LP
771 See the \fIXorg(1)\fR and \fIXserver(1)\fR man pages in the X Server man page
772 collection and the \fIxglinfo(1)\fR man page in the Sun OpenGL man page
773 collection.