SUNWjfb_config(1M) System Administration Commands SUNWjfb_config(1M)NAMESUNWjfb_config - fbconfig module for configuring the Sun XVR-600 and
XVR-1200 Graphics Devices
SYNOPSIS
fbconfig [-dev device-filename]
[-res video-mode [now | try] [noconfirm | nocheck]]
[-file machine | system] [-deflinear true | false]
[-defoverlay true | false]
[-linearorder first | last]
[-outputs swapped | direct]
[-slave disable | multiview | stereo | bnc]
[-accum enable | disable] [-g gamma-correction-value]
[-gfile gamma-correction-file]
[-fake8 enable | disable]
[-doublewide enable | disable]
[-doublehigh enable | disable]
[-multisample available | disable | forceon]
[-samples 1 | 2 | 4 | 8 | 16 | adaptive]
[-defdepth 8 | 24] [-offset xval yval] [-propt]
[-prconf] [-defaults]
fbconfig [-propt] [-prconf]
fbconfig [-help] [-res ?]
DESCRIPTIONSUNWjfb_config configures the Sun XVR-600 and XVR-1200 Graphics Accel‐
erator and some of the X11 window system defaults for the Sun XVR-600
and XVR-1200.
You can specify options for only one device at a time. If you want to
specify options for multiple devices, you must invoke the SUNWjfb_con‐
fig utility multiple times.
You can use the SUNWjfb_config utility to specify Sun XVR-600 or
XVR-1200 specific options. Use the normal window system options to
specify default depth, 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, SUN‐
Wjfb_config updates the machine-specific file in the /etc/openwin. You
can specify an alternate file by using the -file option. 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. Con‐
sequently, the SUNWjfb_config program, which is owned by the root user,
always runs with setuid root permission.
The first form of SUNWjfb_config shown in the SYNOPSIS section stores
the specified options in the OWconfig file. These options initialize
the Sun XVR-600 and XVR-1200 device the next time the window system is
run on that device. Updating options in the OWconfig file provides per‐
sistence 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. Addition‐
ally, for the third form all other options are ignored.
OPTIONS
The following options are supported:
-accum enable | disable
Enable or disable frame buffer memory. If enabled, frame buffer
memory is allocated for the accelerated accumulation buffer for
windows. If disabled, software accumulation buffering for windows
is used. Accelerated accumulation buffers for pBuffers are always
available as memory allows.
-dev device-filename
Specify the SunSun XVR-600 or XVR-1200 special file. The default is
/dev/fbs/jfb0.
-defaults
Reset all option values except -dev to their default values.
This option sets the resolution override to none which implies the
last video mode setting is preserved. If no monitor is attached,
the video mode is set to 1152x900x66.
-deflinear true | false
Both the Sun XVR-600 and XVR-1200 possess two types of visuals:
linear and nonlinear. Linear visuals are gamma corrected and non‐
linear visuals are not. There are two visuals that have both linear
and nonlinear versions: 24-bit TrueColor and 8-bit StaticGray.
If the value of this option is true, the default visual is set to
the linear visual that satisfies other specified default visual
selection options (specifically, the Xsun defdepth and defclass
options; see Xsun(1)). If false, or if there is no linear visual
that satisfies the other default visual selection options, the non-
linear visual specified by these other options is chosen as the
default visual. This option cannot be used when the -defoverlay
option is present, because the Sun XVR-600 and XVR-1200 do not pos‐
sess a linear overlay visual.
-defoverlay true | false
Both the Sun XVR-600 and XVR-1200 provide an 8-bit PseudoColor vis‐
ual 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. If false, the nonoverlay visual that satisfies the
other default visual selection options, such as defdepth and def‐
class, is chosen as the default visual. See Xsun(1). Whenever
-defoverlay true is used, the default depth and class chosen on the
openwin command line must be 8-bit PseudoColor. If not, a warning
message is printed and the -defoverlay option is treated as false.
This option cannot be used when the -deflinear option is present,
because the Sun XVR-600 and XVR-1200 do not possess a linear over‐
lay visual.
-defdepth 8 | 24
Set the depth (bits per pixel) on the device. Possible values for
the -defdepth 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 prece‐
dence over what is set using fbconfig. The default is determined by
the X Server smf(5) default depth property. You can query this
property with the following command:
% /usr/sbin/svccfg -s svc:/application/x11/x11-server listprop \
'options/default_depth'
-doublehigh enable | disable
Configure the two outputs of the Sun XVR-1200 into one vertical
virtual display. The default is disable.
This option is not applicable to the Sun XVR-600 device.
-doublewide enable | disable
Configure the two outputs of the Sun XVR-1200 into one horizontal
virtual display. The default is disable.
This option is not applicable to the Sun XVR-600 device.
-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. 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
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
affects all of the windows displayed by linear visuals.
-gfile gamma-correction file
Load the gamma correction table from the file specified by gamma-
correction file. You should format this file to provide the gamma
correction values for R, G, and B channels on each line. Specify
each value in hexadecimal format and separate it from another value
by at least 1 space. The gamma-correction file file should provide
1024 such triplets.
You can load the gamma correction table with this option can while
the window system is running. The new gamma correction affects all
the window being displayed using the linear visuals. When gamma
correction is done using a user specified table, the gamma correc‐
tion 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
Print a list of the SUNWjfb_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 enable. The
default is disable.
-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. Negative is left (overlaps with the left stream). For -dou‐
blehigh, use the yval to position the bottom stream. Negative is up
(overlaps with top stream). The default is [0, 0].
-outputs swapped | direct
If either -doublewide or -doublehigh are enabled, reverse the posi‐
tion of the two outputs relative to each other. The default is
direct.
-propt
Print the current values of all Sun XVR-600 and XVR-1200 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 SUNWjfb_config com‐
pletes.
This is a typical display:
# fbconfig -dev jfb2 -propt
--- OpenWindows Configuration for /dev/fbs/jfb2 ---
OWconfig: machine
Video Mode: 1280x1024x60
Accum: Enabled (allocate an accumulation buffer if possible)
Multisample Information:
Multisample Mode: Disabled (multisample visuals
will not be available)
Samples Per Pixel: N/A (multisampling disabled)
Screen Information:
DoubleWide: Disabled
DoubleHigh: Disabled
Output Configuration: Direct
Offset/Overlap: [0, 0]
Visual Information:
Default Visual: Non-Linear Normal Visual
Visual Ordering: Linear Visuals are last
Gamma Correction Value: 2.22
Gamma Correction Table: Available
Fake8 rendering: disabled
Default Visual Depth (defdepth): 8
-prconf
Print the Sun XVR-1200 hardware configuration. This is a typical
display:
# fbconfig -dev jfb2 -prconf
--- Hardware Configuration for /dev/fbs/jfb2 ---
Type: XVR-1200
Sun Serial Number: 3753101000022
Hardware Revision: -01 rev01
Manufacture Date: Thu Aug 8 12:54:16 2002
PROM Information: @(#)jfb.fth 1.8 02/10/18 SMI
Monitor/Resolution Information:
EDID Data: Available - EDID version 1 revision 3
Monitor type: Sun P/N 365-1415 S/N 0216ME0353
Current resolution setting: 1280x1024x60 (custom)
Monitor possible resolutions: 1024x768x60, 1024x768x70,
1024x768x75, 1152x900x66, 1280x1024x60, 1280x1024x75,
1280x1024x76, 640x480x60, 800x600x75
Framelock Configuration:
Slave Mode: Disabled
Memory Information:
Total Video Memory: 134217728
Video Memory Used: 15728640
Total Texture Memory: 268435456
Texture Memory Used: 0
Total Display List Memory: 33554432
-res video-mode [ now |try [ noconfirm | nocheck ]]
Specify the video mode of the monitor connected to the specified
Sun XVR-600 or XVR-1200 device.
The -res option requires you to specify the video-mode. You can
specify video-mode in the format of widthxheightxrate or as a sym‐
bolic 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 vertical frequency of the
screen refresh.
You can use the s suffix to specify stero video modes. The s
suffix of 960x680x112s and 960x680x108s means that these are
stereo video modes.
The -res option also accepts formats with @ (at sign) in front
of the refresh rate instead of x, (280x1024@76). Some video-
modes, supported by Sun XVR-600 and XVR-1200, might not be sup‐
ported by the monitor.
The list of video-modes supported by the Sun XVR-600 and
XVR-1200 device and the monitor can be obtained by running SUN‐
Wjfb_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 sys‐
tem is run the screen resolution will be 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 1280x1024x76
stereo 960x680x112s
ntsc 640x480x60i
pal 768x575x50i
none Programmed video mode
The -res option accepts additional, optional arguments immediately
following the video mode specification. The following additional,
optional arguments are supported:
now
If present, updates the video mode be updated in the OWconfig
file. Programs the Sun XVR-600 or XVR-1200 device to display
the video mode. This is useful for changing the video mode
before starting the window system.
Do not use this suboption with SUNWjfb_config while the config‐
ured device is being used, for example, while running the win‐
dow system. Unpredictable results can occur.
If you want to run SUNWjfb_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 imme‐
diately. 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.
noconfirm
Using the -res option, the user could potentially put the sys‐
tem into an unusable state, a state where there is no video
output. This can happen if there is ambiguity in the monitor
sense codes for the particular code read. To reduce the chance
of this, the default behavior of SUNWjfb_config is to print a
warning message to this effect and to prompt the user to find
out if it is okay to continue. The -noconfirm option instructs
SUNWjfb_config to bypass this confirmation and to program the
requested video mode anyway. This option is useful when SUN‐
Wjfb_config is run from a shell script.
nocheck
If present, the normal error checking based on the monitor
sense code is suspended. The video mode specified 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-600 or XVR-1200 device. Use
of this option implies noconfirm.
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.
Terminating the trial by entering a character other than y or
RETURN restores the previous video mode. SUNWjfb_config does
not change the video mode in the OWconfig file. Other specified
options 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.
If you want to run SUNWjfb_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 imme‐
diately. 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 strongly discouraged.
-samples 1 | | 4 | 8 | 16 | adaptive
Request the number of samples to compute per display pixel. The
requested number of samples per pixel will be used if -multisample
is not disabled and resources exist for the request. If set to
adaptive, variable multisampling is possible, whith the minimum
samples per pixel set to 2. 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 -multisam‐
ple enable. The default is 16.
-slave disable | multiview | stereo | bnc
Enable or disable a specific port. Specify multiview for the DB9
connector, stereo for the mini-DIN connector, or bnc for the bnc
connector. Specify disable to disable a specific port. If set, the
option is an exclusive slave instance in the Framelock Configura‐
tion Setup. The default is disable.
multiview and bnc are only applicable to the Sun XVR-1200 device.
DEFAULTS
For a given invocation of SUNWjfb_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 an option has never been specified by
way of SUNWjfb_config, a default value is used. The options and their
corresponding defaults are as follows:
Option Default
-dev /dev/fbs/jfb0
-file machine
-res none
-deflinear false
-defoverlay false
-linearorder last
-slave disable
-accum enable
-g 2.22
-samples 16
-multisample disable
-doublewide disable
-doublehigh disable
-outputs direct
-offset [0,0]
The default for the -res option of none means that when the window sys‐
tem is run the screen resolution will be the video mode that is cur‐
rently programmed in the device.
This provides compatibility for users who are used to specifying the
device resolution through the PROM. This means that the PROM ultimately
determines the default video mode.
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 jfb0 -res 1280x1024x76
FILES
/dev/fbs/jfbn
Device special file for the XVR-600 or XVR-1200 high performance
single screen
/dev/fbs/jfbna
Device special file for the XVR-1200 first video out
/dev/fbs/jfbnb
Device special file for the XVR-1200 second video out
/usr/lib/jfb.ucode
jfb microcode file
/usr/sbin/jfbdaemon
jfb microcode loader file
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWjfbcf │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOfbconfig(1M), svccfg(1M), mmap(2), attributes(5), smf(5), fbio(7I),
jfb(7D)
The Xsun(1) man page, which is not part of the SunOS man page collec‐
tion.
SunOS 5.10 19 Jun 2008 SUNWjfb_config(1M)