SUNWpfb_config(1M)														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 ?]

       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 section sets options for the Sun XVR-100. It stores the  specified  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 immedi-
       ately 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. Additionally, 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.

       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 cur-
	   rent 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.

       -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 rendered without a hardware colormap to reduce colormap flashing. You might notice per-
	   formance 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.

       -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 secondary stream. 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. The default is [0, 0].

       -outputs swapped | direct

	   Reverse or not reverse the positions of the -doublewide 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 connected 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  widthx-
	   heightxrate 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 vertical 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
	       resolution 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 following addi-
	   tional, 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 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 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. Unpredictable results can occur.

			   If you want to run SUNWpfb_config with the now suboption, 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 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.

       -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 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 cur-
       rently programmed in the Sun XVR-100 PROM.

       This provides compatibility for users who are used to specifying 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 determines the default 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 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

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWpfbcf 		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       fbconfig(1M), attributes(5), pfb(7D)

       XSun(1), dtlogin(1)

								    8 Apr 2004							SUNWpfb_config(1M)