NNAAMMEE

ffbconfig - configure the FFB Graphics Accelerator

SSYYNNOOPPSSIISS

//uussrr//ssbbiinn//ffffbbccoonnfifigg [ --ddeevv device-filename ]

          [ --rreess video-mode [nnooww || ttrryy] [nnooccoonnfifirrmm || nnoocchheecckk] ]
          [ --fifillee mmaacchhiinnee || ssyysstteemm ]
          [ --ddeeflfliinneeaarr ttrruuee || ffaallssee ]
          [ --ddeeffoovveerrllaayy ttrruuee || ffaallssee ]
          [ --lliinneeaarroorrddeerr fifirrsstt || llaasstt ]
          [ --mmaaxxwwiiddss n ] [ --pprroopptt ] [ --pprrccoonnff ] [ --ddeeffaauullttss ]

//uussrr//ssbbiinn//ffffbbccoonnfifigg [ --pprroopptt ] [ --pprrccoonnff ]

//uussrr//ssbbiinn//ffffbbccoonnfifigg [ --hheellpp ] [ --rreess ? ]

DDEESSCCRRIIPPTTIIOONN

ffffbbccoonnfifigg configures the FFB Graphics Accelerator and some of the X11 window system defaults for FFB.

The first form of ffffbbccoonnfifigg shown in the synopsis above stores the specified options in the OWconfig file. These options will be used to initialize the FFB 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 second and third forms which invoke only the --pprrccoonnff, --pprroopptt, --hheellpp, and --rreess ? options do not update the OWconfig file. Additionally, for the third form all other options are ignored.

Options may be specified for only one FFB device at a time. Specifying options for multiple FFB devices requires multiple invocations of ffffbbccoonnfifigg.

Only FFB-specific options can be specified through ffffbbccoonnfifigg. The normal window system options for specifying default depth, default visual class and so forth are still specified as device modifiers on the openwin command line (see XXssuunn(1)).

The user can also specify the OWconfig file that is to be updated. By default, the machine-specific file in the /etc/openwin directory tree is updated. The -file option can be used to specify an alternate file to use. 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. Consequently, the ffffbbccoonnfifigg program, which is owned by the root user, always runs with setuid root permission.

OOPPTTIIOONNSS

--ddeevv device-filename

Specifies the FFB special file. The default is //ddeevv//ffbbss//ffffbb00 .

--fifillee mmaacchhiinnee || ssyysstteemm

Specifies which OWconfig file to update. If machine, the machine-specific OWconfig file in the /etc/openwin directory tree is used. If system, the global OWconfig file in the /usr/openwin directory tree is used. If the file does not exist, it is created.

--rreess video-mode [[ nnooww || ttrryy [[ nnooccoonnfifirrmm || nnoocchheecckk ]] ]]

Specifies the video mode used to drive the monitor connected to the specified FFB device.

The format of these built-in video modes is:

wwiiddtthhxhheeiigghhttxrraattee

where wwiiddtthh is the screen width in pixels, hheeiigghhtt is the screen height in pixels, and rraattee is the vertical frequency of the screen refresh. The ss suffix of 960x680x112s and 960x680x108s means that these are stereo video modes. The ii suffix of 640x480x60i and 768x575x50i designates interlaced video timing. If absent, non-interlaced timing will be used. As a convenience, -res also accepts formats with @ in front of the refresh rate instead of x. For example: 1280x1024@76. The list of valid video-modes is show below. This list can also be obtained by running ffffbbccoonnfifigg with the --rreess ? option (the third form shown in the command synopsis above).