SUNWnfb_config(1M) System Administration Commands SUNWnfb_config(1M)NAMESUNWnfb_config - fbconfig module for configuring XVR-300 Graphics
Accelerator
SYNOPSIS
fbconfig [-dev device-filename] [ -res video-mode [now | try] [nocon‐
firm | nocheck] ] [ -file machine | system] [-fake8 enable | disable]
[-doublewide enable | disable] [-doublehigh enable | disable] [-clone
enable | disable] [-outputs swapped | direct] [-depth 8 | 24] [ -off‐
set xval yval] [-defaults]
fbconfig [-propt] [-prconf]
fbconfig [-help] [ -res ?]
DESCRIPTIONSUNWnfb_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. Speci‐
fying options for multiple XVR-300 devices requires multiple invoca‐
tions 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) ref‐
erence 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/open‐
win 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 spec‐
ifier is: widthxheightxrate. width is the screen width in pix‐
els, 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_con‐
fig 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 speci‐
fication. 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 sub‐
option, first bring the window system down. If the now sub‐
option 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 confirma‐
tion. 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 sub‐
option 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 ter‐
minate 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 iden‐
tically. 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 hard‐
ware colormap to reduce colormap flashing. Some performance reduc‐
tions may be observed. Default is disable.
-depth 8 | 24
Sets the default depth for the window system to start with. Possi‐
ble values are 8 or 24. Log out of the current window system ses‐
sion 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 speci‐
fied. Currently only implemented in -doublewide and -doublehigh
modes. For -doublewide, the xval is used to position the right‐
most 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 dis‐
play:
--- 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 exam‐
ple, 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 │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOfbconfig(1M), attributes(5), nfb(7D)
See the dtlogin(1) man page in the CDE man page collection. Also useful
is the XSun(1) man page in the OpenWindows man page collection.
SunOS 5.10 27 Jun 2006 SUNWnfb_config(1M)