fbconfig [-dev device-filename] [-res video-mode [now | try] [noconfirm | nocheck]] [-file machine | system] [-deflinear true | false] [-defoverlay true | false] [-linearorder first | last] [-outputs swapped | direct] [-slave disable | multiview | stereo | bnc] [-accum enable | disable] [-g gamma-correction-value] [-gfile gamma-correction-file] [-fake8 enable | disable] [-doublewide enable | disable] [-doublehigh enable | disable] [-multisample available | disable | forceon] [-samples 1 | 2 | 4 | 8 | 16 | adaptive] [-defdepth 8 | 24] [-offset xval yval] [-propt] [-prconf] [-defaults]
fbconfig [-propt] [-prconf]
fbconfig [-help] [-res ?]
SUNWjfb_config configures the Sun XVR-600 and XVR-1200 Graphics Accelerator and some of the X11 window system defaults for the Sun XVR-600 and XVR-1200.
You can specify options for only one device at a time. If you want to specify options for multiple devices, you must invoke the SUNWjfb_config utility multiple times.
You can use the SUNWjfb_config utility to specify Sun XVR-600 or XVR-1200 specific options. Use the normal window system options to specify default depth, default visual class and so forth. Specify these as device modifiers on the command line. See Xsun(1)
You can also specify which OWconfig file to update. By default, SUNWjfb_config updates the machine-specific file in the /etc/openwin. You can specify an alternate file by using the -file option. For example, the system-global OWconfig file in the /usr/openwin directory tree can be updated instead.
Both of these standard OWconfig files can only be written by root. Consequently, the SUNWjfb_config program, which is owned by the root user, always runs with setuid root permission.
The first form of SUNWjfb_config shown in the SYNOPSIS section stores the specified options in the OWconfig file. These options initialize the Sun XVR-600 and XVR-1200 device the next time the window system is run on that device. Updating options in the OWconfig file provides persistence of these options across window system sessions and system reboots.
The second and third forms which invoke only the -prconf, -propt, -help, and -res ? options, do not update the OWconfig file. Additionally, for the third form all other options are ignored.
The following options are supported:
-accum enable | disable
This option sets the resolution override to none which implies the last video mode setting is preserved. If no monitor is attached, the video mode is set to 1152x900x66.
-deflinear true | false
If the value of this option is true, the default visual is set to the linear visual that satisfies other specified default visual selection options (specifically, the Xsun defdepth and defclass options; see Xsun(1)). If false, or if there is no linear visual that satisfies the other default visual selection options, the non-linear visual specified by these other options is chosen as the default visual. This option cannot be used when the -defoverlay option is present, because the Sun XVR-600 and XVR-1200 do not possess a linear overlay visual.
-defoverlay true | false
If the value of this option is true, the overlay visual is the default visual. If false, the nonoverlay visual that satisfies the other default visual selection options, such as defdepth and defclass, is chosen as the default visual. See Xsun(1). Whenever -defoverlay true is used, the default depth and class chosen on the openwin command line must be 8-bit PseudoColor. If not, a warning message is printed and the -defoverlay option is treated as false. This option cannot be used when the -deflinear option is present, because the Sun XVR-600 and XVR-1200 do not possess a linear overlay visual.
-defdepth 8 | 24
% /usr/sbin/svccfg -s svc:/application/x11/x11-server listprop \ 'options/default_depth'
-doublehigh enable | disable
This option is not applicable to the Sun XVR-600 device.
-doublewide enable | disable
This option is not applicable to the Sun XVR-600 device.
-fake8 enable | disable
-g gamma-correction value
-gfile gamma-correction file
You can load the gamma correction table with this option can while the window system is running. The new gamma correction affects all the window being displayed using the linear visuals. When gamma correction is done using a user specified table, the gamma correction value is undefined. By default, the window system assumes a gamma correction value of 2.22 and loads the gamma table it creates corresponding to this value.
The following is an example of a gamma-correction file file:
0x000 0x000 0x000 0x001 0x001 0x001 0x002 0x002 0x002 ... ... 0x3ff 0x3ff 0x3ff
-multisample available | disable |forceon
-offset xval yval
-outputs swapped | direct
This is a typical display:
# fbconfig -dev jfb2 -propt --- OpenWindows Configuration for /dev/fbs/jfb2 --- OWconfig: machine Video Mode: 1280x1024x60 Accum: Enabled (allocate an accumulation buffer if possible) Multisample Information: Multisample Mode: Disabled (multisample visuals will not be available) Samples Per Pixel: N/A (multisampling disabled) Screen Information: DoubleWide: Disabled DoubleHigh: Disabled Output Configuration: Direct Offset/Overlap: [0, 0] Visual Information: Default Visual: Non-Linear Normal Visual Visual Ordering: Linear Visuals are last Gamma Correction Value: 2.22 Gamma Correction Table: Available Fake8 rendering: disabled Default Visual Depth (defdepth): 8
# fbconfig -dev jfb2 -prconf --- Hardware Configuration for /dev/fbs/jfb2 --- Type: XVR-1200 Sun Serial Number: 3753101000022 Hardware Revision: -01 rev01 Manufacture Date: Thu Aug 8 12:54:16 2002 PROM Information: @(#)jfb.fth 1.8 02/10/18 SMI Monitor/Resolution Information: EDID Data: Available - EDID version 1 revision 3 Monitor type: Sun P/N 365-1415 S/N 0216ME0353 Current resolution setting: 1280x1024x60 (custom) Monitor possible resolutions: 1024x768x60, 1024x768x70, 1024x768x75, 1152x900x66, 1280x1024x60, 1280x1024x75, 1280x1024x76, 640x480x60, 800x600x75 Framelock Configuration: Slave Mode: Disabled Memory Information: Total Video Memory: 134217728 Video Memory Used: 15728640 Total Texture Memory: 268435456 Texture Memory Used: 0 Total Display List Memory: 33554432
-res video-mode [ now |try [ noconfirm | nocheck ]]
The -res option requires you to specify the video-mode. You can specify video-mode in the format of widthxheightxrate or as a symbolic name.
You can use the s suffix to specify stero video modes. The s suffix of 960x680x112s and 960x680x108s means that these are stereo video modes.
The -res option also accepts formats with @ (at sign) in front of the refresh rate instead of x, (280x1024@76). Some video-modes, supported by Sun XVR-600 and XVR-1200, might not be supported by the monitor.
The list of video-modes supported by the Sun XVR-600 and XVR-1200 device and the monitor can be obtained by running SUNWjfb_config with the -res ? option. See SYNOPSIS.
The following symbolic names and their corresponding video modes are supported:
svga 1024x768x60 1152 1152x900x76 1280 1280x1024x76 stereo 960x680x112s ntsc 640x480x60i pal 768x575x50i none Programmed video mode
The -res option accepts additional, optional arguments immediately following the video mode specification. The following additional, optional arguments are supported:
Do not use this suboption with SUNWjfb_config while the configured device is being used, for example, while running the window system. Unpredictable results can occur.
If you want to run SUNWjfb_config with the now suboption, first bring the window system down. If you use the now suboption within a window system session, the video mode is changed immediately. The width and height of the affected screen will not change until the window system is exited and re-entered again. Additionally, the system might not recognize changes in stereo mode. This usage is discouraged.
Terminating the trial by entering a character other than y or RETURN restores the previous video mode. SUNWjfb_config does not change the video mode in the OWconfig file. Other specified options still take effect. If a carriage return is typed, the user is prompted for a yes or no answer on whether to keep the new video mode. This option implies the now suboption.
If you want to run SUNWjfb_config with the now suboption, first bring the window system down. If you use the now suboption within a window system session, the video mode is changed immediately. The width and height of the affected screen will not change until the window system is exited and re-entered again. Additionally, the system might not recognize changes in stereo mode. This usage is strongly discouraged.
-samples 1 | | 4 | 8 | 16 | adaptive
-slave disable | multiview | stereo | bnc
multiview and bnc are only applicable to the Sun XVR-1200 device.
For a given invocation of SUNWjfb_config command line if an option does not appear on the command line, the corresponding OWconfig option is not updated; it retains its previous value.
When the window system is run, if an option has never been specified by way of SUNWjfb_config, a default value is used. The options and their corresponding defaults are as follows:
The default for the -res option of none means that when the window system is run the screen resolution will be the video mode that is currently programmed in the device.
This provides compatibility for users who are used to specifying the device resolution through the PROM. This means that the PROM ultimately determines the default video mode.
Example 1 Switching the Resolution of the Monitor Type
The following example switches the monitor type to 1280 ~ 1024 at 76 Hz resolution:
example% fbconfig -dev jfb0 -res 1280x1024x76
See attributes(5) for descriptions of the following attributes:
fbconfig(1M), svccfg(1M), mmap(2), attributes(5), smf(5), fbio(7I), jfb(7D)
The Xsun(1) man page, which is not part of the SunOS man page collection.