1fbconf_xorg(1M) System Administration Commands fbconf_xorg(1M)
2
6 fbconf_xorg - configure frame buffer devices for Xorg
7
9 /usr/lib/fbconfig/fbconf_xorg [-dev device-file]
10 [-file machine | system | config-path]
11 [-res video-mode [nocheck | noconfirm]]
12 [device-specific-options]
13 [-defaults] [-prconf] [-predid [raw] [parsed]] [-propt]
14 /usr/lib/fbconfig/fbconf_xorg [-dev device-file] [-prconf] [-propt]
17 /usr/lib/fbconfig/fbconf_xorg [-dev device-file] [-help] [-res ?]
20 For kfb devices:
23 /usr/lib/fbconfig/fbconf_xorg [-dev device-file]
26 [-file machine | system | config-path]
27 [-res video-mode [nocheck | noconfirm]]
28 [-deflinear true | false] [-defoverlay true | false]
29 [-deftransparent true | false]
30 [-doublehigh enable | disable]
31 [-g gamma-correction-value]
32 [-multisample available | disable | forceon]
33 [-offset x-val y-val] [-samples 1 | 2 | 4 | 8 | 16 ]
34 [-slave disable | multiview] [-stereo true | false]
35 [-defaults] [-prconf] [-predid [raw] [parsed]] [-propt]
36
39 The fbconf_xorg utility configures Frame Buffer devices and some of the
40 X11 window system defaults for Xorg by updating the xorg.conf configu‐
41 ration file.
42 The first fbconf_xorg command form shown in the SYNOPSIS section stores
45 the specified option values in the xorg.conf configuration file. These
46 settings are used to initialize the frame buffer device the next time
47 the window system is run on that device. The persistence of these set‐
48 tings across window system sessions and system reboots is determined by
49 the xorg.conf file.
50 The second and third command forms display information, and do not
53 alter the xorg.conf file. The presence of the -help and/or -res ?
54 options will cause any other option (not shown in the third form) to be
55 ignored.
56 You can configure only one frame buffer device at a time. To configure
59 multiple devices, invoke the fbconf_xorg utility separately for each
60 device.
61 Only frame buffer device options can be specified with fbconf_xorg. Use
64 the normal window system options to specify default depth (see svc‐
65 cfg(1M)), default visual class, and so forth. Specify these as device
66 modifiers on the command line. See Xserver(1), part of the OpenWindows,
67 not the SunOS, man page collection.
68 You can specify which xorg.conf file to open. By default, fbconf_xorg
71 opens the machine-specific file, /etc/X11/xorg.conf. Use the -file
72 option to specify an alternate file. For example, the system-global
73 file, /usr/X11/xorg.conf, can be opened instead.
74 These standard xorg.conf files can be written only by the superuser or
77 someone with the Primary Administrator role. Consequently, the
78 fbconf_xorg program is run with setuid root permission.
79
81 The following options are supported for all frame buffer devices:
82 -defaults
84 Sets configuration options for the specified device to their
86 default values. This does not affect the -res video mode setting.
87 See the device-specific portions of the DEFAULTS section below.
88 -dev device-file
91 Specifies the frame buffer device by either its full pathname or
93 simple filename (for example, /dev/fbs/kfb0 or kfb0). Pathnames of
94 installed devices can be displayed using the -list option to fbcon‐
95 fig(1M). If the -dev option is omitted, the default device,
96 /dev/fb, is used.
97 -file machine | system | config-path
100 Specifies which xorg.conf file to open. If machine is specified,
102 the machine-specific /etc/X11/xorg.conf file is opened. If system
103 is specified, the global /usr/X11/xorg.conf file is opened. The
104 absolute pathname of a configuration file can be used instead. If
105 the specified file does not exist and is to be updated, it will be
106 created. The file system that will contain the xorg.conf file must
107 be writeable by someone with superuser-like privileges. This option
108 has no effect unless other options are specified. The default is
109 machine.
110 -help
113 Display the fbconf_xorg command line options that are supported in
115 conjunction with the frame buffer device, along with a brief expla‐
116 nation of each option. The frame buffer device can be specified
117 using the -dev option.
118 -prconf
121 Display the current configuration for the frame buffer device and
123 attached display device(s). The frame buffer device can be speci‐
124 fied using the -dev option.
125 The -prconf output might resemble:
127 Monitor/Resolution Information:
129 Monitor manufacturer: SUN
130 Product Code: 4
131 Serial Number: 12212555
132 Manufacture date: 2000, week 9
133 EDID Version: 1.1
134 Monitor dimensions: 36x29 cm
135 Default Gamma: 2.62
136 Monitor preferred resolution: SUNW_STD_1280x1024x60
137 Monitor supported resolutions from EDID: SUNW_STD_1280x1024x60,
138 SUNW_STD_1280x1024x76, 1152x900x66, VESA_STD_1280x1024x75,
139 VESA_STD_1280x1024x60, SUNW_STD_1152x900x66,
140 VESA_STD_720x400x70, VESA_STD_640x480x60,
141 VESA_STD_640x480x67, VESA_STD_640x480x72,
142 VESA_STD_640x480x75, VESA_STD_800x600x56,
143 VESA_STD_800x600x60, VESA_STD_800x600x72,
144 VESA_STD_800x600x75, VESA_STD_832x624x75,
145 VESA_STD_1024x768x60, VESA_STD_1024x768x70, 1024x768x75
146 Current resolution setting: FALLBACK_1152x900x66
147 Framelock Configuration:
149 Slave Mode: Disabled
150 -predid [raw] [parsed]
155 Display the E-EDID (Enhanced Extended Display Identification Data)
157 information obtained from the display device(s), which must be
158 online, connected to the frame buffer. The frame buffer device can
159 be specified using the -dev option. The output will be raw hexadec‐
160 imal and/or human-readable (parsed) text. The default is parsed.
161 The -predid raw output might resemble:
163 --- EDID Data for /dev/fbs/kfb0 ---
165 Block 0: EDID Base Block
167 0x00: 00 FF FF FF FF FF FF 00 04 43 06 F2 01 00 00 00
168 0x10: 01 11 01 04 0F 2B 20 78 2B 9C 68 A0 57 4A 9B 26
169 0x20: 12 48 4C FF FF 80 A9 59 A9 4F A9 4A A9 45 81 99
170 0x30: 81 80 61 59 45 59 48 3F 40 30 62 B0 32 40 40 C0
171 0x40: 13 00 AB 40 11 00 00 1E 00 00 00 FD 00 32 5A 1E
172 0x50: 6E 17 04 11 00 C8 90 00 50 3C 00 00 00 F7 00 0A
173 0x60: F7 0F 03 87 C0 00 00 00 00 00 00 00 00 00 00 FC
174 0x70: 00 41 42 43 20 4C 43 44 32 31 0A 20 20 20 00 0B
175 -propt
180 Display all option settings for the frame buffer device, either as
182 they currently are or as they will be represented in the xorg.conf
183 configuration file when fbconf_xorg completes. The device can be
184 specified using the -dev option, and the file using the -file
185 option.
186 The -propt output might resemble:
188 --- Graphics Configuration for /dev/fbs/kfb0 ---
190 xorg.conf: machine -- /etc/X11/xorg.conf
192 Screen section: "kfb0"
193 Device section: "kfb0"
194 Monitor section: "kfb0"
195 Video Mode: SUNW_STD_1280x1024x76
197 StereoEnable: False
198 Multisample Information:
200 Multisample Mode: Disable
201 Samples Per Pixel: 4
202 Screen Information:
204 DoubleWide: Disabled
205 DoubleHigh: Disabled
206 Offset/Overlap: [0, 0]
207 Visual Information:
209 Default Visual: Non-Linear Normal Visual
210 Gamma Correction Value: Using gamma value 2.22
211 -res ?
216 Display a list of video modes that can be used with the -res video-
218 mode option.
219 The ? argument may need to be escaped or placed in quotes (\?, "?",
221 or '?'), to protect it from misinterpretation by the shell.
222 The -res ? output might resemble:
224 Video modes accepted by the -res option:
226 AUTO [1][2]
227 NONE [1][2]
228 SUNW_STD_1920x1200x75
229 SUNW_STD_1920x1200x70
230 SUNW_DIG_1920x1200x60
231 SUNW_STD_1920x1080x72
232 SUNW_DIG_1920x1080x60
233 ...
234 ...
235 VESA_STD_640x480x75 [1]
236 VESA_STD_640x480x72 [1]
237 VESA_STD_640x480x60 [1]
238 [1] Resolution is supported by monitor
240 [2] Preferred resolution for monitor
241 Abbreviations such as "1280x1024x75" might also be used.
244 -res video-mode [nocheck | noconfirm]
247 Set the video mode for the display device that is connected to the
249 frame buffer device.
250 A list of video modes can be displayed using the -res ? option.
252 The basic format of a video-mode is widthxheightxrate, where:
254 o width is the screen width in pixels.
256 o height is the screen height in pixels.
258 o rate is the vertical frequency of the screen refresh.
260 A video-mode argument may have an @ (at sign) instead of x preced‐
261 ing the refresh rate. For instance, 1280x1024x76 and 1280x1024@76
262 are equivalent.
263 A video-mode name may carry additional information, as with
265 SUNW_STD_1280x1024x76.
266 The -res argument, auto, represents the video mode that is cur‐
268 rently programmed into the device. The argument, none, is a synonym
269 for auto.
270 Note that some video modes might be inappropriate for certain frame
272 buffer devices and/or display devices.
273 The -res option accepts suboption keywords following the video-mode
275 specification.
276 nocheck
278 The nocheck suboption causes the video-mode argument to be
280 accepted, regardless of whether it is supported by the cur‐
281 rently attached monitor, whether it is known within the current
282 configuration, and so forth. Note that using an unchecked,
283 inappropriate video mode can leave the system without usable
284 video output. This suboption is useful if a different monitor
285 is to be connected to the frame buffer device. This suboption
286 also implies noconfirm.
287 noconfirm
290 If the video-mode argument is unable to be validated, the
292 default action is to display a warning message and ask the user
293 whether to continue. The noconfirm suboption suppresses this
294 confirmation request. This suboption is useful when fbconf_xorg
295 is being run from a shell script.
296 The following device-specific options are supported for certain frame
301 buffer devices. Unless specified otherwise, these options do not take
302 effect until the user logs out and back in.
303 -deflinear true | false
305 This option selects the default X visual. Two types of visuals are
307 supported, linear and nonlinear. Linear visuals are gamma cor‐
308 rected. Nonlinear visuals are not.
309 If the value of this option is true, the default visual is set to
311 default depth 24 and the default class is TrueColor with gamma cor‐
312 rection enabled. If false, a nonlinear visual that satisfies the
313 other default visual selection options, such as the default depth
314 and default class, is chosen as the default visual.
315 The -deflinear, -defoverlay, and -deftransparent options each
317 select the default X visual. Only one of these may be enabled at a
318 time. Enabling one causes the others to be disabled.
319 -defoverlay true | false
322 This option selects the default X visual. The kfb device provides
324 an 8-bit PseudoColor visual whose pixels are disjoint from the rest
325 of the visuals. This is called the overlay visual. Windows created
326 in this visual will not damage windows created in other visuals.
327 The converse, however, is not true: Windows created in other visu‐
328 als will damage overlay windows.
329 If the value of this option is true, the overlay visual is the
331 default visual. The default depth is 8-bit and the default class is
332 PseudoColor. If false, the non-overlay visual that satisfies the
333 other default visual selection options, such as the default depth
334 and the default class, is chosen as the default visual.
335 The -deflinear, -defoverlay, and -deftransparent options each
337 select the default X visual. Only one of these may be enabled at a
338 time. Enabling one causes the others to be disabled.
339 -deftransparent true | false
342 This option selects the default X visual. The kfb device provides
344 an 8-bit PseudoColor visual whose pixels are disjoint from the rest
345 of the visuals. This is called the overlay visual. Windows created
346 in this visual will not damage windows created in other visuals.
347 If the value of this option is true, the overlay visual used as the
349 default is a transparent overlay visual. A visual with transparency
350 supports a colormap with 255 colors and one transparent pixel. The
351 default depth is 8-bit and the default class is PseudoColor. If
352 false, the nonoverlay visual that satisfies the other default vis‐
353 ual selection options, such as the default depth and the default
354 class, is chosen as the default visual.
355 The -deflinear, -defoverlay, and -deftransparent options each
357 select the default X visual. Only one of these may be enabled at a
358 time. Enabling one causes the others to be disabled.
359 -doublehigh enable | disable
362 Configures the two outputs of the frame buffer device into one ver‐
364 tical virtual display. The default is disable. The -doublewide and
365 -doublehigh options are mutually exclusive. Enabling one causes the
366 other to be disabled.
367 -doublewide enable | disable
370 Configures the two outputs of the frame buffer device into one hor‐
372 izontal virtual display. The default is disable. The -doublewide
373 and -doublehigh options are mutually exclusive. Enabling one causes
374 the other to be disabled.
375 -g gamma-correction-value
378 Sets the gamma correction value. All linear visuals provide gamma
380 correction. The gamma correction value should be in the range, 0.1
381 to 10.0. The default is 2.22. This option can be used while the
382 window system is running. Changing the gamma correction value
383 affects all of the windows displayed by linear visuals.
384 -gfile gamma-correction-file
387 Loads the gamma correction table from the file specified by gamma-
389 correction-file. This text file specifies the gamma correction val‐
390 ues for the R, G, and B channels. Three consecutive values form an
391 RGB triplet. For a kfb device, there must be exactly 256 RGB
392 triplets. A value may be represented in hexadecimal, decimal, or
393 octal format (for example, 0x3FF, 1023, or 01777, respectively).
394 Values are separated by one or more whitespace or new line charac‐
395 ters. Comments begin with a hash sign character (#) and end at the
396 end of the line.
397 You can load the gamma correction table with this option while the
399 window system is running. The new gamma correction affects all the
400 windows being displayed using the linear visuals. When gamma cor‐
401 rection is done using a user-specified table, the gamma correction
402 value (-g) is undefined. By default, the window system assumes a
403 gamma correction value of 2.22 and loads the gamma table it creates
404 corresponding to this value.
405 The following is an example of a gamma-correction-file file:
407 # Gamma Correction Table
409 0x00 0x00 0x00
410 0x01 0x01 0x01
411 0x02 0x02 0x02
412 ... ... ...
413 ... ... ...
414 0xFF 0xFF 0xFF
415 -multisample available | disable | forceon
420 If set to disable, no multisample is possible. If set to available,
422 multisample is possible but is selected on a per-window basis using
423 a library interface. If set to forceon, all Sun OpenGL windows are
424 rendered using multisampling. To query the number of samples used,
425 specify the -propt option or run the xglinfo utility. The xglinfo
426 utility can return the number of multisamples if -multisample is
427 set to available. The default is disable. xglinfo is described in
428 the xglinfo(1) man page, in the Sun OpenGL man page collection.
429 -offset x-val y-val
432 Adjusts the position of the specified stream by the value speci‐
434 fied. This option is only implemented in -doublewide and -double‐
435 high modes. For -doublewide, use the x-val to position the right‐
436 most stream. Negative is left (overlaps with the left stream). For
437 -doublehigh, use the y-val to position the bottom stream. Negative
438 is up (overlaps with top stream). The default is [0,0].
439 -samples 1 | 2 | 4 | 8 | 16
442 Requests the number of samples to compute per display pixel. The
444 requested number of samples per pixel is used if -multisample is
445 not disabled and resources exist for the request. To query the num‐
446 ber of samples used, specify the -propt option or run the xglinfo
447 utility. The xglinfo utility can return the number of multisamples
448 after you specify the option -multisample available. The default is
449 4.
450 -slave disable | multiview
453 If you set the multiview argument for the -slave option, the device
455 synchronizes video with a master through the multiview genlock rib‐
456 bon cable. The system should be powered off whenever connecting or
457 disconnecting this cable. Both devices should be running the same
458 resolution and the option should be issued when the window system
459 is running. The default is disable.
460
463 Certain options have implied default arguments. The default argument is
464 used when the option is not present on the fbconf_xorg command line.
465 For instance, a default argument for -dev is /dev/fb.
466 Options that set configuration state do not have implied defaults. The
469 -res option is one example. If a configuration option is omitted from
470 the fbconf_xorg command line, the corresponding xorg.conf configuration
471 setting will remain unchanged. The exception is that if configuration
472 options are mutually exclusive, setting one will automatically unset
473 each of the others. An example is -deflinear, -defoverlay, and -def‐
474 transparent.
475 If a configuration setting is not present in the configura tion file
478 when the window system is run, a default value will be used. For
479 instance, the default state associated with -res is auto. A setting
480 might not be present in the file, or the file itself might not exist,
481 until fbconf_xorg has been invoked with the corresponding command line
482 option.
483 The -defaults option sets the default values for most configuration
486 settings.
487 Options and their defaults are shown below.
490 Device-independent defaults:
493 Option Default Argument
495 -dev /dev/fb
496 -file machine
497 Option Default State
499 -res auto
500 kfb-specific defaults:
505 Option Default State or -defaults Value
507 -deflinear false
508 -defoverlay false
509 -deftransparent false
510 -doublehigh disable
511 -doublewide disable
512 -g 2.22
513 -multisample disable
514 -offset 0 0
515 -samples 4
516 -slave disable
517 -stereo false
518
522 Example 1 Switching the Resolution of the Monitor Type
523 The following example sets the video mode for the monitor on the
526 /dev/fbs/kfb0 device to 1280 x 1024 at 76 Hz:
527 example% fbconf_xorg -dev kfb0 -res 1280x1024x76
530
534 The following exit values are returned:
535 0
537 Execution completed successfully.
539 1
542 Invalid command line usage.
544 2
547 An error occurred.
549
552 /dev/fb
553 Symbolic link to the default frame buffer device.
555 /dev/fbs/kfbn
558 Device special file for a kfb frame buffer
560 /usr/lib/fbconfig/SunModes_xorg.conf
563 Video mode definitions included in new configuration files.
565
568 See attributes(5) for descriptions of the following attributes:
569 ┌─────────────────────────────┬─────────────────────────────┐
574 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
575 ├─────────────────────────────┼─────────────────────────────┤
576 │Availability │SUNWkfbcf │
577 ├─────────────────────────────┼─────────────────────────────┤
578 │Interface Stability │Uncommitted │
579 └─────────────────────────────┴─────────────────────────────┘
580
582 fbconfig(1M), svccfg(1M), attributes(5), kfb(7D), fbio(7I)
583 See the Xorg(1) and Xserver(1) man pages in the X Server man page col‐
586 lection and the xglinfo(1) man page in the Sun OpenGL man page collec‐
587 tion.
588SunOS 5.11 26 Jan 2009 fbconf_xorg(1M)