From 5cfbe97cd797d8f78ece208bb5114704b83d8aab Mon Sep 17 00:00:00 2001 From: marha Date: Fri, 13 Jan 2012 16:54:57 +0100 Subject: libxtrans libXdmcp libxcb mesa xserver git update 13 jan 2012 --- libXdmcp/doc/xdmcp.xml | 570 +++++++++++++++++++++++++------------------------ 1 file changed, 286 insertions(+), 284 deletions(-) (limited to 'libXdmcp') diff --git a/libXdmcp/doc/xdmcp.xml b/libXdmcp/doc/xdmcp.xml index 817838e58..0f0ab3f2b 100644 --- a/libXdmcp/doc/xdmcp.xml +++ b/libXdmcp/doc/xdmcp.xml @@ -265,35 +265,36 @@ restriction will not substantially hamper the efficiency of any implementation. Also, no padding of any sort will occur within the packets. - - - - - + + + + + + - + Type Name Length (Bytes) Description - + CARD8 1 A single byte unsigned integer - + CARD16 2 Two byte unsigned integer - + CARD32 4 Four byte unsigned integer - + ARRAY8 n+2 @@ -302,7 +303,7 @@ a collection of CARD8. The value of the CARD16 field (n) specifies the number of CARD8 values to follow - + ARRAY16 2*m+1 @@ -310,7 +311,7 @@ This is a CARD8 (m) which specifies the number of CARD16 values to follow - + ARRAY32 4*l+1 @@ -318,7 +319,7 @@ This is a CARD8 (l) which specifies the number of CARD32 values to follow - + ARRAYofARRAY8 ? @@ -340,35 +341,36 @@ number of ARRAY8 values to follow. All XDMCP packets have the following information: - - - - - + + + + + + - + Length (Bytes) Field Type Description - + 2 CARD16 version number - + 2 CARD16 opcode packet header - + 2 CARD16 n = length of remaining data in bytes - + n ??? packet-specific data @@ -480,49 +482,49 @@ header in the order described without padding, and the length field is computed accordingly. - + - - - - - - - - - - + + + + + + + + + + - + Query - + BroadcastQuery - + IndirectQuery - + Display -> Manager - + Additional Fields: - + Authentication Names: ARRAYofARRAY8 - + @@ -533,12 +535,12 @@ manager will choose one of these and return it in the - + - Semantics + Semantics - + @@ -588,7 +590,7 @@ Each packet type has slightly different semantics: - + @@ -632,13 +634,13 @@ is not forwarded. - + Valid Responses: - + @@ -646,18 +648,18 @@ is not forwarded. Unwilling - + Problems/Solutions: - + Problem: - + @@ -666,7 +668,7 @@ is not forwarded. Indication: - + @@ -680,13 +682,13 @@ was sent, else failure to receive Willing. - + Solution: - + @@ -695,14 +697,14 @@ was sent, else failure to receive Repeatedly send the packet while waiting for user to choose a manager. - + Timeout/Retransmission policy: - + @@ -714,26 +716,26 @@ should reset the timeout when user-input is detected. In this way, the display will wakeup when touched by the user. - + ForwardQuery - + Primary Manager -> Secondary Manager Additional Fields: - + Client Address: ARRAY8 - + @@ -741,14 +743,14 @@ display will wakeup when touched by the user. Specifies the network address of the client display. - + Client Port: ARRAY8 - + @@ -756,14 +758,14 @@ Specifies the network address of the client display. Specifies an identification of the client task on the client display. - + Authentication Names: ARRAYofARRAY8 - + @@ -774,13 +776,13 @@ in the packet. - + Semantics: - + @@ -812,27 +814,27 @@ packet. - + Valid Responses: - + Willing - + Problems/Solutions: - + @@ -840,13 +842,13 @@ Identical to BroadcastQuery - + Timeout/Retransmission policy: - + @@ -855,13 +857,13 @@ retransmitted. - + Willing - + @@ -873,7 +875,7 @@ Additional Fields: - + @@ -881,7 +883,7 @@ Additional Fields: - + @@ -909,7 +911,7 @@ of authentication. - + @@ -917,7 +919,7 @@ of authentication. - + @@ -927,7 +929,7 @@ The protocol specifies no interpretation of the data in this field. - + @@ -935,7 +937,7 @@ The protocol specifies no interpretation of the data in this field. - + @@ -947,14 +949,14 @@ protocol specifies no interpretation of the data in this field. - + Semantics: - + @@ -972,14 +974,14 @@ connections already). - + Problems/Solutions: - + @@ -987,7 +989,7 @@ Problem: - + @@ -1002,7 +1004,7 @@ Indication: - + @@ -1017,7 +1019,7 @@ was sent, else failure to receive - + @@ -1026,7 +1028,7 @@ Solution: - + @@ -1038,14 +1040,14 @@ The display should continue to send the query until a response is received. - + Timeout/Retransmission policy: - + @@ -1054,13 +1056,13 @@ never be retransmitted. - + Unwilling - + @@ -1072,7 +1074,7 @@ Additional Fields: - + @@ -1084,14 +1086,14 @@ for the refusal of service. - + Semantics: - + @@ -1109,14 +1111,14 @@ particular displays or that handle a limited number of displays at once. - + Problems/Solutions: - + @@ -1124,7 +1126,7 @@ Problem: - + @@ -1139,7 +1141,7 @@ Indication: - + @@ -1150,7 +1152,7 @@ Display fails to receive - + @@ -1159,7 +1161,7 @@ Solution: - + @@ -1171,14 +1173,14 @@ messages until a response is received. - + Timeout/Retransmission policy: - + @@ -1186,13 +1188,13 @@ Like all packets sent from the manager to the display, this packet should never be retransmitted. - + Request - + @@ -1204,7 +1206,7 @@ Additional Fields: - + @@ -1212,7 +1214,7 @@ Additional Fields: - + @@ -1223,7 +1225,7 @@ This value will be zero for most autonomous displays. - + @@ -1231,7 +1233,7 @@ This value will be zero for most autonomous displays. - + @@ -1242,7 +1244,7 @@ corresponds to an X-protocol host family type. - + @@ -1250,7 +1252,7 @@ corresponds to an X-protocol host family type. - + @@ -1260,7 +1262,7 @@ this array indicates the network address of the display device. - + @@ -1273,7 +1275,7 @@ this array indicates the network address of the display device. - + @@ -1285,7 +1287,7 @@ and use to authenticate itself. - + @@ -1293,7 +1295,7 @@ and use to authenticate itself. - + @@ -1304,7 +1306,7 @@ authorization. - + @@ -1312,7 +1314,7 @@ authorization. - + @@ -1323,14 +1325,14 @@ Manufacturer Display ID Format. - + Semantics: - + @@ -1348,14 +1350,14 @@ packet. - + Valid Responses: - + @@ -1364,14 +1366,14 @@ Valid Responses: - + Problems/Solutions: - + @@ -1379,7 +1381,7 @@ Problem: - + @@ -1388,7 +1390,7 @@ Request not received by manager. - + @@ -1397,7 +1399,7 @@ Indication: - + @@ -1407,7 +1409,7 @@ Display timeout waiting for response. - + @@ -1416,7 +1418,7 @@ Solution: - + @@ -1429,7 +1431,7 @@ message. - + @@ -1438,7 +1440,7 @@ Problem: - + @@ -1448,7 +1450,7 @@ Message received out of order by manager. - + @@ -1457,7 +1459,7 @@ Indication: - + @@ -1467,7 +1469,7 @@ None. - + @@ -1476,7 +1478,7 @@ Solution: - + @@ -1496,14 +1498,14 @@ will be discarded by the display. - + Timeout/Retransmission policy: - + @@ -1512,13 +1514,13 @@ After no more than 126 seconds, give up and report an error to the user. - + Accept - + @@ -1530,7 +1532,7 @@ Additional Fields: - + @@ -1538,7 +1540,7 @@ Additional Fields: - + @@ -1547,7 +1549,7 @@ Identifies the session that can be started by the manager. - + @@ -1560,7 +1562,7 @@ Identifies the session that can be started by the manager. - + @@ -1571,7 +1573,7 @@ should terminate the protocol at this point and display an error to the user. - + @@ -1584,7 +1586,7 @@ should terminate the protocol at this point and display an error to the user. - + @@ -1599,14 +1601,14 @@ packet is received. - + Semantics: - + @@ -1634,14 +1636,14 @@ message. - + Problems/Solutions: - + @@ -1649,7 +1651,7 @@ Problem: - + @@ -1661,7 +1663,7 @@ not received by display. - + @@ -1670,7 +1672,7 @@ Indication: - + @@ -1681,7 +1683,7 @@ Display timeout waiting for response to - + @@ -1690,7 +1692,7 @@ Solution: - + @@ -1702,7 +1704,7 @@ message. - + @@ -1710,7 +1712,7 @@ Problem: - + @@ -1719,7 +1721,7 @@ Message received out of order by display. - + @@ -1728,7 +1730,7 @@ Indication: - + @@ -1742,7 +1744,7 @@ has been sent. - + @@ -1751,7 +1753,7 @@ Solution: - + @@ -1765,14 +1767,14 @@ message. - + Timeout/Retransmission policy: - + @@ -1781,13 +1783,13 @@ never be retransmitted. - + Decline - + @@ -1799,7 +1801,7 @@ Additional Fields: - + @@ -1807,7 +1809,7 @@ Additional Fields: - + @@ -1817,7 +1819,7 @@ service. - + @@ -1832,7 +1834,7 @@ ARRAY8 - + @@ -1843,14 +1845,14 @@ should terminate the protocol at this point and display an error to the user. - + Semantics: - + @@ -1866,14 +1868,14 @@ to a previous query. - + Problems/Solutions: - + @@ -1882,14 +1884,14 @@ Same as for - + Timeout/Retransmission policy: - + @@ -1898,13 +1900,13 @@ be retransmitted. - + Manage - + @@ -1916,7 +1918,7 @@ Additional Fields: - + @@ -1924,7 +1926,7 @@ Additional Fields: - + @@ -1935,7 +1937,7 @@ packet. - + @@ -1943,7 +1945,7 @@ packet. - + @@ -1954,7 +1956,7 @@ packet. - + @@ -1962,7 +1964,7 @@ packet. - + @@ -1974,14 +1976,14 @@ which discusses the format of this field. - + Semantics: - + @@ -2006,14 +2008,14 @@ packet). - + Valid Responses: - + @@ -2023,14 +2025,14 @@ X connection with correct auth info, - + Problems/Solutions: - + @@ -2038,7 +2040,7 @@ Problem: - + @@ -2048,7 +2050,7 @@ not received by manager. - + @@ -2057,7 +2059,7 @@ Indication: - + @@ -2067,7 +2069,7 @@ Display timeout waiting for response. - + @@ -2076,7 +2078,7 @@ Solution: - + @@ -2089,7 +2091,7 @@ message. - + @@ -2097,7 +2099,7 @@ Problem: - + @@ -2107,7 +2109,7 @@ received out of order by manager. - + @@ -2116,7 +2118,7 @@ Indication: - + @@ -2126,7 +2128,7 @@ Session already in progress with matching Session ID. - + @@ -2135,7 +2137,7 @@ Solution: - + @@ -2146,7 +2148,7 @@ packet ignored. - + @@ -2155,7 +2157,7 @@ Indication: - + @@ -2165,7 +2167,7 @@ Session ID does not match next Session ID. - + @@ -2174,7 +2176,7 @@ Solution: - + @@ -2186,7 +2188,7 @@ message is sent. - + @@ -2194,7 +2196,7 @@ Problem: - + @@ -2203,7 +2205,7 @@ Display cannot be opened on selected stream. - + @@ -2212,7 +2214,7 @@ Indication: - + @@ -2222,7 +2224,7 @@ Display connection setup fails. - + @@ -2231,7 +2233,7 @@ Solution: - + @@ -2242,7 +2244,7 @@ message is sent including a human readable reason. - + @@ -2250,7 +2252,7 @@ Problem: - + @@ -2260,7 +2262,7 @@ because of a timeout occuring in the display. - + @@ -2269,7 +2271,7 @@ Indication: - + @@ -2281,7 +2283,7 @@ attempting to connect to the display. - + @@ -2290,7 +2292,7 @@ Solution: - + @@ -2307,14 +2309,14 @@ packet is necessary. - + Timeout/Retransmission policy: - + @@ -2323,13 +2325,13 @@ than 126 seconds, give up and report an error to the user. - + Refuse - + @@ -2341,7 +2343,7 @@ Additional Fields: - + @@ -2349,7 +2351,7 @@ Additional Fields: - + @@ -2361,14 +2363,14 @@ packet. - + Semantics: - + @@ -2385,14 +2387,14 @@ packet. - + Problems/Solutions: - + @@ -2400,7 +2402,7 @@ Problem: - + @@ -2409,7 +2411,7 @@ Error message is lost. - + @@ -2418,7 +2420,7 @@ Indication: - + @@ -2432,7 +2434,7 @@ or - + @@ -2441,7 +2443,7 @@ Solution: - + @@ -2455,14 +2457,14 @@ message. - + Timeout/Retransmission policy: - + @@ -2471,13 +2473,13 @@ retransmitted. - + Failed - + @@ -2489,7 +2491,7 @@ Additional Fields: - + @@ -2497,7 +2499,7 @@ Additional Fields: - + @@ -2508,7 +2510,7 @@ packet. - + @@ -2516,7 +2518,7 @@ packet. - + @@ -2526,14 +2528,14 @@ Is a human readable string indicating the reason for failure. - + Semantics: - + @@ -2546,14 +2548,14 @@ packet. - + Problems/Solutions - + @@ -2562,13 +2564,13 @@ Same as for - + KeepAlive - + @@ -2580,7 +2582,7 @@ Additional Fields: - + @@ -2588,7 +2590,7 @@ Additional Fields: - + @@ -2597,7 +2599,7 @@ Set to the display index for the display host. - + @@ -2605,7 +2607,7 @@ Set to the display index for the display host. - + @@ -2616,14 +2618,14 @@ packet during the negotiation for the current session. - + Sematics: - + @@ -2656,14 +2658,14 @@ most recent packet. - + Valid Responses: - + @@ -2671,14 +2673,14 @@ Valid Responses: - + Problems/Solutions: - + @@ -2686,7 +2688,7 @@ Problem: - + @@ -2696,7 +2698,7 @@ Manager does not receive the packet or display does not receive the response. - + @@ -2705,7 +2707,7 @@ Indication: - + @@ -2717,7 +2719,7 @@ packet is returned. - + @@ -2726,7 +2728,7 @@ Solution: - + @@ -2737,13 +2739,13 @@ assume the host is not up after no less than 30 seconds. - + Alive - + @@ -2755,7 +2757,7 @@ Additional Fields: - + @@ -2763,7 +2765,7 @@ Additional Fields: - + @@ -2775,7 +2777,7 @@ is active. - + @@ -2783,7 +2785,7 @@ is active. - + @@ -2794,14 +2796,14 @@ When no session is active this field should be zero. - + Semantics: - + @@ -3386,66 +3388,66 @@ multicast address. The version number in all packets will be 1. Packet opcodes are 16-bit integers. - - - - + + + + - + Packet Name Encoding - + BroadcastQuery 1 - + Query 2 - + IndirectQuery 3 - + ForwardQuery 4 - + Willing 5 - + Unwilling 6 - + Request 7 - + Accept 8 - + Decline 9 - + Manage 10 - + Refuse 11 - + Failed 12 - + KeepAlive 13 @@ -3455,7 +3457,7 @@ A previous version of this document incorrectly reversed the opcodes of - + Alive 14 -- cgit v1.2.3