From 5b71d6320dee422017a7efdcdcb2bb2efd13cedc Mon Sep 17 00:00:00 2001 From: Alan Coopersmith Date: Sun, 12 Jan 2014 16:17:19 -0800 Subject: spec: Use tables for contents of Requests, Events & Errors Much more consistent layout than previous mix of blockquotes & literallayouts Signed-off-by: Alan Coopersmith --- specs/fsproto.xml | 1446 +++++++++++++++++++++++++---------------------------- 1 file changed, 681 insertions(+), 765 deletions(-) (limited to 'specs') diff --git a/specs/fsproto.xml b/specs/fsproto.xml index 68f2671..3e85c1d 100644 --- a/specs/fsproto.xml +++ b/specs/fsproto.xml @@ -1131,15 +1131,21 @@ requests are received. Servers are permitted to add or remove fonts to the list visible to the client between any two requests, but requests must be processed atomically. Each request packet is at least 4 bytes long and contains the following fields: + + + + + + + + major-opcode:CARD8 + minor-opcode:CARD8 + length:CARD16 + + + - - - major-opcode: CARD8 - minor-opcode: CARD8 - length: CARD16 - - The MAJOR-OPCODE specifies which core request or extension package this packet represents. If the MAJOR-OPCODE corresponds to a core request, the MINOR-OPCODE contains 8 bits of request-specific data. Otherwise, the @@ -1179,16 +1185,22 @@ between 0 and 255, inclusive. Each reply is at least 8 bytes long and contains the following fields: + + + + + + + + type:CARD8value of 0 + data-or-unused:CARD8 + sequence-number:CARD16 + length:CARD32 + + + - - - type: CARD8 value of 0 - data-or-unused: CARD8 - sequence-number: CARD16 - length: CARD32 - - The TYPE field has a value of zero. The DATA-OR-UNUSED field may be used to encode one byte of reply-specific data (see Section 5.2 on request encoding). @@ -1202,26 +1214,31 @@ data. Requests that have replies are described using the following syntax: +
+ RequestName + + + + + + + arg1:type1 + arg2:type2 + ... + argN:typeN + ▶ + result1:type1 + result2:type2 + ... + resultM:typeM + Errors:kind1, kind2 ..., kindK + + + + Description +
- - - RequestName - arg1: type1 - arg2: type2 - ... - argN: typeN - ▶ - result1: type1 - result2: type2 - ... - resultM: typeM - - Errors: kind1, kind2 ..., kindK - - Description - - If a request does not generate a reply, the "▶" and result lines are omitted. If a request may generate multiple replies, the "▶" is replaced by a "▶+". In the authorization data exchanges in the initial connection setup @@ -1237,12 +1254,19 @@ mutually-understood virtual stream:
open connection open connection - - byte-order: BYTE - client-major-protocol-version: CARD16 - client-minor-protocol-version: CARD16 - authorization-protocols: LISTofAUTH - + + + + + + + byte-order:BYTE + client-major-protocol-version:CARD16 + client-minor-protocol-version:CARD16 + authorization-protocols:LISTofAUTH + + + The initial byte of the connection specifies the BYTE-ORDER in which subsequent 16-bit and 32-bit numeric values are to be @@ -1253,8 +1277,6 @@ that the least-significant byte is to be transmitted first. If any other value is encountered the server closes the connection without any response. - -
The CLIENT-MAJOR-PROTOCOL-VERSION and CLIENT-MINOR-PROTOCOL-VERSION specify which version of the @@ -1270,18 +1292,24 @@ information. The server may use this to determine which protocol to use or as part of the initial exchange of authorization data. - -▶ -status: { Success, Continue, - Busy, Denied } -server-major-protocol-version: CARD16 -server-minor-protocol-version: CARD16 -alternate-servers-hint: LISTofALTERNATESERVER -authorization-index: CARD8 -authorization-data: LISTofBYTE - + + + + + + + ▶ + status:{ Success, Continue, + Busy, Denied } + server-major-protocol-version:CARD16 + server-minor-protocol-version:CARD16 + alternate-servers-hint:LISTofALTERNATESERVER + authorization-index:CARD8 + authorization-data:LISTofBYTE + + + - The SERVER-MAJOR-PROTOCOL-VERSION and SERVER-MINOR-PROTOCOL-VERSION specify the version of the font service protocol that the server expects from the client. If @@ -1305,16 +1333,21 @@ connection is rejected or lost. The STATUS field indicates whether the server accepted, rejected, or would like more information about the connection. It has one of the following alternate values: + + + + + + + Success0 + Continue1 + Busy2 + Denied3 + + + - - - Success 0 - Continue 1 - Busy 2 - Denied 3 - - If STATUS is Denied, the server has rejected the client's authorization information. If STATUS is Busy, the server has simply decided that it cannot provide fonts to this client at @@ -1333,26 +1366,27 @@ used to send back authorization protocol-dependent data to the client (such as a challenge, authentication of the server, etc.). -
- If STATUS is Success, the following section of protocol is omitted. Otherwise, if STATUS is Continue, the server expects more authorization data from the client (i.e. the connection setup is not finished, so no requests or events may be sent): + + + + + + + ◀ + more-authorization-data:STRING8 + ▶ + status:{ Success, Continue, Busy, Denied } + more-authorization-data:LISTofBYTE + + + - - -◀ -more-authorization-data: STRING8 -▶ -status: { Success, Continue, - Busy, Denied } -more-authorization-data: LISTofBYTE - - - The values in STATUS have the same meanings as described above. This section of protocol is repeated until the server @@ -1365,15 +1399,21 @@ Once the connection has been accepted and STATUS is Success, an implicit AccessContext is created for the authorization data and the protocol continues with the following data sent from the server: + + + + + + + ▶ + remaining-length:CARD32 + maximum-request-length:CARD16 + release-number:CARD32 + vendor:STRING8 + + + - - -▶ -remaining-length: CARD32 -maximum-request-length: CARD16 -release-number: CARD32 -vendor: STRING8 - The REMAINING-LENGTH specifies the length in 4-byte units of the remaining data to be transmitted to the client. The @@ -1397,9 +1437,16 @@ exchanged, the client may issue any of requests described below:
<function>NoOp</function> NoOp - -Errors: Alloc - + + + + + + + Errors:Alloc + + + This request does nothing. It is typically used in response to a @@ -1411,23 +1458,24 @@ event.
<function>ListExtensions</function> ListExtensions - -▶ - + + + + + + + ▶ + names:LISTofSTRING8 + Errors:Alloc + + + -
- -names: LISTofSTRING8 - - -Errors: Alloc - This request returns the names of the extension packages that are supported by the server. Extension names are case-sensitive and are encoded in ISO 8859-1. -
@@ -1435,44 +1483,26 @@ case-sensitive and are encoded in ISO 8859-1. <function>QueryExtension</function> QueryExtension -
- -name: STRING8 - -
- -▶ - - -
- -present: BOOL - - -major-version: CARD16 - - -minor-version: CARD16 - - -major-opcode: CARD8 - - -first-event: CARD8 - - -number-events: CARD8 - - -first-error: CARD8 - - -number-errors: CARD8 - - -Errors: -Alloc - + + + + + + + name:STRING8 + ▶ + present:BOOL + major-version:CARD16 + minor-version:CARD16 + major-opcode:CARD8 + first-event:CARD8 + number-events:CARD8 + first-error:CARD8 + number-errors:CARD8 + Errors:Alloc + + + This request determines whether or not the extension package specified by NAME (encoded in ISO 8859-1) is supported by the @@ -1506,37 +1536,27 @@ this extension's events. Otherwise, a Request error is returned. -
-
<function>ListCatalogues</function> ListCatalogues -
- -pattern: STRING8 - - -max-names: CARD32 - -
- - -▶+ - -
- -replies-following-hint: CARD32 - - -names: LISTofSTRING8 - - -Errors: -Alloc - + + + + + + + pattern:STRING8 + max-names:CARD32 + ▶+ + replies-following-hint:CARD32 + names:LISTofSTRING8 + Errors:Alloc + + + This request returns a list of at most MAX-NAMES names of collections (called catalogues) of fonts that match @@ -1571,22 +1591,23 @@ replies that are likely, but not required, to follow. In the last reply, which may contain zero or more names, this field is set to zero. -
-
<function>SetCatalogues</function> SetCatalogues -
- -names: LISTofSTRING8 - - -Errors: -Alloc, -Name - + + + + + + + names:LISTofSTRING8 + Errors:Alloc, +Name + + + This request sets the list of catalogues whose fonts should be visible to the client. The union of the fonts provided by @@ -1607,26 +1628,23 @@ If any of the catalogue names are invalid, a Name error is returned and the request is ignored. -
-
<function>GetCatalogues</function> GetCatalogues - - -▶ - - -
- -names: LISTofSTRING8 - - -Errors: -Alloc - + + + + + + + ▶ + names:LISTofSTRING8 + Errors:Alloc + + + This request returns the current list of catalogue names (encoded in ISO 8859-1) associated with the client. These @@ -1640,26 +1658,24 @@ A zero-length list indicates the server's default set of fonts. Catalogue names are case-insensitive and may be returned in mixed case. -
-
<function>SetEventMask</function> SetEventMask - -
- -extension-opcode: CARD8 - - -event-mask: EVENTMASK - - -Errors: -EventMask, -Request - + + + + + + + extension-opcode:CARD8 + event-mask:EVENTMASK + Errors:EventMask, +Request + + + This request specifies the set of maskable events that the extension indicated by EXTENSION-OPCODE (or zero for the core) @@ -1691,30 +1707,24 @@ core), an error is returned and the request is ignored. -
-
<function>GetEventMask</function> GetEventMask - -
- -extension-opcode: CARD8 - -
- -▶ - -
- -event-mask: EVENTMASK - - -Errors: -Request - + + + + + + + extension-opcode:CARD8 + ▶ + event-mask:EVENTMASK + Errors:Request + + + This request returns the set of maskable core events the extension indicated by EXTENSION-OPCODE (or the core if zero) @@ -1729,40 +1739,27 @@ or zero, a Request error is returned. -
-
<function>CreateAC</function> CreateAC - -
- -ac: ACCESSCONTEXT - - -authorization-protocols: LISTofAUTH - -
- -▶ - - -
- -status: { Success, Continue, Denied } - - -authorization-index: CARD8 - - -authorization-data: LISTofBYTE - - -Errors: -IDChoice - + + + + + + + ac:ACCESSCONTEXT + authorization-protocols:LISTofAUTH + ▶ + status:{ Success, Continue, Denied } + authorization-index:CARD8 + authorization-data:LISTofBYTE + Errors:IDChoice + + + This request creates a new AccessContext @@ -1802,13 +1799,20 @@ the request by sending the following protocol and receiving the indicated response from the server. This continues until STATUS is set to either Success or Denied. - - ◀ - more-authorization-data: STRING8 - ▶ - status: { Success, Continue, Denied } - more-authorization-data: LISTofBYTE - + + + + + + + ◀ + more-authorization-data:STRING8 + ▶ + status:{ Success, Continue, Denied } + more-authorization-data:LISTofBYTE + + + Once the connection has been accepted and STATUS is Success, the request is complete. @@ -1817,23 +1821,23 @@ the request is complete. If AC is not in the range [1..2^29-1] or is already associated with an access context, an IDChoice error is returned. -
-
<function>FreeAC</function> FreeAC - -
- -ac: ACCESSCONTEXT - - -Errors: -AccessContext, -Alloc - + + + + + + + ac:ACCESSCONTEXT + Errors:AccessContext, +Alloc + + + This request indicates that the specified AC should no longer be associated with a valid access context. If AC is also the @@ -1860,22 +1864,22 @@ created by AccessContext error is returned. -
-
<function>SetAuthorization</function> SetAuthorization - -
- -ac: ACCESSCONTEXT - - -Errors: -AccessContext - + + + + + + + ac:ACCESSCONTEXT + Errors:AccessContext + + + This request sets the AccessContext @@ -1908,23 +1912,23 @@ an AccessContext error is returned. -
-
<function>SetResolution</function> SetResolution - -
- -resolutions: LISTofRESOLUTION - - -Errors: -Resolution, -Alloc - + + + + + + + resolutions:LISTofRESOLUTION + Errors:Resolution, +Alloc + + + This request provides a hint as to the resolution and preferred point size of the drawing surfaces for which the @@ -1945,60 +1949,49 @@ default resolutions for this client are changed. If a RESOLUTION entry contains a zero, a Resolution error is returned and the default resolutions are not changed. -
<function>GetResolution</function> GetResolution - -▶ - -
- -resolutions: LISTofRESOLUTION - - -Errors: -Alloc - + + + + + + + ▶ + resolutions:LISTofRESOLUTION + Errors:Alloc + + + This request returns the current list of default resolutions. If a client has not performed a SetResolution, a server-dependent default value is returned. -
-
<function>ListFonts</function> ListFonts - -
- -pattern: STRING8 - - -max-names: CARD32 - -
- -▶+ - - -
- -replies-following-hint: CARD32 - - -names: LISTofSTRING8 - - -Errors: -Alloc - + + + + + + + pattern:STRING8 + max-names:CARD32 + ▶+ + replies-following-hint:CARD32 + names:LISTofSTRING8 + Errors:Alloc + + + This request returns a list of at most MAX-NAMES font names that match the specified PATTERN, according to matching rules @@ -2036,47 +2029,29 @@ replies that are likely, but not required, to follow. In the last reply, which may contain zero or more names, this field is set to zero. -
-
<function>ListFontsWithXInfo</function> ListFontsWithXInfo - -
- -pattern: STRING8 - - -pattern: STRING8 - - -pattern: STRING8 - - -max-names: CARD32 - -
- - -▶+ - - -
- -replies-following-hint: CARD32 - - -info: XFONTINFO - - -name: STRING8 - - -Errors: -Alloc - + + + + + + + pattern:STRING8 + pattern:STRING8 + pattern:STRING8 + max-names:CARD32 + ▶+ + replies-following-hint:CARD32 + info:XFONTINFO + name:STRING8 + Errors:Alloc + + + This request is similar to ListFonts @@ -2088,62 +2063,46 @@ and no INFO is sent. -The REPLIES-FOLLOWING-HINT field in all but the last reply -contains a positive value that specifies the number of replies -that are likely, but not required, to follow. In the last -reply, this field is set to zero. - - - -If PATTERN is of zero length or if MAX-NAMES is equal to -zero, only the final reply containing a zero-length NAME and -no INFO is returned. This may be used to synchronize the -client with the server. - -
- -
- -
- <function>OpenBitmapFont</function> - OpenBitmapFont - -
- -fontid: FONTID - - -pattern: STRING8 - - -format-mask: BITMAPFORMATMASK - - -format-hint: BITMAPFORMAT - -
- - -▶ - -
- -otherid: FONTID or None - - -otherid-valid: BOOL +The REPLIES-FOLLOWING-HINT field in all but the last reply +contains a positive value that specifies the number of replies +that are likely, but not required, to follow. In the last +reply, this field is set to zero. -cachable: BOOL + +If PATTERN is of zero length or if MAX-NAMES is equal to +zero, only the final reply containing a zero-length NAME and +no INFO is returned. This may be used to synchronize the +client with the server. - -Errors: +
+ +
+ <function>OpenBitmapFont</function> + OpenBitmapFont + + + + + + + fontid:FONTID + pattern:STRING8 + format-mask:BITMAPFORMATMASK + format-hint:BITMAPFORMAT + ▶ + otherid:FONTID or None + otherid-valid:BOOL + cachable:BOOL + Errors: IDChoice, Name, Format, AccessContext, -Alloc - +Alloc + + + This request looks for a server-dependent choice of the font names that match the specified PATTERN according to the @@ -2259,31 +2218,25 @@ fields in FORMAT-HINT indicated by FORMAT-MASK are invalid, a Format error is returned. - -
<function>QueryXInfo</function> QueryXInfo - -
- -fontid: FONTID - -
- -▶ - -
- -info: XFONTINFO - - -Errors: -Font, -Alloc - + + + + + + + fontid:FONTID + ▶ + info:XFONTINFO + Errors:Font, +Alloc + + + This request returns the font header and property information for the open font associated with FONTID. @@ -2295,78 +2248,56 @@ If FONTID is not associated with any open fonts, a error is returned. -
-
<function>QueryXExtents8</function> QueryXExtents8 - -
- -fontid: FONTID - - -range: BOOL - - - -chars: STRING8 - -
- -▶ - -
- -extents: LISTofXCHARINFO - - -Errors: -Font, + + + + + + + fontid:FONTID + range:BOOL + chars:STRING8 + ▶ + extents:LISTofXCHARINFO + Errors:Font, Range, -Alloc - +Alloc + + + This request is equivalent to QueryXExtents16 except that it uses 1-byte character codes. -
-
<function>QueryXExtents16</function> QueryXExtents16 -
- -fontid: FONTID - - - -range: BOOL - - - -chars: LISTofCHAR2B - -
- -▶ - -
- -extents: LISTofXCHARINFO - - -Errors: -Font, + + + + + + + fontid:FONTID + range:BOOL + chars:LISTofCHAR2B + ▶ + extents:LISTofXCHARINFO + Errors:Font, Range, -Alloc - +Alloc + + + This request returns a list of glyph extents from the open font associated with FONTID for the series of characters @@ -2412,103 +2343,64 @@ ranges, a Range error is returned. -
-
<function>QueryXBitmaps8</function> QueryXBitmaps8 - -
- -fontid: FONTID - - -range: BOOL - - -chars: STRING8 - - -format: BITMAPFORMAT - -
- -▶+ - - -
- -replies-following-hint: CARD32 - - - -offsets: LISTofOFFSET32 - - - -bitmaps: LISTofBYTE - - -Errors: -Font, + + + + + + + fontid:FONTID + range:BOOL + chars:STRING8 + format:BITMAPFORMAT + ▶+ + replies-following-hint:CARD32 + offsets:LISTofOFFSET32 + bitmaps:LISTofBYTE + Errors:Font, Range, Format, -Alloc - +Alloc + + + This request is equivalent to QueryXBitmaps16 except that it uses 1-byte character codes. -
<function>QueryXBitmaps16</function> QueryXBitmaps16 - -
- -fontid: FONTID - - - -range: BOOL - - - -chars: LISTofCHAR2B - - - -format: BITMAPFORMAT - -
- -▶+ - -
- -replies-following-hint: CARD32 - - - -offsets: LISTofOFFSET32 - - - -bitmaps: LISTofBYTE - - -Errors: -Font, -Range, -Format, -Alloc - + + + + + + + fontid:FONTID + range:BOOL + chars:LISTofCHAR2B + format:BITMAPFORMAT + ▶+ + replies-following-hint:CARD32 + offsets:LISTofOFFSET32 + bitmaps:LISTofBYTE + Errors:Font, + Range, + Format, + Alloc + + + This request returns a list of glyph bitmaps from the open font associated with FONTID for the series of characters @@ -2611,22 +2503,22 @@ error is returned. If RANGE is True and CHARS contains any invalid ranges, a Range error is returned. If FORMAT is invalid, a Format error is returned. -
<function>CloseFont</function> CloseFont - -
- -fontid: FONTID - - -Errors: -Font, -Alloc - + + + + + + + fontid:FONTID + Errors:Font, Alloc + + + This request indicates that the specified FONTID should no longer be associated with an open font. The server is free to @@ -2642,14 +2534,12 @@ If FONTID is not associated with any open fonts, a Font error is returned. -
close connection close connection -
When a connection is closed, a CloseFont @@ -2658,7 +2548,6 @@ that are open on the connection. In addition, the server is free to release any storage or licenses allocated on behalf of the client that made the connection. -
@@ -2670,39 +2559,24 @@ the client that made the connection. All errors are at least 16 bytes long and contain the following fields: -
- -type: CARD8 value of 1 - - - -error-code: CARD8 - - - -sequence-number: CARD16 - - - -length: CARD32 - - - -timestamp: TIMESTAMP - - - -major-opcode: CARD8 - - - -minor-opcode: CARD8 - - - -data-or-unused: CARD16 - -
+ + + + + + + + type:CARD8value of 1 + error-code:CARD8 + sequence-number:CARD16 + length:CARD32 + timestamp:TIMESTAMP + major-opcode:CARD8 + minor-opcode:CARD8 + data-or-unused:CARD16 + + + The TYPE field has a value of one. The ERROR-CODE field specifies which error @@ -2725,11 +2599,17 @@ The following errors are defined for the core protocol:
<errorname>Request</errorname> Error CodesRequest - -
- -data-or-unused: CARD16 unused - + + + + + + + + data-or-unused:CARD16unused + + + This error is generated by any request that has an unknown combination of major and minor request numbers, or by any @@ -2737,20 +2617,23 @@ extension request that is issued before a QueryExtension of that extension. -
<errorname>Format</errorname> Error CodesFormat - -
- -data-or-unused: CARD16 unused - - -format: BITMAPFORMAT bad format value - + + + + + + + + data-or-unused:CARD16unused + format:BITMAPFORMATbad format value + + + This error is generated by the use of an invalid BITMAPFORMAT in the @@ -2760,19 +2643,23 @@ in the requests. The value that caused the error is included as extra data. -
<errorname>Font</errorname> Error CodesFont -
- -data-or-unused: CARD16 unused - - -fontid: FONTID bad font identifier - + + + + + + + + data-or-unused:CARD16unused + fontid:FONTIDbad font identifier + + + This error is generated by an invalid FONTID in the QueryXInfo, @@ -2785,20 +2672,23 @@ and requests. The value that caused the error is included as extra data. -
<errorname>Range</errorname> Error CodesRange - -
- -data-or-unused: CARD16 unused - - -range: RANGE bad range - + + + + + + + + data-or-unused:CARD16unused + range:RANGEbad range + + + This error is generated by an invalid RANGE in the QueryXExtents8, @@ -2809,42 +2699,46 @@ and requests. The value that caused the error is included as extra data. -
<errorname>EventMask</errorname> Error CodesEventMask - -
- -data-or-unused: CARD16 unused - - - -event-mask: EVENTMASK bad event mask - + + + + + + + + data-or-unused:CARD16unused + event-mask:EVENTMASKbad event mask + + + This error is generated by an invalid EVENTMASK in the SetEventMask request. The value that caused the error is included as extra data. -
<errorname>AccessContext</errorname> Error CodesAccessContext - -
- -data-or-unused: CARD16 unused - - -ac: ACCESSCONTEXT unaccepted -AccessContext - + + + + + + + + data-or-unused:CARD16unused + ac:ACCESSCONTEXTunaccepted AccessContext + + + This error is generated by an invalid ACCESSCONTEXT in the FreeAC @@ -2857,20 +2751,23 @@ first two cases, the ACCESSCONTEXT of the errant request is returned as extra data. In the third case, the current ACCESSCONTEXT is returned as extra data. -
<errorname>IDChoice</errorname> Error CodesIDChoice - -
- -data-or-unused: CARD16 unused - - -id: ID bad identifier - + + + + + + + + data-or-unused:CARD16unused + id:IDbad identifier + + + This error is generated by an invalid or already associated ACCESSCONTEXT identifier in a @@ -2881,17 +2778,22 @@ in an request. The value that caused the error is included as extra data. -
<errorname>Name</errorname> Error CodesName - -
- -data-or-unused: CARD16 unused - + + + + + + + + data-or-unused:CARD16unused + + + This error is generated by a font name pattern that matches no fonts in an @@ -2900,25 +2802,24 @@ request or no catalogue names in a SetCatalogues request. -
<errorname>Resolution</errorname> Error CodesResolution - -
- -data-or-unused: CARD16 X value of errant resolution - - - -y-resolution: CARD16 Y value of errant resolution - - - -point-size: CARD16 point size of errant resolution - + + + + + + + + data-or-unused:CARD16X value of errant resolution + y-resolution:CARD16Y value of errant resolution + point-size:CARD16point size of errant resolution + + + This error is generated in response to an invalid RESOLUTION structure in a @@ -2926,58 +2827,70 @@ structure in a request. The value that caused the error is included in the DATA-OR-UNUSED field and as extra data. -
<errorname>Alloc</errorname> Error CodesAlloc - -
- -data-or-unused: CARD16 unused - + + + + + + + + data-or-unused:CARD16unused + + + This error is generated by any request for which the server lacks sufficient resources (especially memory). -
<errorname>Length</errorname> Error CodesLength - -
- -data-or-unused: CARD16 unused - - -length: CARD32 bad length value - + + + + + + + + data-or-unused:CARD16unused + length:CARD32bad length value + + + This error is generated by any request that has a length field greater than (MAXIMUM-REQUEST-LENGTH * 4) bytes. The value that caused the error is included as extra data. -
<errorname>Implementation</errorname> Error CodesImplementation - -
- -data-or-unused: CARD16 unused - + + + + + + + + data-or-unused:CARD16unused + + + This error may be generated in response to any request that the server is unable to process because it is deficient. Use of this error is highly discouraged and indicates lack of conformance to the protocol. -
Extensions @@ -2997,29 +2910,22 @@ Additional errors may be defined by extensions. Events may be generated in response to requests or at the server's discretion after the initial connection setup information has been exchanged. Each event is at least 12 bytes long and contains the following fields: + + + + + + + + type:CARD8value of 2 + event-code:CARD8 + sequence-number:CARD16 + length:CARD32 + timestamp:TIMESTAMP + + + -
- - -type: CARD8 value of 2 - - - -event-code: CARD8 - - - -sequence-number: CARD16 - - - -length: CARD32 - - - -timestamp: TIMESTAMP - -
The TYPE field contains the value 2. The EVENT-CODE field specifies the number @@ -3034,19 +2940,26 @@ three, these fields are followed by (LENGTH - 3) * 4 bytes of additional data. Events are described using the following syntax: +
+ EventName + + + + + + + arg1:type1 + ... + argN:typeN + + + + Description +
- -EventName - arg1: type1 - ... - argN: typeN - - Description - - If an event does not provide any extra arguments, the -arg1...argN +arg1...argN lines are omitted from the description. @@ -3057,7 +2970,6 @@ The core X Font Service protocol defines the following events:
<function>KeepAlive</function> KeepAlive -
This unsolicited, nonmaskable event may be sent by the server to verify that the connection has not been broken @@ -3067,19 +2979,22 @@ by sending any request (such as NoOp ). -
<function>CatalogueListNotify</function> CatalogueListNotify -
- -added: BOOL - - -deleted: BOOL - + + + + + + + added:BOOL + deleted:BOOL + + + This event is sent to clients that have included CatalogueListChangeMask @@ -3090,20 +3005,22 @@ been added to the server, otherwise it is False. The DELETED field is True if any existing catalogues have been removed from the server, otherwise it is False. -
<function>FontListNotify</function> FontListNotify -
- -added: BOOL - - - -deleted: BOOL - + + + + + + + added:BOOL + deleted:BOOL + + + This event is sent to clients that have included FontListChangeMask @@ -3116,7 +3033,6 @@ field is True if any existing fonts have been removed from any of catalogues used by the client, otherwise it is False. -
Extensions -- cgit v1.2.3