1xorg.conf(5)                  File Formats Manual                 xorg.conf(5)
2
3
4

NAME

6       xorg.conf, xorg.conf.d - configuration files for Xorg X server
7

INTRODUCTION

9       Xorg  supports several mechanisms for supplying/obtaining configuration
10       and run-time parameters: command line options,  environment  variables,
11       the  xorg.conf and xorg.conf.d configuration files, auto-detection, and
12       fallback defaults. When the same information is supplied in  more  than
13       one  way,  the highest precedence mechanism is used. The list of mecha‐
14       nisms is ordered from highest precedence to lowest. Note that  not  all
15       parameters  can be supplied via all methods. The available command line
16       options and environment variables (and some defaults) are described  in
17       the Xserver(1) and Xorg(1) manual pages. Most configuration file param‐
18       eters, with their defaults, are described below. Driver and module spe‐
19       cific  configuration parameters are described in the relevant driver or
20       module manual page.
21

DESCRIPTION

23       Xorg uses a configuration file called xorg.conf and files ending in the
24       suffix .conf from the directory xorg.conf.d for its initial setup.  The
25       xorg.conf configuration file is searched for in  the  following  places
26       when the server is started as a normal user:
27
28           /etc/X11/<cmdline>
29           /usr/etc/X11/<cmdline>
30           /etc/X11/$XORGCONFIG
31           /usr/etc/X11/$XORGCONFIG
32           /etc/X11/xorg.conf
33           /etc/xorg.conf
34           /usr/etc/X11/xorg.conf.<hostname>
35           /usr/etc/X11/xorg.conf
36           /usr/lib/X11/xorg.conf.<hostname>
37           /usr/lib/X11/xorg.conf
38
39       where  <cmdline> is a relative path (with no “..” components) specified
40       with the -config command line option, $XORGCONFIG is the relative  path
41       (with  no  “..” components) specified by that environment variable, and
42       <hostname> is the machine's hostname as reported by gethostname(3).
43
44       When the Xorg server is started by the “root”  user,  the  config  file
45       search locations are as follows:
46
47           <cmdline>
48           /etc/X11/<cmdline>
49           /usr/etc/X11/<cmdline>
50           $XORGCONFIG
51           /etc/X11/$XORGCONFIG
52           /usr/etc/X11/$XORGCONFIG
53           /etc/X11/xorg.conf
54           /etc/xorg.conf
55           /usr/etc/X11/xorg.conf.<hostname>
56           /usr/etc/X11/xorg.conf
57           /usr/lib/X11/xorg.conf.<hostname>
58           /usr/lib/X11/xorg.conf
59
60       where  <cmdline>  is  the  path specified with the -config command line
61       option (which may be absolute or relative),  $XORGCONFIG  is  the  path
62       specified by that environment variable (absolute or relative), $HOME is
63       the path specified by  that  environment  variable  (usually  the  home
64       directory),  and  <hostname>  is  the machine's hostname as reported by
65       gethostname(3).
66
67       Additional configuration files are searched for in the following direc‐
68       tories when the server is started as a normal user:
69
70           /etc/X11/<cmdline>
71           /etc/X11/<cmdline>
72           /etc/X11/xorg.conf.d
73           /etc/X11/xorg.conf.d
74
75       where  <cmdline> is a relative path (with no “..” components) specified
76       with the -configdir command line option.
77
78       When the Xorg server is started by the “root” user, the  config  direc‐
79       tory search locations are as follows:
80
81           <cmdline>
82           /etc/X11/<cmdline>
83           /etc/X11/<cmdline>
84           /etc/X11/xorg.conf.d
85           /etc/X11/xorg.conf.d
86
87       where  <cmdline> is the path specified with the -configdir command line
88       option (which may be absolute or relative).
89
90       Finally, configuration files will also be searched for in  a  directory
91