SUNWpfb_config(1M)
NAME
SUNWpfb_config - fbconfig module for configuring Sun XVR-100
Graphics Accelerator
SYNOPSIS
/usr/lib/fbconfig/SUNWpfb_config [-dev device-filename] [
-res video-mode
[now | try]
[noconfirm | nocheck] ] [-file | machine | system] [-fake8
| enable | disable] [-doublewide | enable | disable] [-
doublehigh | enable | disable] [-outputs | swapped |
direct] [-depth | 8 | 24] [-offset xval yval] [-defaults]
/usr/lib/fbconfig/SUNWpfb_config [-propt] [-prconf]
/usr/lib/fbconfig/SUNWpfb_config [-help] [ -res \?]
DESCRIPTION
SUNWpfb_config is the Sun XVR-100 device dependent layer for
fbconfig(1M). It configures the Sun XVR-100 Graphics
Accelerator and some of the X11 window system defaults for
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 first form of SUNWpfb_config shown in the SYNOPSIS sec-
tion sets options for the Sun XVR-100. It stores the speci-
fied options in the OWconfig file. These options initialize
the Sun XVR-100 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 Sun XVR-100 device is
immediately programmed if you specify the -res now.
The second form, which invokes the only the -prconf and
-propt options, queries the Sun XVR-100 for status.
The third form, which invokes the -help, and -res and \?
options, provides instruction on using SUNWpfb_config. Addi-
tionally, for the third form all other options are ignored.
You can only specify options for only one Sun XVR-100 device
at a time. If you want to specify options for multiple Sun
XVR-100 devices, you must requires multiple invocations of
SUNWpfb_config.
You can only use SUNWpfb_config to specify 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 pre-
cedence over what is set using fbconfig. The default
is 8.
-dev device-filename
Specify 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. The default is disable.
-doublewide enable | disable
Configure the two outputs of the Sun XVR-100 into one
horizontal virtual display. The default is disable.
-fake8 enable | disable
Enable or disable simple 8 bit X windows to be ren-
dered without a hardware colormap to reduce colormap
flashing. You might notice performance reductions. The
default is disable.
-file machine | system
Specify which OWconfig file to update. It you specify
machine, SUNWpfb_config updates the machine-specific
OWconfig file in the /etc/openwin directory tree. If
It you specify system, SUNWpfb_config updates the glo-
bal OWconfig file in the /usr/openwin directory tree.
If either file does not exist, it is created.
-help Print a list of the SUNWpfb_config command line
options, along with a brief explanation of each.
-offset xval yval
Adjust 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. Nega-
tive 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].
-outputs swapped | direct
Reverse or not reverse the positions of the -double-
wide or -doublehigh outputs relative to each other.
The default is direct.
-propt
Print the current values of all 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:
--- OpenWindows Configuration for /dev/fbs/pfb0 ---
OWconfig: machine
Video Mode: NONE
Depth: not set
Screen Information:
Doublewide: Disable
Doublehigh: Disable
Output Configuration: Direct
-prconf
Print the 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 0
Monitor/Resolution Information:
EDID Data: Not Available
Current resolution setting: 1280x1024x75
Depth Information:
Possible depths: 8, 24
Current depth: 8
-res video-mode [ now | try [ noconfirm | nocheck ]]
Specify the video mode that drives the monitor con-
nected to the specified 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.
widthxheightxrate
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 the vert-
ical frequency of the screen refresh. An example video
mode specified in this format is 1280x1024x76.
The -res option also accepts formats with @ preceding
the refresh rate instead of x, (1280x1024@76).
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. The meaning of the symbolic name none is
that when the window system is run the screen resolu-
tion is the video mode that is currently programmed in
the device.
The following symbolic names and their corresponding
video modes are supported:
svga 1024x768x60
1152 1152x900x76
1280 1280x1024x75
none Programmed video mode
Some video-modes, supported by Sun XVR-100, might not be
supported by the monitor. Use the -res \? option to obtain
the list of video-modes supported by the Sun XVR-100 device
and the monitor.
The -res option also accepts additional, optional arguments
immediately following the video mode specification. The fol-
lowing additional, optional arguments are supported:
nocheck
If present, the normal error checking based on the
monitor sense code is suspended. The video mode speci-
fied 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 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 Sun XVR-100 device
to display this video mode. This is useful for chang-
ing 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. Unpredictable results
can occur.
If you want to run SUNWpfb_config with the now subop-
tion, first bring the window system down. If you use
the now 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 sys-
tem 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>. If you want to run SUNWpfb_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 won't
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.
-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 correspond-
ing OWconfig option is not updated; it retains its previous
value.
When the window system is run, if an Sun XVR-100 option has
never been specified by SUNWpfb_config, a default value is
used. The options and their corresponding defaults are as
follows:
Option Default
-dev /dev/fb
-file machine
-res none
-fake8 disable
-depth 8
-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 Sun XVR-100 PROM.
This provides compatibility for users who are used to speci-
fying the device resolution through 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 deter-
mines the default Sun XVR-100 video mode.
EXAMPLES
Example 1: Switching the Monitor Type
The following example switches the monitor type to the reso-
lution of 1280 1024 at 76 Hz:
example% fbconfig -res 1280x1024x76
FILES
/dev/fbs/pfbn
Device special file for 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 attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWpfbcf |
|_____________________________|_____________________________|
SEE ALSO
fbconfig(1M), attributes(5), pfb(7D)
XSun(1), dtlogin(1)
Man(1) output converted with
man2html