Name
getconfig - get configuration information for the XFree86® server
Synopsis
getconfig [option ...]
Description
getconfig is a programmatic interface that is used by the XFree86 server to get configuration information about video hardware. This mechanism allows XFree86 to operate without an XF86Config file.
This implementation of getconfig is written in perl and it processes a prioritized and ordered list of rules supplied either internally or from meta-configuration files.
The rules themselves are supplied to getconfig in the form of perl expressions which are then written to standard output XF86Config-style.
Configuration data should be specified in priority order. The actual format of the meta-configuration files can be found in the getconfig(5) manual page.
Options
- -I search-path
-
The search path should be specified as a comma-separated list of directories. Each directory specified is searched sequentially for files with a .cfg suffix at which point each and every file is opened and then checked for a valid signature string. Rules are then read from the files with a valid signature string and are appended to the list of rules to evaluate.
If no search path is specified, only the internally supplied configuration rules will be used.
- -D
- this enables debugging output.
- -V
- this prints out the version information and exit.
- -X XFree86-version
- this specifies the XFree86 version in numeric (integer) form.
- -b subsys-id
- this specifies the PCI subsystem ID of the video device.
- -c class
- this specifies the PCI class of the video device.
- -d device-id
- this specifies the PCI device ID of the video device.
- -r revision
- this specifies the PCI revision of the video device.
- -s subsysvendor-id
- this specifies the PCI subsystem vendor ID of the video device.
- -v vendor-id
- this specifies the PCI vendor ID of the video device.
Files
.cfg files located in the search path. The search path typically specified by the XFree86 server is:
/etc/X11
/usr/X11R6/etc/X11
<modulepath>
/usr/X11R6/lib/X11/getconfig
where <modulepath> is the XFree86 server's module search path
See Also
getconfig(5), XFree86(1), XF86Config(5).
Authors
The XFree86 automatic configuration support and the getconfig interface was written by David H. Dawes, with the support of X-Oz Technologies.