man pages section 1M: System Administration Commands

SUNWpfb_config(1M)

Name

SUNWpfb_config– fbconfig module for configuring the XVR-50 and the Sun XVR-100 Graphics Accelerator

Synopsis

For XVR-50:
/usr/lib/fbconfig/SUNWpfb_config [-dev device-filename] 
     [-res video-mode [now | try] [noconfirm | nocheck]] 
     [-file  machine | system] 
     [-fake8  enable | disable] 
     [-g  enable | disable | gamma-value] 
     [-defaults]

For Sun XVR-100:
/usr/lib/fbconfig/SUNWpfb_config [-dev device-filename] 
     [-res video-mode [now | try] [noconfirm | nocheck]] 
     [-file  machine | system] 
     [-fake8  enable | disable] 
     [-g  enable | disable | gamma-value] 
     [-doublewide  enable | disable] 
     [-doublehigh  enable | disable] 
     [-outputs  swapped | direct] 
     [-depth  8 | 24] 
     [-offset  xval yval] 
     [-defaults]

For Sun XVR-100 and XVR-50:
/usr/lib/fbconfig/SUNWpfb_config [-pt] [-prconf]

/usr/lib/fbconfig/SUNWpfb_config [-help] [-res \?]

Description

SUNWpfb_config is the XVR-50 and the Sun XVR-100 device dependent layer for fbconfig(1M). It configures the XVR-50 and the Sun XVR-100 Graphics Accelerator and some of the X11 window system defaults for the XVR-50 and Sun XVR-100. The Sun XVR-100 provides the capability to drive two monitors, each with a unique video stream (Stream #1 and Stream #2). The XVR-50 drives one video stream.

The first two forms of SUNWpfb_config shown in the SYNOPSIS section sets options for the XVR-50 and the Sun XVR-100 devices. It stores the specified options in the OWconfig file. These options initialize the XVR-50 and the Sun XVR-100 devices 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 XVR-50 and the Sun XVR-100 devices are immediately programmed if you specify the -res now.

The third form, which invokes the -prconf and -propt options, queries the XVR-50 and the Sun XVR-100 device for status.

The fourth form, which invokes the -help, and -res \? options, provides instruction on using SUNWpfb_config. Additionally, for the fourth form all other options are ignored.

You can only specify options for only one XVR-50 or Sun XVR-100 device at a time. If you want to specify options for multiple XVR-50 or Sun XVR-100 devices, you must use multiple invocations of the SUNWpfb_config command.

You can only use SUNWpfb_config to specify XVR-50 or Sun XVR-100 specific options. You can use the normal window system options to specify the default depth, default visual class and so forth as device modifiers on the command line when the X Server is started. See dtlogin(1) for information regarding the Xservers File.

You can also specify the OWconfig file to update. The machine-specific file in the /etc/openwin directory tree is updated by default. You can used the -file option to specify an alternate file. For example, you can update the system-global OWconfig file in the /usr/openwin directory tree instead.

Options

The following options are supported:

-defaults

Reset all option values to their default values.

-depth 8 | 24

Set the depth (bits per pixel) for the window system. Possible values for the -depth option are 8 or 24. You must log out of the current window system session and log back in again for the change to take effect. Any depth setting in the Xserver command line takes precedence over what is set using fbconfig. The default is 8. This option is only available with Solaris 8 or Solaris 9.

-dev device-filename

Specify the XVR-50 or the Sun XVR-100 special file. The default is /dev/fb.

-doublehigh enable | disable

Configure the two outputs of the Sun XVR-100 into one vertical virtual display. You must log out of the current window system session and log back in again for the change to take effect. The default is disable.

-doublewide enable | disable

Configure the two outputs of the Sun XVR-100 into one horizontal virtual display. You must log out of the current window system session and log back in again for the change to take effect. The default is disable.

-fake8 enable | disable

Enable or disable simple 8 bit X windows to be rendered without a hardware colormap to reduce colormap flashing. You might notice performance reductions. You must log out of the current window system session and log back in again for the change to take effect. 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 enable | disable | gamma-value

This option allows you to change 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 will affect all the windows being displayed using the linear visuals. You must log out of the current window system session and log back in again for the change to take effect. The default is disable.

-help

Print a list of the SUNWpfb_config command line options, along with a brief explanation of each option.

-offset xval yval

Adjust the position of the secondary stream on the Sun XVR-100. This option is currently implemented only for the -doublewide and -doublehigh modes. For -doublewide, use the xval to position the DVI stream, if -outputs are direct (VGA stream if -outputs are swapped). A negative value specifies the overlapped region with the primary stream. This is similar for -doublehigh, except the yval is used. Positive values are treated as 0. You must log out of the current window system session and log back in again for the change to take effect. The default is [0, 0].

-outputs swapped | direct

Reverse the positions of the -doublewide or -doublehigh outputs relative to each other on the Sun XVR-100. You must log out of the current window system session and log back in again for the change to take effect. The default is direct.

-propt

Print the current values of all XVR-50 and Sun XVR-100 options in the OWconfig file specified by the -file option for the device specified by the -dev option. Print the values of options as they will be in the OWconfig file after the call to SUNWpfb_config completes.

This is a typical display for the Sun XVR-100:

--- Graphics Configuration for /dev/fbs/pfb0 ---

OWconfig: machine
Video Mode: not set
Depth: not set

Screen Information:
        Doublewide: Disable
        Doublehigh: Disable
        Offset/Overlap: [0.0]
        Output Configuration: Direct
        Fake8 Rendering: Disable
        Gamma Configuration: Disable

-prconf

Print the XVR-50 and Sun XVR-100 hardware configuration.

This is a typical display:

--- Hardware Configuration for /dev/fbs/pfb0 ---

Type: XVR-100
ASIC: version 0x5159             REV : version 0x3000000
PROM: version 4.2

Monitor/Resolution Information:
        EDID Data: Not Available
        Current resolution setting: 1152x900x66

Depth Information:
        Possible depths:  8, 24
        Current depth: 8

-res video-mode [ now | try [ noconfirm | nocheck ]]

Specify the video mode that drives the monitor connected to the specified XVR-50 or Sun XVR-100 device.

Video modes are built-in. 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.

video-mode

Specify video-mode in the format of widthxheightxrate, where width is the screen width in pixels, height is the screen height in pixels, and rate is the vertical frequency of the screen refresh. An example video mode specified in this format is 1280x1024x60.

The -res option also accepts formats with @ preceding the refresh rate instead of x (1280x1024@60).

Symbolic Names

Some video modes have symbolic names defined for them. Instead of the form 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    Corresponding Video Mode
svga          1024x768x60
1152          1152x900x76
1280          1280x1024x75
none          Programmed video mode

Some video-modes, supported by XVR-50 and Sun XVR-100, might not be supported by the monitor. Use the -res \? option to obtain the list of video-modes supported by the XVR-50 and Sun XVR-100 device and the monitor.

The –res option also accepts additional, optional arguments immediately following the video mode specification. The following additional, optional arguments are supported:

nocheck

If present, the normal error checking based on the monitor sense code is suspended. The video mode specified by the user is accepted regardless of whether it is appropriate for the currently attached monitor. This option is useful if a different monitor is to be connected to the XVR-50 or the Sun XVR-100 device. Use of this option implies noconfirm as well.

noconfirm

You could put the system into an unusable state using the -res option, which has no video output. To reduce the chance of this, the default behavior of SUNWpfb_config is to print a warning message and to ask the user whether to continue. The noconfirm option bypasses this confirmation. This option is useful when you are running SUNWpfb_config from a shell script.

now

If present, updates the video mode in the OWconfig file and immediately programs the XVR-50 or Sun XVR-100 device to display this video mode. This is useful for changing the video mode before starting the window system.

Do not use this suboption with SUNWpfb_config while the configured device is being used (for example, while running the window system) as unpredictable results can occur.

If you want to run SUNWpfb_config with the now suboption, first bring the window system down, and executed from the console command line. If you use the now option 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.

try

If present, programs the specified video mode on a trial basis. You are asked to confirm the video mode by entering a y within 10 seconds. You can terminate the trial before 10 seconds by entering any character but y or <RETURN>.

This sub-option should not be used with SUNWpfbconfig while the configured device is being used (for example, while running the window system) as unpredictable results may occur. To run SUNWpfbconfig with the try sub-option, the window system should be brought down first, and executed from the console command line.

-res \?

Print a list of defined video-mode names.

DEFAULTS

For a given invocation of SUNWpfb_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 a XVR-50 or Sun XVR-100 option has never been specified by SUNWpfb_config, a default value is used. The options and their corresponding defaults for a XVR-50 are as follows:

Option                  Default

-dev                    /dev/fb
-file                   machine
-res                    none
-fake8                  disable
-g                      disable

The options and their corresponding defaults for a Sun XVR-100 are as follows:

Option                  Default

-dev                    /dev/fb
-file                   machine
-res                    none
-fake8                  disable
-g                      disable
-depth                  8 (Solaris 8 and Solaris 9)
-doublewide             disable
-doublehigh             disable
-outputs                direct
-offset                 [0,0]

The default for the -res option none means that when the window system is run, the screen resolution will be the video mode that is currently programmed in the XVR-50 or Sun XVR-100 PROM.

This provides compatibility for users who are used to specifying the device resolution through the XVR-50 or the Sun XVR-100 PROM. On some devices (e.g. GX) this is the only way of specifying the video mode. This means that the PROM ultimately determines the default XVR-50 or Sun XVR-100 video mode.

Examples

Example 1 Switching the Monitor Type

The following example switches the monitor type to the resolution of 1280 × 1024 at 60 Hz:

example% fbconfig –res 1280x1024x60

Files

/dev/fbs/pfbn: Device special file for XVR-50 or Sun XVR-100 single screen
/dev/fbs/pfbna: Device special file for the Sun XVR-100 first video out
/dev/fbs/pfbnb: Device special file for the Sun XVR-100 second video out
/usr/lib/fbconfig/SUNWpfb_config: Device special file

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWpfbcf