Skip to content

X Window System Protocol

X Consortium Standard

Robert W. Scheifler

X Consortium, Inc.

X Version 11, Release 7.7

Version 1.0

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of the Open Group shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization from the Open Group.

X Window System is a trademark of The Open Group.


Table of Contents

Acknowledgements
1. Protocol Formats
Request Format
Reply Format
Error Format
Event Format
2. Syntactic Conventions
3. Common Types
4. Errors
5. Keyboards
6. Pointers
7. Predefined Atoms
8. Connection Setup
Connection Initiation
Server Response
Server Information
Screen Information
Visual Information
9. Requests
CreateWindow
ChangeWindowAttributes
GetWindowAttributes
DestroyWindow
DestroySubwindows
ChangeSaveSet
ReparentWindow
MapWindow
MapSubwindows
UnmapWindow
UnmapSubwindows
ConfigureWindow
CirculateWindow
GetGeometry
QueryTree
InternAtom
GetAtomName
ChangeProperty
DeleteProperty
GetProperty
RotateProperties
ListProperties
SetSelectionOwner
GetSelectionOwner
ConvertSelection
SendEvent
GrabPointer
UngrabPointer
GrabButton
UngrabButton
ChangeActivePointerGrab
GrabKeyboard
UngrabKeyboard
GrabKey
UngrabKey
AllowEvents
GrabServer
UngrabServer
QueryPointer
GetMotionEvents
TranslateCoordinates
WarpPointer
SetInputFocus
GetInputFocus
QueryKeymap
OpenFont
CloseFont
QueryFont
QueryTextExtents
ListFonts
ListFontsWithInfo
SetFontPath
GetFontPath
CreatePixmap
FreePixmap
CreateGC
ChangeGC
CopyGC
SetDashes
SetClipRectangles
FreeGC
ClearArea
CopyArea
CopyPlane
PolyPoint
PolyLine
PolySegment
PolyRectangle
PolyArc
FillPoly
PolyFillRectangle
PolyFillArc
PutImage
GetImage
PolyText8
PolyText16
ImageText8
ImageText16
CreateColormap
FreeColormap
CopyColormapAndFree
InstallColormap
UninstallColormap
ListInstalledColormaps
AllocColor
AllocNamedColor
AllocColorCells
AllocColorPlanes
FreeColors
StoreColors
StoreNamedColor
QueryColors
LookupColor
CreateCursor
CreateGlyphCursor
FreeCursor
RecolorCursor
QueryBestSize
QueryExtension
ListExtensions
SetModifierMapping
GetModifierMapping
ChangeKeyboardMapping
GetKeyboardMapping
ChangeKeyboardControl
GetKeyboardControl
Bell
SetPointerMapping
GetPointerMapping
ChangePointerControl
GetPointerControl
SetScreenSaver
GetScreenSaver
ForceScreenSaver
ChangeHosts
ListHosts
SetAccessControl
SetCloseDownMode
KillClient
NoOperation
10. Connection Close
11. Events
Input Device events
Pointer Window events
Input Focus events
KeymapNotify
Expose
GraphicsExposure
NoExposure
VisibilityNotify
CreateNotify
DestroyNotify
UnmapNotify
MapNotify
MapRequest
ReparentNotify
ConfigureNotify
GravityNotify
ResizeRequest
ConfigureRequest
CirculateNotify
CirculateRequest
PropertyNotify
SelectionClear
SelectionRequest
SelectionNotify
ColormapNotify
MappingNotify
ClientMessage
12. Flow Control and Concurrency
A. KEYSYM Encoding
Special KEYSYMs
Latin-1 KEYSYMs
Unicode KEYSYMs
Function KEYSYMs
Vendor KEYSYMs
Legacy KEYSYMs
B. Protocol Encoding
Syntactic Conventions
Common Types
Errors
Keyboards
Pointers
Predefined Atoms
Connection Setup
Requests
Events
Glossary
Index