SUNWnfb_config(1M) (man pages section 1M: System Administration Commands)

man pages section 1M: System Administration Commands

SUNWnfb_config(1M)

Name

SUNWnfb_config– fbconfig module for configuring XVR-300 Graphics Accelerator

Synopsis

fbconfig [-dev device-filename] 
     [-res video-mode [now | try] [noconfirm | nocheck]] 
     [-file machine | system] [-fake8 enable | disable] 
     [-doublewide enable | disable] 
     [-doublehigh enable | disable] 
     [-clone enable | disable] [-outputs swapped | direct] 
     [-depth 8 | 24] [-offset xval yval] [-defaults]

fbconfig [-propt] [-prconf]

fbconfig [-help] [-res ?]

Description

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

The first form of SUNWnfb_config shown in the SYNOPSIS section sets options for the XVR-300. This form stores the specified options in the OWconfig file. These options will be used to initialize the XVR-300 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. For -res now, the XVR-300 device will be immediately programmed.

The second form, which invokes the -prconf and -propt options, queries the XVR-300 for status.

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

Options may be specified for only one XVR-300 device at a time. Specifying options for multiple XVR-300 devices requires multiple invocations of SUNWnfb_config.

Only XVR-300-specific options can be specified through SUNWnfb_config. The normal window system options for specifying default depth, default visual class and so forth can still be specified as device modifiers on the command line when the X Server is started. See the dtlogin(1) reference to Xservers File.

The user can also specify the OWconfig file that is to be updated. By default, the machine-specific file in the /etc/openwin directory tree is updated. The -file option can be used to specify an alternate file to use. For example, the system-global OWconfig file in the /usr/openwin directory tree can be updated instead.

Options

-dev device-filename

Specifies the XVR-300 special file. The default is /dev/fb.

-file machine | system

Specifies which OWconfig file to update. If machine, the machine-specific OWconfig file in the /etc/openwin directory tree is used. If system, the global OWconfig file in the /usr/openwin directory tree is used. If the file does not exist, it is created.

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

Specifies the video mode used to drive the monitor connected to the specified XVR-300 device. Video modes are built-in.

video-mode

Specifies resolution and timing information for the display (for example, 1280x1024x76). The format of the video-mode specifier 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. As a convenience, -res also accepts formats with @ preceding the refresh rate instead of x. For example, 1280x1024@76.

Symbolic names. For convenience, some video modes have symbolic names defined for them. Instead of the form widthxheightxrate, one of these names may be supplied as the argument to -res. The meaning of the symbolic name none is that when the window system is run, the screen resolution will be the video mode that is currently programmed in the device.

Some video-modes supported by XVR-300 may not be supported by the monitor. The list of video-modes supported by the XVR-300 device and the monitor can be obtained by running SUNWnfb_config with the -res ? option (the third form shown in the command SYNOPSIS section).

-res option arguments. The -res option also accepts additional, optional arguments immediately following the video mode specification. Any or all of these may be present.

now

If present, not only will the video mode be updated in the OWconfig file, but the XVR-300 device will be immediately programmed to display this video mode. (This is useful for changing the video mode before starting the window system).

It is inadvisable to use this suboption with SUNWnfb_config while the configured device is being used (for example, while running the window system) because unpredictable results may occur. To run SUNWnfb_config with the now suboption, first bring the window system down. If the now suboption is used within a window system session, the video mode will be changed immediately, but the width and height of the affected screen won't change until the window system is exited and reentered again. Consequently, this usage is discouraged.

noconfirm

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

nocheck

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

try

If present, the specified video mode will be programmed on a trial basis. The user will be asked to confirm the video mode by typing 'y' within 10 seconds. Or the user may terminate the trial before 10 seconds are up by typing any character. Any character other than 'y' or carriage return is considered a no and the previous video mode will be restored and SUNWnfb_config will not change the video mode in the OWconfig file (other options specified will 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 (see the warning note on the now suboption).

-doublewide enable | disable

This option allows you to configure the two outputs of the Sun XVR-300 into one horizontal virtual display. Both video outputs will be set to the same resolution. Default is disable.

-doublehigh enable | disable

This option allows you to configure the two outputs of the Sun XVR-300 into one vertical virtual display. Both video outputs will be set to the same resolution. Default is disable.

-clone enable | disable

If this option is set to enable, the two outputs will display identically. Default is disable.

-outputs swapped | direct

If either doublewide or doublehigh is enabled, this option allows you to reverse the positions of the two outputs relative to each other. Default is direct.

-fake8 enable | disable

If enabled, simple 8 bit X windows will be rendered without a hardware colormap to reduce colormap flashing. Some performance reductions may be observed. Default is disable.

-depth 8 | 24

Sets the default depth for the window system to start with. Possible values are 8 or 24. Log out of the current window system session and log back in for the change to take effect. Any defdepth setting in the Xserver command line takes precedence over what is set using fbconfig. Default is 24. This option is only supported on Solaris 9. For Solaris 10 and above, use /usr/sbin/svccfg to configure depth.

-offset xval yval

Adjusts the position of the specified stream by the value specified. Currently only implemented in -doublewide and -doublehigh modes. For -doublewide, the xval is used to position the rightmost stream. Negative is left (overlaps with the left stream). For -doublehigh, the yval is used to position the bottom stream. Negative is up (overlaps with top stream). Positive values are treated as 0. Default is [0, 0]

-defaults

Resets all option values to their default values.

-propt

Prints the current values of all XVR-300 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 SUNWnfb_config completes. This is a typical display:

--- Graphics Configuration for /dev/fbs/nfb0 ---

OWconfig: machine
Video Mode: NONE

Screen Information:
        Doublewide: Disable
        Doublehigh: Disable
        Clone: Disable
        Offset/Overlap: [0, 0]
        Output Configuration: Direct
        Fake8 Rendering: Disable

-prconf

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

--- Hardware Configuration for /dev/fbs/nfb0 ---

Type: XVR-300
ASIC: version 0x5b64  REV : version 0x3800080
PROM: version 1.6

Monitor/Resolution Information:
Monitor 1:
       Monitor Manufacturer: SUN
       Product code: 1383
       Serial #: 18499659
       Manufacture date: 1999, week 36
       Monitor dimensions: 39x29 cm
       Monitor preferred resolution: SUNW_STD_1280x1024x76
       Separate sync supported: yes
       Composite sync supported: yes
       EDID:  Version 1, Revision 1
       Monitor Supported resolutions from EDID: SUNW_STD_1280x1024x76,
        SUNW_STD_1152x900x76, 1600x1200x75, SUNW_STD_1280x1024x76,
        SUNW_STD_1152x900x76, VESA_STD_1280x1024x75,
        SUNW_STD_1280x1024x67, SUNW_STD_1152x900x66,
        VESA_STD_1024x768x75, SUNW_STD_1600x1200x75, 960x720x112,
        VESA_STD_720x400x70, VESA_STD_720x400x88, VESA_STD_640x480x60,
        VESA_STD_640x480x67, VESA_STD_640x480x72, VESA_STD_640x480x75,
        VESA_STD_800x600x56, VESA_STD_800x600x60, VESA_STD_800x600x72,
        VESA_STD_800x600x75, VESA_STD_832x624x75, VESA_STD_1024x768x60,
        VESA_STD_1024x768x70, VESA_STD_1024x768x75,
        VESA_STD_1280x1024x75, APPLE_1152x870x75
       Current resolution setting: 1280x1024x76
Monitor 2:
       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
       Monitor Supported resolutions from EDID: 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_640x480x72,
        VESA_STD_640x480x75, VESA_STD_800x600x56, VESA_STD_800x600x60,
        VESA_STD_800x600x72, VESA_STD_800x600x75, VESA_STD_832x624x75,
        VESA_STD_1024x768x60, VESA_STD_1024x768x70,
        VESA_STD_1024x768x75, VESA_STD_1280x1024x75, APPLE_1152x870x75
       Current resolution setting: 1152x900x66

-help

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

-res ?

Prints list of defined video-mode names.

DEFAULTS

For a given invocation of a SUNWnfb_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 an XVR-300 option has never been specified via SUNWnfb_config, a default value is used. The option defaults are as follows:

Option	Default
–dev	/dev/fb
–file	machine
–res	none
–fake8	disable
–doublewide	disable
–doublehigh	disable
–clone	disable
–outputs	direct
–offset	[0,0]

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 XVR-300 PROM.

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

Examples

Example 1 Switching the monitor type

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

example% fbconfig -res 1280x1024x76

Files

/dev/fbs/nfbn: Device special file for XVR-300 single screen
/dev/fbs/nfbna: Device special file for the XVR-300 first video out
/dev/fbs/nfbnb: Device special file for the XVR-300 second video out
/usr/lib/fbconfig/SUNWnfb_config: Device dependent configuration module

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWnfbcf
Interface Stability	Evolving