Graphics Administration Guide (April 2009)

When the unit name is omitted, the correct units will be determined from the value and the
expectations of the appropriate range of the value. It is recommended that the units always be
specified when using frequency option values to avoid any errors in determining the value.
ServerLayout section
The ServerLayout section is used to identify which Screen sections are to be used in a multi-headed
configuration, the relative layout of those screens, and which InputDevice sections are to be used.
Each ServerLayout section has an Identifier, a list of Screen section identifiers, and a list of
InputDevice section identifiers. Options may also be included in the ServerLayout section. A
ServerLayout section may be made active by referencing (via its Identifier) on the command line
that starts X. In the absence of this, the first one found in the file will be chosen by default, as
there may be multiple ServerLayout sections in the config file. The format of the ServerLayout
section is as follows:
Section ServerLayout
Identifier ServerLayoutName
Screen [ScreenNumber] ScreenID [Position] [Xcoor] [Ycoor]
. . .
InputDevice InputDeviceID InputDeviceOption
. . .
[Option ]
. . .
EndSection
Keywords, options and values enclosed in [ ] are optional.
A number specifying the preferred screen number for that screen may optionally follow each
Screen. When no screen number is specified, it is numbered according to the order in which it
is listed. Next comes the ScreenID, a required field that must be enclosed in double quotes. The
ScreenID must match an Identifier in a Screen section. The remaining information on the line is
optional. Next comes the physical position of the screen, either in absolute terms or relative to
another screen (or screens). Finally the XY coordinates of the screen may be specified.
The position keywords are:
Absolute
RightOf
LeftOf
Above
Below
Relative
The preferred method of specifying the layout is to explicitly specify the screen's location in
absolute terms or relative to another screen.
The examples are based on the examples listed in the DESIGN document from XFree86.
In the absolute case, the upper left corner's coordinates are given after the Absolute keyword. If
the coordinates are omitted, a value of (0,0) is assumed. An example of absolute positioning
follows:
Section "ServerLayout"
Identifier "Main Layout"
Screen 0 "Screen 0" Absolute
Screen 1 "Screen 1" Absolute 1024 0
Screen 2 "Screen 2" Absolute 2048 0
...
EndSection
When the Relative keyword is used, the coordinates of the new screen's origin relative to the
reference screen follow the reference screen name. The following example shows how to use
some of the relative positioning options:
Section "ServerLayout"
Identifier "Main Layout"
Screen 0 "Screen 0"
12 configuring X Server on HP-UX (OEM graphics cards)