fbconfig(1M)						  System Administration Commands					      fbconfig(1M)

NAME

       fbconfig - Frame Buffer configuration utility

SYNOPSIS

       fbconfig [-list | -gui | -help]

       fbconfig [-dev device_filename] [-prconf] [-propt] [-res ?]

       fbconfig [-dev device_filename] [-res resolution-specification] device_specific_options

DESCRIPTION

       fbconfig is the generic command line interface to query and configure frame buffer attributes.

       The following form of fbconfig is the interface for the device independent operations performed by fbconfig:

       fbconfig [-list | -gui | -help]

       The following form of fbconfig is the interface for configuring a frame buffer:

       fbconfig [-dev device_filename] [-prconf] [-propt] [-res]

       If  the -dev option is omitted, the default frame buffer (/dev/fb or /dev/fb0) is assumed. In the absence of specific options, the response
       will depend upon the device specific configuration program and how it responds to no options

OPTIONS

       The following options are supported:

       -dev device_filename

	   Specify the FFB special file. The default is /dev/fbs/ffb0.

       -gui

	   Invoke the Graphical User Interface (GUI). The GUI is available if the SUNWdcm package is installed. All other arguments are ignored.

	   The GUI can configure devices (as an alternative to the fbconfig command line) and can update the Xservers file without directly  edit-
	   ing the file. The GUI allows the user that is logged in on the graphics device or devices to configure which graphics displays the win-
	   dow system should use, their screen layout (where they appear on the user's desktop), and screen properties (X attributes).

	   In addition, the GUI allows advanced users to create a new video format (resolution) that some graphics devices can select from  fbcon-
	   fig command line or from the device-dependent portion of the GUI. The GUI's online help explains all options and features.

       -help

	   Print the fbconfig command usage summary. This is the default option.

       -list

	   Print the list of installed frame buffers and associated device specific configuration routines.

	    Device Filename		 Specific Config Program
	    ---------------		 -----------------------
	     /dev/fbs/ffb0		  SUNWffb_config
	     /dev/fbs/ffb1		  SUNWffb_config
	     /dev/fbs/m640		  SUNWm64_config
	     /dev/fbs/cgsix0		  not configurable

       -prconf

	   Print the current hardware configuration.

       -propt

	   Print the current software configuration.

       -res ?

	   Print the current hardware resolution.

OPERANDS

       The following operands are supported:

       device_specific_options device_specific_options are specified in the format shown by the -help output, or the corresponding device-specific
			       man page.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWfbc			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       SUNWgfb_config(1M), SUNWifb_config(1M),	SUNWpfb_config(1M),  SUNWzulu_config(1M),  afbconfig(1M),  ffbconfig(1M),  m64config(1M),  pgxcon-
       fig(1M), attributes(5)

LIMITATIONS

       Because of limitations in the m64 kernel driver and related software, fbconfig (with the -prconf option) is unable to distinguish between a
       current depth of 24 or 8+24. The -propt option returns the depth specified in the OWconfig file, which will be in effect following the next
       restart	of  the  window system. The xwininfo utility, usually shipped in the package containing frame buffer software (such as SUNWxwplt),
       reports current depth of a specified window.

SunOS 5.10							   15 June 2004 						      fbconfig(1M)