Content-type: text/html Man page of SUNWkfb_config

SUNWkfb_config

Section: System Administration Commands (1M)
Updated: 29 Jun 2006
Index Return to Main Contents
 

NAME

SUNWkfb_config - fbconfig module for configuring the Sun XVR-2500 Graphics Device  

SYNOPSIS

/usr/lib/fbconfig/SUNWkfb_config [-dev device-filename] [ -res video-mode] [ -file machine | system] [ -deflinear true | false] [ -defoverlay true | false] [ -deftransparent true | false] [ -slave disable | multiview] [-g gamma-correction-value] [-gfile gamma-correction-file] [ -doublewide enable | disable] [ -doublehigh enable | disable] [ -multisample available | disable | forceon] [ -samples 1 | 2 | 4 | 8 | 16 ] [ -offset xval yval] [-propt] [-prconf] [-defaults]

/usr/lib/fbconfig/SUNWkfb_config [-propt] [-prconf]

/usr/lib/fbconfig/SUNWkfb_config [-help] [ -res ?]  

DESCRIPTION

SUNWkfb_config configures the Sun XVR-2500 Graphics Accelerator and some of the X11 window system defaults for the Sun XVR-2500.

The first form of SUNWkfb_config shown in the SYNOPSIS section stores the specified options in the OWconfig file. These options initialize the Sun XVR-2500 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. For the third form, all other options are ignored.

You can specify options for only one device at a time. If you want to specify options for multiple devices, invoke the SUNWkfb_config utility multiple times.

Only the Sun XVR-2500 options can be specified through the SUNWkfb_config utility. Use the normal window system options to specify default depth (see svccfg(1M)), 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, SUNWkfb_config updates the machine-specific file in the /etc/openwin directory tree. Use the -file option to specify an alternate file. 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 SUNWkfb_config program, which is owned by the root user, always runs with setuid root permission.  

OPTIONS

The following options are supported:

-defaults

Resets all option values except -dev to their default values. This option sets the resolution override to none which implies that the last video mode setting is preserved. If no monitor is attached, the video mode is set to 1152x900x66.

-deflinear true | false

This option selects the default X visual. The Sun XVR-2500 device supports two types of visuals: linear and nonlinear. Linear visuals are gamma corrected and nonlinear visuals are not.

If the value of this option is true, the default visual is set to default depth 24 and the default class is TrueColor with gamma correction enabled. If false, a non-linear visual that satisfies the other default visual selection options, such as the default depth and default class, is chosen as the default visual. See Xsun(1).

The -deflinear, -defoverlay, and -deftransparent options all select the default X visual. Only one option may be enabled at the same time. If more than one of these options is entered, the last selection takes precedence and the other options are disabled.

-defoverlay true | false

This option selects the default X visual. The Sun XVR-2500 device provides an 8-bit PseudoColor visual whose pixels are disjoint from the rest of the visuals. This is called the overlay visual. Windows created in this visual will not damage windows created in other visuals. The converse, however, is not true. Windows created in other visuals will damage overlay windows.

If the value of this option is true, the overlay visual is the default visual. The default depth is 8 bit and the default class is PseudoColor. If false, the nonoverlay visual that satisfies the other default visual selection options, such as the default depth and the default class, is chosen as the default visual. See Xsun(1).

The -deflinear, -defoverlay, and -deftransparent options all select the default X visual. Only one option may be enabled at the same time. If more than one of these options is entered, the last selection takes precedence and the other options are disabled.

-deftransparent true | false

This option selects the default X visual. The Sun XVR-2500 device provides an 8-bit PseudoColor visual whose pixels are disjoint from the rest of the visuals. This is called the overlay visual. Windows created in this visual will not damage windows created in other visuals.

If the value of this option is true, the overlay visual used as the default is a transparent overlay visual. A visual with transparency supports a colormap with 255 colors and one transparent pixel. The default depth is 8 bit and the default class is PseudoColor. If false, the nonoverlay visual that satisfies the other default visual selection options, such as the default depth and the default class, is chosen as the default visual. See Xsun(1).

The -deflinear, -defoverlay, and -deftransparent options all select the default X visual. Only one option may be enabled at the same time. If more than one of these options is entered, the last selection takes precedence and the other options are disabled.

-dev device-filename

Specifies the SunXVR-2500 special file. The default is /dev/fbs/kfb0.

-doublehigh enable | disable

Configures the two outputs of the Sun XVR-2500 device into one vertical virtual display. The default is disable.

-doublewide enable | disable

Configures the two outputs of the Sun XVR-2500 device into one horizontal virtual display. The default is disable.

-file machine|system

Specifies which OWconfig file to update. If machine is specified, the machine-specific OWconfig file in the /etc/openwin directory tree is updated. If system is specified, the global OWconfig file in the /usr/openwin directory tree is updated. If the specified file does not exist, it is created. This option has no effect unless other options are specified. The default is machine.

-g gamma-correction value

Changes the gamma correction value. All linear visuals provide gamma correction. By default, the gamma correction value is 2.22. Any value less than zero is illegal. This option can be used while the window system is running. Changing the gamma correction value affects all of the windows displayed by linear visuals.

-gfile gamma-correction file

Loads the gamma correction table from the file specified by gamma-correction file. Format this file to provide the gamma correction values for R, G, and B channels on each line. Specify each value in hexadecimal format, separated from another value by at least one space. The gamma-correction file file should provide 1024 such triplets.

You can load the gamma correction table with this option while the window system is running. The new gamma correction affects all the windows 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

-help

Prints a list of the SUNWkfb_config command line options, along with a brief explanation of each.

-multisample available | disable | forceon

If set to disable, no multisample is possible. If set to available, multisample is possible but is selected on a per-window basis using a library interface. If set to forceon, all Sun OpenGL windows are rendered using multisampling. Query the number of samples used with -propt or the xglinfo(1) utility. The xglinfo utility can return the number of multisamples if -multisample is set to available. The default is disable.

-offset xval yval

Adjusts the position of the specified stream by the value specified. This option is only implemented in -doublewide and -doublehigh modes. For -doublewide, use the xval to position the rightmost stream. Negative is left (overlaps with the left stream). For -doublehigh, use the yval to position the bottom stream. Negative is up (overlaps with top stream). The default is [0, 0].

-prconf

Prints the Sun XVR-2500 hardware configuration. This is a typical display:


--- Hardware Configuration for /dev/fbs/kfb2 ---

Type: XVR-2500
PROM Information: @(#) xvr2500.fth 14.106 05/08/15 SMI

Monitor/Resolution Information:
   Monitor Manufacturer: SUN
   Product code: 1352
   Serial #: 7225675
   Manufacture date: 1997, week 51
   Monitor dimensions: 48x31 cm
   Monitor preferred resolution: 1920x1200x70
   Separate sync supported: yes
   Composite sync supported: yes
   EDID: Version 1, Revision 1
   Supported resolutions: 1920x1200x70, SUNW_STD_1600x1000x76,
    SUNW_STD_1600x1000x66, SUNW_STD_1440x900x76, 1920x1080x70,
    1600x900x76, 1600x900x66, 1440x810x76, 1280x720x76,
    1920x1080x72, VESA_STD_720x400x70, VESA_STD_720x400x88,
    VESA_STD_640x480x60, VESA_STD_640x480x67,
    VESA_STD_800x600x56, VESA_STD_800x600x60,
    VESA_STD_800x600x72, VESA_STD_800x600x75,
    VESA_STD_1024x768x70, VESA_STD_1280x1024x75,
   Current resolution setting: SUNW_STD_1280x1024x76

Framelock Configuration:
 Slave Mode: Disabled

-propt

Prints the current values of all Sun XVR-2500 options in the OWconfig file specified by the -file option for the device specified by the -dev option. Prints the values of options as they will be in the OWconfig file after the call to SUNWkfb_config completes.

This is a typical display:


--- OpenWindows Configuration for /dev/fbs/kfb2 ---

OWconfig: machine
Video Mode: SUNW_STD_1280x1024x76

Multisample Information:
 Multisample Mode: Disabled (multisample visuals will not be available)
 Samples Per Pixel: N/A (multisampling disabled)

Screen Information:
 DoubleWide: Disabled
 DoubleHigh: Disabled
 Offset/Overlap: [0, 0]

Visual Information:
 Default Visual: Non-Linear Normal Visual
 Gamma Correction Value: using gamma value 2.22

-res video-mode

Specifies the video mode of the monitor connected to the specified Sun XVR-2500 device.

You must specify the video mode with the -res option. You can specify video-mode in the format of widthxheightxrate or as a symbolic name. The format of these built-in video modes is:

widthxheightxrate

width is the screen width in pixels, height is the screen height in pixels, and rate is the vertical frequency of the screen refresh.

You can use the s suffix to specify stereo video modes. The s suffix of 960x680x112s and 960x680x108s means that these are stereo video modes.

As a convenience, the -res option also accepts formats with @ (at sign) in front of the refresh rate instead of x, as for example, [email protected]. Some video-modes supported by the Sun XVR-2500 device may not be supported by the monitor.

You can obtain the list of video-modes supported by the Sun XVR-2500 device and the monitor by running SUNWkfb_config with the -res ? option. See SYNOPSIS.

Symbolic Names

Some video modes have symbolic names defined for them. Instead of using the widthxheightxrate format, you can specify one of the symbolic names as the argument to the -res option. The meaning of the symbolic name none is that when the window system is run, the screen resolution is the video mode that is currently programmed in the device.

The following symbolic names and their corresponding video modes are supported:


Name          Cprresponding Video Mode
svga          1024x768x60
1152          1152x900x76
1280          1280x1024x76
stereo        960x680x112s
none          (see text above)

-samples 1 | 2 | 4 | 8 | 16

Requests the number of samples to compute per display pixel. The requested number of samples per pixel is used if -multisample is not disabled and resources exist for the request. Query the number of samples used with -propt or the xglinfo(1) utility. The xglinfo utility can return the number of multisamples after you specify the option -multisample available. The default is 4.

-slave disable | multiview

If you set the multiview argument for the -slave option, the device synchronizes video with a master through the multiview ribbon cable. Both devices should be running the same resolution and the option should be issued when the window system is running. The default is disable.

 

DEFAULTS

For a given invocation of the SUNWkfb_config command line, if an option does not appear on the command line, the corresponding OWconfig option is not updated and retains its previous value.

When the window system is run, if a Sun XVR-2500 option has never been specified by way of SUNWkfb_config, a default value is used. The options and their corresponding defaults are as follows:

OptionDefault
-dev/dev/fbs/kfb0
-filemachine
-resnone
-deflinearfalse
-defoverlayfalse
-deftransparentfalse
-slavedisable
-g2.22
-samples4
-multisampledisable
-doublewidedisable
-doublehighdisable
-outputsdirect
-offset[0,0]

The default for the -res option of none means that when the window system is run, the screen resolution is the video mode that is currently programmed in the device.  

EXAMPLES

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 kfb0 -res 1280x1024x76 
 

FILES

/dev/fbs/kfbn Device special file for the XVR-2500 high performance single screen

/usr/sbin/kfbdaemon The kfb memory manager

 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWkfbcf
Interface StabilityEvolving

 

SEE ALSO

fbconfig(1M), svccfg(1M), mmap(2), attributes(5), kfb(7D), fbio(7I)

See the Xsun(1) man page in the OpenWindows man page collection and the xglinfo(1) man page in the Sun Open GL man page collection.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
DEFAULTS
EXAMPLES
FILES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:10 GMT, October 02, 2010