X Window System protocols and architecture
Client–server model and network transparency
X uses a client–server model. An X server program runs on a computer with a graphical display and communicates with various client programs. The X server acts as a go-between for the user and the client programs, accepting requests on TCP port 6000 for graphical output (windows) from the client programs and displaying them to the user, and receiving user input (keyboard, mouse) and transmitting it to the client programs.
In X, the server runs on the user's computer, while the clients may run on different machines. This reverses the common configuration of client–server systems, where the client runs on the user's computer and the server runs on a remote computer. This reversal often confuses new X users. The X Window terminology takes the perspective of the program, rather than of the end-user or of the hardware: the remote programs connect to the X server display running on the local machine, and thus act as clients; the local X display accepts incoming traffic, and thus acts as a server.
The communication protocol between server and client runs network-transparently: the client and server may run on the same machine or on different ones, possibly with different architectures and operating systems. A client and server can communicate securely over the Internet by tunneling the connection over an encrypted connection.
- Do not add new functionality unless an implementor cannot complete a real application without it.
- It is as important to decide what a system is not as to decide what it is. Do not serve all the world's needs; rather, make the system extensible so that additional needs can be met in an upwardly compatible fashion.
- The only thing worse than generalizing from one example is generalizing from no examples at all.
- If a problem is not completely understood, it is probably best to provide no solution at all.
- If you can get 90 percent of the desired effect for 10 percent of the work, use the simpler solution. (See also Worse is better.)
- Isolate complexity as much as possible.
- Provide mechanism rather than policy. In particular, place user interface policy in the clients' hands.
The first principle was modified during the design of X11 to: Do not add new functionality unless you know of some real application that will require it.
X has largely kept to these principles since. The X.Org Foundation develops the reference implementation with a view to extension and improvement of the implementation, whilst keeping it almost entirely compatible with the original 1987 protocol.
Communication between server and clients is done by exchanging packets over a network channel. The client establishes the connection, sending the first packet. The server answers by sending back a packet stating the acceptance or refusal of the connection, or with a request for a further authentication. If the connection is accepted, the acceptance packet contains data for the client to use in the subsequent interaction with the server.
After connection is established, the client and the server exchange four different types of packets over the channel:
- Request: the client requests information from the server or requests it to perform an action.
- Reply: the server responds to a request. Not all requests generate replies.
- Event: the server sends an event to the client, e.g., keyboard or mouse input, or a window being moved, resized or exposed.
- Error: the server sends an error packet if a request is invalid. Since requests are queued, error packets generated by a request may not be sent immediately.
The X server provides a set of basic services. The client programs realize more complex functionalities by interacting with the server.
What other graphical user interfaces usually call a window is a top-level window in the X Window System. The term window is also used for windows that lie within another window, that is, the subwindows of a parent window. Graphical elements such as buttons, menus, icons, etc. are all realized using windows.
A window can only be created as a subwindow of a parent window. This causes the windows to be arranged hierarchically in a tree. The X server automatically creates the root of the tree, called the root window. The top-level windows are exactly the direct subwindows of the root window. Visibly, the root window is as large as the screen, and lies behind all other windows.
The X server stores all data about windows, fonts, etc. The client knows identifiers of these objects—integers it can use as names for them when interacting with the server. For example, if a client wishes a window to be created, it requests the server to create a window with a given identifier. The server creates a window and associates it with the identifier. The identifier can be later used by the client to request, for example, a string to be drawn in the window.
Identifiers are unique to the server, not only to the client; for example, no two windows have the same identifier, even if created by two different clients. A client can access any object given its identifier, even if another client created the object.
Attributes and properties
Every window has a predefined set of attributes and a set of properties, all stored in the X server and accessible to the clients via appropriate requests. Attributes are data about the window, such as its size, position, background color, etc. Properties are pieces of data that are attached to a window. Unlike attributes, properties have no meaning at the level of the X Window core protocol. A client can store arbitrary data in a property of a window.
A property is characterized by a name, a type, and a value. Properties resemble variables in imperative programming languages, in that the application can create a new property with a given name and of a given type and store a value in it. Properties are associated to windows: two properties with the same name can exist on two different windows while having different types and values.
Properties are mostly used for inter-client communication. For example, the property named
WM_NAME stores the name for the window; window managers typically read this property and display the name of the window at the top of it.
xprop program can display the properties of a window. In particular,
xprop -root shows the properties of the root window, which include the X resources (parameters of programs).
Events are packets sent by the server to the client to communicate that something has happened which may interest the client. A client can request the server to send an event to another client; this is used for communication between clients. For example, when a client requests the text that is currently selected, an event is sent to the client that is currently handling the window that holds the selection.
The content of a window may be "destroyed" in some conditions (for example, if the window is covered). Whenever an area of destroyed content is made visible, the server generates an
Expose event to notify the client that a part of the window has to be drawn.
Other events can serve to notify clients of keyboard or mouse input, of the creation of new windows, etc.
Some kinds of events are always sent to a client, but most kinds of event are sent only if the client previously stated an interest in them, because clients may only be interested in some kind of events. For example, a client may be interested in keyboard-related event but not in mouse-related events.
The way the X Window System handles colors can sometimes confuse users, and historically several different modes have been supported. Most modern applications use TrueColor (24-bit color, 8 bits for each of red, green and blue), but old or specialist applications may require a different color mode. Many commercial specialist applications use PseudoColor.
The X11 protocol actually uses a single 32-bit unsigned integer - called a pixelvalue - for representing a single color in most graphic operations. When transferring the intensity of primary colors, a 16 bit integer is used for each colour component. The following representations of colors exist; not all of them may be supported on a specific device.
- DirectColor: A pixel value is decomposed into separate red, green, and blue subfields. Each subfield indexes a separate colormap. Entries in all colormaps can be changed.
- TrueColor: Same as DirectColor, except that the colormap entries are predefined by the hardware and cannot be changed. Typically, each of the red, green, and blue colormaps provides a (near) linear ramp of intensity.
- GrayScale: A pixel value indexes a single colormap that contains monochrome intensities. Colormap entries can be changed.
- StaticGray: Same as GrayScale, except that the colormap entries are predefined by the hardware and cannot be changed.
- PseudoColor (Chunky): A pixel value indexes a single colormap that contains color intensities. Colormap entries can be changed.
- StaticColor: Same as PseudoColor, except that the colormap entries are predefined by the hardware and cannot be changed.
Xlib and other client libraries
Most client programs communicate with the server via the Xlib client library. Beside Xlib, the XCB library operates more closely to X protocol. In particular, most clients use libraries such as Xaw, Motif, GTK+, or Qt which in turn use Xlib for interacting with the server.
Inter-client communication 
The X Window core protocol provides mechanisms for communication between clients: window properties and events, in particular the client-to-client message events. However, it does not specify any protocol for such interactions. Instead, a separate set of inter-client communication conventions governs these protocols.
The Inter-Client Communication Conventions Manual specifies the protocol for the exchange of data via selections and the interaction of applications with the window manager. Some have considered this specification difficult and confusing; consistency of application look and feel and communication is typically addressed by programming to a given desktop environment.
The Inter-Client Exchange protocol (ICE) specifies a framework for building protocols for interaction between clients, so that programmers can build a specific protocol on top of it. In particular, the X Session Management protocol (XSMP) is a protocol based on ICE that governs the interaction between applications with the session manager, which is the program that takes care of storing the status of the desktop at the end of an interactive session and recovering it when another session with the same user is started again.
The freedesktop specifications include newer conventions, including the drag-and-drop convention Xdnd (used for transferring data by selecting it and dragging in another window) and the embedded application convention Xembed (which details how an application can run in a subwindow of another application).
Selections, cut buffers, and drag-and-drop
The mechanisms of selections, cut buffers, and drag-and-drop in the X Window System allow a user to transfer data from one window to another. Selections and cut buffer are used (typically) when a user selects text or some other data in a window and pastes in a different window. Drag-and-drop is used when a user selects something in a window, then clicks on the selection and drags it into another window.
Since two different applications may handle the two windows, data transfer requires different clients connected with the same X server to interact. The X Window core protocol includes some types of requests and events that are specific to selection exchange, but the transfer is mainly done using the general client-to-client event sending and window properties, which are not specific to selection transfer.
Users can transfer data of different types between clients: it is usually text, but can also be a pixmap, a number, a list of objects, etc.
Selections and drag-and-drop are active mechanisms: after the user selects data in a window, the client handling the window must actively support a protocol for transferring that data to the application requesting it. Cut buffers, by contrast, provide a passive mechanism: when the user selects some text, its content is transferred to a cut buffer, where it remains even if the application handling the window terminates and the window is destroyed.
A window manager is a program that controls the general appearance of windows and other graphical elements of the graphical user interface. Differences in the look of X Window System in different installations stem mainly from the use of different window managers or from different configurations of the window manager.
The window manager takes care of deciding the position of windows, placing the decorative border around them, handling icons, handling mouse clicks outside windows (on the “background”), handling certain keystrokes, etc.
From the point of view of the X server, the window manager operates as a client just like any other client. The initial position and the decorative borders around windows are handled by the window manager using the following requests:
- an application can request the server not to satisfy requests of mapping (showing) subwindows of a given window, and to be sent an event instead;
- an application can request changing the parent of a window.
The window manager uses the first request to intercept any request for mapping top-level windows (children of the root window). Whenever another application requests the mapping of a top-level window, the server does not do it but sends an event to the window manager instead. Most window managers reparent the window: they create a larger top-level window (called the frame window) and reparent the original window as a child of it. Graphically, this corresponds to placing the original window inside the frame window. The space of the frame window that is not taken by the original window is used for the decorative frame around the window (the “border” and the “title bar”).
The window manager manages mouse clicks in the frame window. This allows, for example, a user to move or resize the window by clicking and dragging on the border or on the title bar.
The window manager also handles icons and related visual elements of the graphical user interface. Icons do not exist at the level of the X Window core protocol. They are implemented by the window manager. For example, whenever a window has to be “iconified”, the FVWM window manager unmaps the window, and creates a window for the icon name and possibly another window for the icon image. The meaning and handling of icons is therefore completely decided by the window manager: some window managers such as wm2 do not implement icons at all.
Roughly, the state of a session is the “state of the desktop” at a given time: a set of windows with their current content. More precisely, it is the set of applications managing these windows and the information that allow these applications to restore the condition of their managed windows if required. A program known as the X session manager saves and restores the state of sessions.
Most recognizably, using a session manager permits a user to log out from an interactive session but to find exactly the same windows in the same state when logging in again. For this to work, the session manager program stores the names of the running applications at logout and starts them again at login. In order for the state of the applications to be restored as well (which is needed to restore the content of windows), the applications must be able to save their state of execution upon request from the session manager and load it back when they start again.
The X Window System includes a default session manager called
xsm. Developers have written other session managers for specific desktop systems: for example,
ksmserver is the default session manager of KDE.
X display manager
The program known as the X display manager shows the graphical login prompt in the X Window System. More generally, a display manager runs one or more X servers on the local computer and accepts incoming connections from X servers running on remote computers. The local servers are started by the display manager, which then connects to them to present the user the login screen. The remote servers are started independently from the display manager and connect to it. In this situation, the display manager works like a graphical telnet server: an X server can connect to the display manager, which starts a session; the programs of this session run on the same computer of the display manager but have input and output on the computer where the X server runs (which may be the computer in front of the user or a remote one).
The X Window System ships with XDM as the basic supplied display manager. Other display managers include GDM (GNOME), KDM (KDE), WDM (using the WINGs widget set used in Window Maker) and entrance (using the architecture used in Enlightenment v.17).
User interface elements
Early widget toolkits for X included Xaw (the Athena Widget Set, 1983), OLIT (OPEN LOOK Intrinsics Toolkit, 1988), XView (1988), Motif (1980s) and Tk. OLIT and XView function as the base toolkits for Sun's legacy OpenWindows desktop environment.
Motif provides the base toolkit for the Common Desktop Environment (CDE), the desktop environment used on commercial Unix systems such as Solaris, AIX and HP-UX. (Solaris 10 includes both CDE and GNOME, with the latter the preferred desktop environment as of 2010[update].)
Scheifler and Gettys designed the X server to be simple but extensible. As such, much functionality now resides in extensions to the protocol.
At the protocol level, every extension can be assigned new request/event/error packet types. Extension features are accessed by client applications through extension libraries. Adding extensions to current X server implementations is reportedly difficult due to a lack of modularity in the server design. It is a long term goal of the XCB project to automate generating both the client and server sides of extensions from XML protocol descriptions.
The following table provides a partial catalog of extensions that have been developed, sorted roughly by recency of introduction:
|Extension||Description and notes|
|Composite||Off-screen rendering of entire window hierarchies, allowing applications and composition managers to do effects anywhere along the way. Required for things like alpha transparency for windows and drop shadows.|
|Damage||Tracks modified regions of windows, and minimizes bandwidth use required to keep the display up to date.|
|XFixes||Several protocol changes.|
|Extended-Visual-Information (EVIE)||Allows client to determine information about core X visuals beyond what the core protocol provides.|
|Distributed Multihead (DMX)||Communicates with DMX X server.|
|X-Video Motion Compensation (XvMC)||Offloading video motion compensation to a GPU that supports it.|
|GLX||Support for rendering OpenGL within windows.|
|XRender||Hardware accelerated image compositing with alpha blending.|
|Resize and Rotate (RANDR)||Dynamically change the size, reflection, rotation and refresh rate of an X screen.|
|Xinerama||Splitting the desktop across multiple monitors.|
|Display Power Management Signaling (DPMS)||Allows controlling monitor power saving modes.|
|X keyboard extension||Enhanced keyboard layout handling.|
|DOUBLE-BUFFER||Gives flicker-free animation.|
|RECORD||Used in server testing|
|MIT-SHM||Use of shared memory to improve performance.|
|SYNC||Provides timers and synchronizes clients (e.g. running on different hosts and operating systems) from within the X server. Created because of errors introduced by the network.|
|XTEST||For generating fake input. Use i.e. the xte application from the XAutomation package.|
|XInputExtension||Support for input devices such as graphic tablets; implementable as libXi|
|BIG-REQUESTS||Enables requests exceeding 262140 bytes in length.|
|XC-MISC||Fixes resource ID range overrun|
|X video extension||Support for hardware video overlays and hardware-based video scaling on playback. Also called Xv (not to be confused with the xv program).|
|Shape||Support for non-rectangular and partially transparent (binary, no alpha opacity) windows.|
|MIT-SCREEN-SAVER||Launches a program when the X server turns on the built-in screen saver|
|SECURITY||Provides enhanced server security|
|X-Resource||Allows querying the X server about its resource usage|
|XFree86-DGA||Provides direct linear framebuffer access (direct graphics access). To be mostly removed in X.Org 7.6|
|XFree86-VidModeExtension||Dynamically configures modelines and gamma.|
|Extension||Description and notes|
|Low Bandwidth X (LBX)||Replaced by X tunneled over a secure shell connection, proved faster than LBX.|
|PEX||"PHIGS Extension to X"; support for PHIGS 3D scene graph API. GLX with OpenGL is frequently used instead.|
|XImage Extension||MIT-SHM is used instead.|
|XEvIE||X Event Interception Extension. Designed for users who need to intercept all keyboard and mouse events. Removed in X.Org 7.5.|
|XFree86-Misc||Superseded by input properties. Removed in X.Org 7.5.|
|DEC-XTRAP||Removed in X.Org 7.5.|
|Ken Sanders||X-Pert on the X-Protocol|
|TOG-CUP||Provides colormap utilization policy. Removed in X.Org 7.5.|
|MIT-SUNDRY-NONSTANDARD||Support for various backwards compatibility features for clients which used early implementations of X11. For compatibility with Pre-X11R4 clients. Disabled since 2006. Removed in X.Org 7.5.|
|XC-APPGROUP||Removed in X.Org 7.5.|
|XPRINT||Deprecated. Allows an application to render output to a printer just as it would to any other display device. Removed in May 2008.|
- Client–server model
- Hopkins, Don (uncredited) (May 1994). Garfinkel, Simson; Weise, Daniel; Strassmann, Steven, eds. The UNIX-Haters Handbook (PDF). San Mateo, CA, USA: IDG Books. p. 126 The X-Windows Disaster. ISBN 978-1-56884-203-5. OCLC 30681401. Retrieved July 11, 2011. "The ICCCM is unbelievably dense, it must be followed to the last letter, and it still doesn’t work. ICCCM compliance is one of the most complex ordeals of implementing X toolkits, window managers, and even simple applications. It’s so difficult, that many of the benefits just aren’t worth the hassle of compliance."
- Raymond, Eric S. (September 30, 2008). "The Unix Hater’s Handbook, Reconsidered". Armed and Dangerous. Retrieved July 11, 2011. "ICCCM is about as horrible as the (The Unix Hater’s Handbook) authors describe, but that’s hard to notice these days because modern toolkits and window managers do a pretty good job of hiding the ugliness from applications."
- Gettys, James; Karlton, Philip L.; McGregor, Scott (10 December 1990). "The X Window System, Version 11" (PDF). Digital Equipment Corporation and Silicon Graphics Computer Systems. p. 36. Retrieved July 11, 2011. "X11 does not permit the read back of all information that may have been stored in the server (for example, the X11 protocol does not permit querying the GC state). This makes modularity somewhat harder to accomplish."
- "X.org libXi Client library for XInput". Retrieved 2010-03-02. "libXi - library for the X Input Extension"
- "XC-MISC Extension". Retrieved 2010-08-02.
- "Security Extension Specification". Retrieved 2010-08-02.
- Disable XFree86-DGA requests except relative mouse motion, until Xinput 2 allows killing it all. X.Org Wiki - Releases/7.6
- 7.5 release announcement
- Commit removing XPrint
- The Linux Documentation Project. The X Window System Architecture: overview; May 23, 2001 [retrieved July 13, 2011].
- Mount Kisco, NY, USA: John F. Moore. The Architecture of X-Window; December 16, 2005 [retrieved July 13, 2011].
- TCP/IP Illustrated [PDF]. 1 ed. Vol. 1, TheProtocols. Boston, MA, USA: Addison-Wesley; [Retrieved July 13, 2011]. (Addison-Wesley professional computing series). ISBN 978-0-201-63346-7. OCLC 246049781. 30.5 X Window System. 30.5 X Window System.
- TCP/IP for MVS, VM, OS/2 and DOS: X Window System Guide [PDF]. Second ed. Research Triangle Park, NC, USA: IBM; 1994 [Retrieved July 13, 2011]. (IBM Redbooks). 1.2 X Concepts. X Concepts.
- X Window System User's Guide : for X11 release 5. Vol. 3. Sebastopol, CA, USA: O'Reilly & Assoc.; 1993 [Retrieved July 14, 2011]. (Definitive guides to the X Window System). LCC QA76.76.W56 Q47. ISBN 978-1-56592-014-9. OCLC 682229836.
- Robert W. Scheifler and James Gettys: X Window System: Core and extension protocols, X version 11, releases 6 and 6.1, Digital Press 1996, ISBN 978-1-55558-148-0
- An Introduction to X11 User Interfaces[dead link]
- Introduction to X Windows[sic]
- Open Source Desktop Technology Road Map (Jim Gettys, 09 Dec 2003)[dead link]
- X.Org Foundation (official home page)
- X.Org Foundation wiki
- X Window System Internals
- Kenton Lee's pages on X Window and Motif
- X11 Extension tutorial