dmx/man/Xdmx.man

2 .\" Copyright 2001-2004 Red Hat Inc., Durham, North Carolina.
20 .\" NON-INFRINGEMENT.  IN NO EVENT SHALL RED HAT AND/OR THEIR SUPPLIERS
27 Xdmx - Distributed Multi-head X server
30 [:display] [option ...]
33 is a proxy X server that uses one or more other X servers as its display
34 devices.  It provides multi-head X functionality for displays that might
37 functions as a front-end X server that acts as a proxy to a set of
38 back-end X servers.  All of the visible rendering is passed to the
39 back-end X servers.  Clients connect to the
41 front-end, and everything appears as it would in a regular multi-head
47 communicates to the back-end X servers using the standard X11 protocol,
56 .BI "\-display " display-name
57 This specifies the name(s) of the back-end X server display(s) to connect
59 one back-end display.  The first is used as screen 0, the second as screen 1,
61 .B $DISPLAY
62 environment variable is used as the single back-end X server display.
65 .BI "\-xinput " input-source
69 described below, except that core devices on backend servers cannot be
71 backend and console servers are supported as extension devices under
75 .BI "\-input " input-source
86 comma-separated list of driver names can be appended.
87 The following drivers have been implemented for Linux: usb-mou
88 (a USB mouse driver), usb-kbd (a USB keyboard driver), and usb-oth (a
89 USB non-keyboard, non-mouse driver).  Additional drivers may be
91 comma-separated list is provided.
94 .I display-name
95 If the display-name is a back-end server, then core input events are
97 opened on the specified display.
100 .I display-name
101 is followed by ",xi" then XInput extension devices on the display will
105 .I display-name
106 is followed by ",noxi" then XInput extension devices on the display will
113 .I display-name
115 .I display-name
116 refers to a display that is used as a backend display, then a console
117 window will be opened on that display
119 that display will be treated as a backend display.  Otherwise (or if
120 ",noconsole" is used), the display will be treated purely as a backend
121 or a console display, as described above.
124 .I display-name
125 is followed by ",windows", then outlines of the windows on the backend
127 ",nowindows" is used), the console window will not display the outlines
128 of backend windows.  (This option only applies to console input.)
131 .I display-name
132 is followed by ",xkb", then the next 1 to 3 comma-separated parameters
142 settings available via the -param command line switch.
149 back-end server (the one used for screen 0).  The console window shows
150 the layout of the back-end display(s) and pointer movements and key
157 .B Ctrl-Alt-q
162 .B Ctrl-Alt-g
167 .B Ctrl-Alt-f
168 will toggle fine-grain motion in console mode (a special cursor,
179 .BI "-nomulticursor"
181 overlapped back-end displays.  This option is available for testing and
185 .BI "-fontpath"
195 .BI "-configfile " filename
197 .B \-display
198 command-line option is used, then the configuration file will be
202 .BI "-config " name
210 .BI "-stat " "interval screens"
211 This option enables the display of performance statistics.  The interval
212 is in seconds.  The screens is a count of the number of back-end screens
214 display data for all screens.
219 (Sync/s), the average round-trip time (in microseconds) of the last 10
220 XSync() calls (avSync), the maximum round-trip time (in microseconds) of
234 .BI "-syncbatch " interval
244 .BI "-nooffscreenopt"
250 .BI "-nowindowopt"
254 .BI "-nosubdivprims"
258 .BI "-noxkb"
261 .B "-kb"
265 .BI "-depth " int
267 default visual from those available on the back-end X server, the first
271 .BI "-cc"
276 .BI "-norender"
280 .BI "-noglxproxy"
281 This option disables GLX proxy -- the build-in GLX extension
285 .BI "-noglxswapgroup"
290 .BI "-glxsyncswap"
293 glXSwapBuffers request, Xdmx relays that request to each back-end X
296 buffering can lead to the set of back-end X servers handling the swap
298 issued to each back-end X server after sending the swap buffers request.
300 swap buffers requests) and wait until the back-end X servers have
305 .BI "-glxfinishswap"
310 .BI "-glxfinishswap"
313 .BI "-glxsyncswap"
315 glFinish() request to each back-end X server after sending the swap
321 .BI "-ignorebadfontpaths"
322 This option ignores font paths that are not available on all back-end
328 .BI "-addremovescreens"
333 .BI "-noglxproxy"
335 .BI "-norender"
339 .BI "-param"
343 installation-dependent.  Please see
374 .B display
393 virtual-list ::= [ virtual-list ] | virtual
399 dw-list
402 dw-list ::= [ dw-list ] | dw
404 dw ::= display | wall | option
406 display ::=
407 .B display
413 [ dim ] [ dim ] name-list
418 name-list
423 name-list
428 param-list
431 param-list ::= [ param-list ] | name-list
434 name-list ::= [ name-list ] | name
436 name ::= string | double-quoted-string
444 integer ] [ signed-integer signed-integer ]
458 .B \-config
459 command line option.  The name of a display should be standard X display
470 is the dimension of each display in the wall (e.g., 1280x1024).
473 .B display
474 is the geometry of the screen window on the backend server.  The second
481 line can be used to specify any command-line options (e.g.,
483 (It cannot be used to specify the name of the front-end display.)  The
492     display d0:0 1280x1024 @0x0;
493     display d1:0 1280x1024 @1280x0;
497     display d0:0 1280x1024;
498     display d1:0 @1280x0;
502     display "d0:0";
503     display "d1:0" @1280x0;
524 front-end server will be propagated to each back-end server,which
525 requires that each back-end server have access to the exact same font
526 paths as the front-end server.  This can be most easily handled by
528 paths on each back-end server, and then setting the
531 -I "-fontpath"
536 Xdmx :1 -display d0:0 -fontpath /usr/fonts/75dpi/ -fontpath /usr/fonts/Type1/ +xinerama
541 server and all back-end server, which is d0 in this example.
544 .I "-fontpath"
548 Xdmx :1 -display d0:0 -display d1:0 -fontpath tcp/d0:7100 +xinerama
550 will initialize the front-end
552 server and each of the back-end servers to use the font server on d0.
554 Some fonts might not be supported by either the front-end or the
555 back-end servers.  For example, let's assume the front-end
557 server includes support Type1 fonts, but one of the back-end servers
566 server) is sent to the back-end server that cannot handle Type1 fonts.
567 That back-end server then rejects the font path and sends an error back
577 .I "-fontpath"
581 .I "-fontpath"
583 .SH "COMMAND-LINE EXAMPLES"
584 The back-end machines are d0 and d1, core input is from the pointer and
587 Xdmx :1 -display d0:0 -display d1:0 +xinerama
592 Xdmx :1 -display d0:0 -display d1:0 -input d1:0 +xinerama
596 display:
598 Xdmx :1 -display d0:0 -display d1:0 -input :0 +xinerama
603 Xdmx :1 -display d0:0 -display d1:0 -input local,usb-kbd,usb-mou +xinerama
608 local machine and the Ctrl-Alt-F* sequence will be available to change
610 machine).  Using Ctrl-Alt-Backspace on the blank VC will terminate the
615 Xdmx :1 -input :0 +xinerama -configfile filename -config example2
619 option -input :0 +xinerama;
623 Xdmx :1 -configfile filename -config example2
654 mouse, keyboard, or non-mouse-non-keyboard Linux device and use that
661 .I \-xkb
664 compiled to use the XKEYBOARD extension, then a keyboard on a backend or
670 and the host X server for the keyboard (i.e., the backend or console X
682 on the backend or console X servers prior to starting
686 .I \-xkbmap