XMX(LOCAL)

NAME
xmx - an X protocol multiplexor

SYNOPSIS
xmx [:displaynum] [-option ...]

DESCRIPTION
Xmx is an X protocol multiplexor. It lets users at different locations share a single X Window System session in real time. Xmx is a standalone program that works with existing, unmodified X servers and X clients.

Xmx connects to X servers as a client, then accepts connections, like an X server, from X clients. Xmx presents a "virtual server" to each client, and a "virtual client" to each server it talks to.

[More explanation needed here]

DISPLAYS
Xmx always presents a single screen to clients, even when running on multi-screen machines. Explicitely specifying the screen number of a display causes xmx to use only that screen of that display.

Xmx extends the normal syntax for specifying X displays in two ways. It is not necessary to specify the display number in a display string, zero is assumed if only a hostname is given. Xmx will optionally take over a window if its X id is appended to the display string. So, for instance, the display blort:0.1.0x340000d tells xmx to connect to hostname blort, display 0, screen 1 and use the window whose id is 0x340000d as the virtual root window. This is useful for applications that would like xmx to manage one of their subwindows.

OPTIONS
Xmx accepts all standard X11 server options, plus a few of its own. Those options which actually do something are described below. Running xmx with the -help option lists all options, used and ignored.

:displaynum
    Specifies the display number for which to be an X server. This number need not correspond to a real display - in fact it must not if a real X server is running on the same machine.

-af filename
    Read command line arguments from filename.

-auth path
    Select authorization file.

-bs Disable any backing store support.

-cc #
    Sets the visual of root windows of color screens. (currently ignored)

-co filename
    Sets name of RGB color database.

-ctp
    Make the default telepointer constant, so that it does not assume the images or colors of cursors assigned to the windows it tracks over.

-dc Delay calculation of virtual configuration. Causes the server config mode to initially be ConfigDelay. Connections to servers are initiated, but no virtual root windows are created until an XMC client sets the config mode to ConfigAllow.

-debug levels
    Sets the debug message level. Possible levels are:
    1    trace incoming client X protocol
    2    trace outgoing virtual client X protocol
    3    trace incoming server X protocol
    4    trace outgoing virtual server X protocol
    a    trace access/authority operations
    A    trace server add operations
    b    trace buffer management operations
    c    trace chunk operations
    C    trace color operations
    d    trace protocol details
    e    print errors (default)
    E    trace exposure queue operations
    f    trace focus processing
    g    trace grab processing
    h    trace hash table operations
    i    trace image processing operations
    k    trace key and pointer mapping operations
    l    trace list operations
    m    trace pixel mapping
    n    trace networking operations
    p    trace all X protocol (same as 1234)
    P    painful tracing
    q    trace protocol to and from query server
    r    print 'soft' reply errors
    s    trace sequence number mapping operations
    S    trace selection processing
    t    trace request translation processing
    v    trace virtual configuration operations
    V    run internal verification checks
    w    trace byte swapping operations
    x    trace XMC protocol
    ?    print the list of debug levels

-display display...
    Equivalent to -floor, but implies -nodpy.

-dpi #
    Sets the resolution of the screen in dots per inch.

-floor disp...
    The following displays will provide input to shared X clients. See the discussion of displays, above.

-geometry geom
    Size and position of virtual root window. Xmx extends the standard X geometry syntax in several ways. A horizontal or vertical size may be expressed as a fraction of the screen size. For example, 1/1x1/2 is a window that covers the full width of the screen, but only half its height. If the 'x' is left out of the screen size, the value given is used for both width and height.

    The location of the window may be expressed as 'c' for centered. So the location +c+0 is centered horizontally at the top of the screen. If only one offset (positive, negative or 'c') is given, it is used to postion the window both horizontally and vertically.

    The default geometry is 23/40 (proportionally 1/3 of the screen size, no position).

-glob
    Do hostname wildcarding. Hostnames given on the command line that contain wildcard characters (*?[]) are considered to be patterns and are expanded to a list of all hostnames in the local machine's hosts database that match. The pattern matching rules are the same as for filename globbing in csh(1). This is useful for specifying a large number of machines with similar names (e.g. lab01, lab02, etc., would be "lab??").

-help
    Print message with these options.

-I  Ignore remaining command line arguments.

-install
    Bypass window manager and install colormaps. Only use this if there is no window manager or you know what you're doing.

-mdpynum #
    Display number on which to listen for XMC protocol.

-maxcols #
    Maximum number of colors to allocate in root colormap.

-nodpy
    Ignore DISPLAY environment variable.

-notp
    No default telepointer.

-noresize
    Don't allow resizing of virtual root windows.

-noxmc
    Don't listen for multiplexor control clients.

-owncmap
    Don't share default root colormaps.

-quiet
    Suppress information and warning messages.

-sto #
    Sets default server connection timeout in seconds.

-su Disables save under support.

-seat disp...
    Input events from the following displays are directed, via XMC events, to X multiplexor clients that want them. See the discussion of displays, above.

-t #
    Sets pointer acceleration threshold.

-to #
    Sets default client connection timeout in seconds.

-wm Forces default backing store to WhenMapped.

-view disp...
    Input events from the following displays are ignored. See the discussion of displays, above.

SEE ALSO
X(1), Xserver(1)

BUGS
Fewer than before.

VERSION
This page describes XMX Version 2.1 Alpha.

AUTHOR
John Bazik
jsb@cs.brown.edu