Table of Contents


xf86cfg - Graphical configuration tool for XFree86 4.0


xf86cfg [-xf86config XF86Config] [-modulepath moduledir] [-fontpath fontsdir] [-toolkitoption ...]


Xf86cfg is a tool to configure XFree86 4.0, and can be used to either write the initial configuration file or make customizations to the current configuration.

When the DISPLAY environment variable is not set, xf86cfg will run the command XFree86 -configure to allow the xserver detect the hardware in the computer, and write an initial XF86Config file in the user's home directory. Then, it will start XFree86 and allow customizations.
If the DISPLAY environment variable is set, xf86cfg will read the default XF86Config, that may not be the same being used by the current server, and allow customizations.

To use an alternative location for modules or fonts the respective search paths may be specified.

Unless there is an Apply button in the current xf86cfg dialog, the changes made will take place the next time XFree86 is started.

Xf86cfg allows addition and configuration of new devices, such as video cards, monitors, keyboards and mouses.

Screen layout configuration for xinerama or traditional multi-head is also available.

Modelines can be configured or optimized.

AccessX basic configurations can be made in the xf86cfg's accessx section.


Specifies an alternate XF86Config file for configuration.
Specifies where xf86cfg, and the server it may start, should look for XFree86 modules.
Specifies the complete path, not including the binary name, of the XFree86 binary.
Specifies the path to the fonts that should be used by the server started by xf86cfg.
Specifies the path to the rgb.txt file that should be used by the server started by xf86cfg, if any.
If xf86cfg was compiled with support to ncurses, this option makes xf86cfg enters a text mode interface.
When built with support for loading modules, this options changes xf86cfg behaviour, so that it will not load any modules, and thus start quickier.


Default host and display number
Directory where XFree86 was installed, defaults to /usr/X11R6.
Name of a resource file that overrides the global

resources stored in the RESOURCE_MANAGER property


Server configuration file
Server configuration file
Server configuration file
Server configuration file
Server configuration file
Specifies xf86cfg resources

Keyboard specific configuration

See Also

XFree86(1) XF86Config(5)


Copyright 2000, Conectiva Linux S.A.
Copyright 2000, The XFree86 Project


Paulo CÚsar Pereira de Andrade <>

The XFree86 Project



Table of Contents