aboutsummaryrefslogtreecommitdiff
path: root/X11/Xproto.h
diff options
context:
space:
mode:
Diffstat (limited to 'X11/Xproto.h')
-rw-r--r--X11/Xproto.h17
1 files changed, 15 insertions, 2 deletions
diff --git a/X11/Xproto.h b/X11/Xproto.h
index 76e2c9972..6cdea89cd 100644
--- a/X11/Xproto.h
+++ b/X11/Xproto.h
@@ -259,10 +259,13 @@ restoring the definitions in X.h. */
typedef CARD16 KeyButMask;
/*****************
- connection setup structure. This is followed by
- numRoots xWindowRoot structs.
+ Connection setup structures. See Chapter 8: Connection Setup
+ of the X Window System Protocol specification for details.
*****************/
+/* Client initiates handshake with this data, followed by the strings
+ * for the auth protocol & data.
+ */
typedef struct {
CARD8 byteOrder;
BYTE pad;
@@ -272,6 +275,16 @@ typedef struct {
CARD16 pad2 B16;
} xConnClientPrefix;
+/* Server response to xConnClientPrefix.
+ *
+ * If success == Success, this is followed by xConnSetup and
+ * numRoots xWindowRoot structs.
+ *
+ * If success == Failure, this is followed by a reason string.
+ *
+ * The protocol also defines a case of success == Authenticate, but
+ * that doesn't seem to have ever been implemented by the X Consortium.
+ */
typedef struct {
CARD8 success;
BYTE lengthReason; /*num bytes in string following if failure */