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 editing the file. The GUI allows the user that is logged in on the graphics device or devices to configure which graphics displays the window 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 fbconfig 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:

See Also

SUNWgfb_config(1M), SUNWifb_config(1M), SUNWpfb_config(1M), SUNWzulu_config(1M), afbconfig(1M), ffbconfig(1M), m64config(1M), pgxconfig(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.