From alanc@sac.sfbay.sun.com Thu May 7 18:19:03 2009 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n481J24c017507 for ; Thu, 7 May 2009 18:19:03 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n481IxGR008259; Fri, 8 May 2009 02:19:01 +0100 (BST) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KJA0081DWZNBM00@nwk-avmta-1.sfbay.Sun.COM>; Thu, 07 May 2009 18:18:59 -0700 (PDT) Received: from dm-sfbay-01.sfbay.sun.com ([129.145.155.118]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KJA00LCZWZNF390@nwk-avmta-1.sfbay.Sun.COM>; Thu, 07 May 2009 18:18:59 -0700 (PDT) Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n481Iwo1061161; Thu, 07 May 2009 18:18:58 -0700 (PDT) Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n481Iuds017502; Thu, 07 May 2009 18:18:56 -0700 (PDT) Received: (from alanc@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id n481IujU017498; Thu, 07 May 2009 18:18:56 -0700 (PDT) Date: Thu, 07 May 2009 18:18:56 -0700 (PDT) From: Alan Coopersmith Subject: X Generic Event Extension (XGE), Version 1.0 [PSARC/2009/293 Self Review] To: PSARC-ext@sun.com Cc: xserver-group@sun.com, xwin-discuss@opensolaris.org Message-id: <200905080118.n481IujU017498@sac.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 4555 I am sponsoring this case for myself, and have marked it closed approved automatic, as it simply imports an X protocol extension from X.Org following the expected mechanisms. If anyone thinks more review is necessary, let me know and I will convert to a fasttrack. As this case only provides compatible additions, the release binding is patch, though no patch/update release delivery is currently planned. -Alan Coopersmith- alan.coopersmith@sun.com Sun Microsystems, Inc. - X Window System Engineering Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI This information is Copyright 2009 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: X Generic Event Extension (XGE), Version 1.0 1.2. Name of Document Author/Supplier: Author: Alan Coopersmith 1.3 Date of This Document: 07 May, 2009 4. Technical Description This case adds support to the X Window System on Solaris/OpenSolaris for the X Generic Event Extension (XGE), Version 1.0, as defined by the X.Org community. XGE was designed to solve two problems in the X11 protocol event reporting mechanism: 1) The X11 protocol only has 64 event codes available for events, including all extensions, and namespace exhaustion was foreseen in the near future. 2) The X11 protocol definition of all events as being exactly 32-bytes long made for easier protocol parsing when the protocol was created, but has limited some recent extensions who wish to pass back more data, requiring events to tell the client to request more data, adding latency waiting for additional round trips between client & server. XGE simply defines one new event opcode (35, GenericEvent) in the core protocol, and then re-uses this opcode for multiple events. The event contents are defined in the X11 protocol syntax as: type: BYTE; always GenericEvent extension: CARD8; extension offset sequenceNumber: CARD16 low 16 bits of request seq. number length: CARD32 length evtype: CARD16 event type The actual type of an event is specified as the combination of extension and evtype. extension specifies the matching extension's major opcode. evtype is a static type as defined for this extension. evtype must be unique within the extension. XGE also allows events that are longer than the standard X protocol's 32 byte events. The length field of a GenericEvent defines the number of bytes after the initial 32 bytes in 4 byte units. Because long events will break protocol parsing for clients that are not expecting to handle events with a length other than 32-bytes, the X server must not send a long event unless the client supports XGE. This extension, like most X extensions, uses a familiar versioning taxonomy - compatible changes increment the minor version number, while incompatible changes increment the major version number. While no incompatible changes are expected at this time, the versioning will allow them to be implemented without breaking existing clients, so the stability level of the Version 1.0 interfaces is set to Committed. The client API for this extension consists of two functions, defined in the header and implemented in libXext.so: Bool XGEQueryExtension(Display* dpy, int *event_basep, int *err_basep); Bool XGEQueryVersion(Display* dpy, int *major, int* minor); These follow the standard X11 extension design pattern of returning a True or False return value indicating whether the extension is supported on the given display, and the major & minor version numbers of the implemented version, and the event & error codes assigned to the extension. The X server side of the implementation will be provided in the Xorg 1.6 case (PSARC 2009/292) to follow shortly. Imported interfaces: -------------------- X Window System protocol, Version 11 (X11) Committed/Standard libXext.so.4 Committed/Standard Exported interfaces: -------------------- X Generic Event extension, Version 1.0 Committed [1] Committed XGEQueryExtension() Committed XGEQueryVersion() Committed References: ----------- [1] X Generic Event Extension specification, materials/geproto.txt Original/upstream at: http://cgit.freedesktop.org/xorg/proto/xextproto/tree/geproto.txt 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: X Consolidation (Desktop C-Team) 6.5. ARC review type: Automatic 6.6. ARC Exposure: open From carlsonj@phorcys.east.sun.com Fri May 8 11:35:39 2009 Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n48IZdfR022334 for ; Fri, 8 May 2009 11:35:39 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n48IZcKh000178; Fri, 8 May 2009 11:35:38 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KJC00L0J8ZETJ00@nwk-avmta-1.sfbay.Sun.COM>; Fri, 08 May 2009 11:35:38 -0700 (PDT) Received: from dm-east-02.east.sun.com ([129.148.13.5]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KJC00B2Q8ZDLXD0@nwk-avmta-1.sfbay.Sun.COM>; Fri, 08 May 2009 11:35:37 -0700 (PDT) Received: from phorcys.east.sun.com (phorcys.East.Sun.COM [129.148.174.143]) by dm-east-02.east.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n48IZZJ3060312; Fri, 08 May 2009 14:35:35 -0400 (EDT) Received: from phorcys.east.sun.com (phorcys.local [127.0.0.1]) by phorcys.east.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n48IYibx001001; Fri, 08 May 2009 14:34:44 -0400 (EDT) Received: (from carlsonj@localhost) by phorcys.east.sun.com (8.14.3+Sun/8.14.3/Submit) id n48IYipw000998; Fri, 08 May 2009 14:34:44 -0400 (EDT) Date: Fri, 08 May 2009 14:34:44 -0400 From: James Carlson Subject: Re: X Generic Event Extension (XGE), Version 1.0 [PSARC/2009/293 Self Review] In-reply-to: <200905080118.n481IujU017498@sac.sfbay.sun.com> To: Alan Coopersmith Cc: PSARC-ext@sun.com, xserver-group@sun.com, xwin-discuss@opensolaris.org Message-id: <18948.31556.327477.93111@gargle.gargle.HOWL> MIME-version: 1.0 X-Mailer: VM 7.01 under Emacs 21.3.1 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200905080118.n481IujU017498@sac.sfbay.sun.com> Status: RO Content-Length: 656 Alan Coopersmith writes: > I am sponsoring this case for myself, and have marked it closed approved > automatic, as it simply imports an X protocol extension from X.Org following > the expected mechanisms. If anyone thinks more review is necessary, let > me know and I will convert to a fasttrack. +1 (Curious: are there any users of this extension that will also be delivered? Does the X server generate these events itself?) -- James Carlson, Solaris Networking Sun Microsystems / 35 Network Drive 71.232W Vox +1 781 442 2084 MS UBUR02-212 / Burlington MA 01803-2757 42.496N Fax +1 781 442 1677 From Alan.Coopersmith@Sun.COM Fri May 8 11:55:06 2009 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n48It6CI022718 for ; Fri, 8 May 2009 11:55:06 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n48It5YU028274; Fri, 8 May 2009 11:55:05 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KJC00L299VTOM00@nwk-avmta-2.sfbay.sun.com>; Fri, 08 May 2009 11:55:05 -0700 (PDT) Received: from sca-es-mail-1.sun.com ([192.18.43.132]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KJC00AZZ9VROLC0@nwk-avmta-2.sfbay.sun.com>; Fri, 08 May 2009 11:55:04 -0700 (PDT) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n48It3Wu024016; Fri, 08 May 2009 11:55:03 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7.0-5.01 64bit (built Feb 19 2009)) id <0KJC00D009M4SW00@fe-sfbay-10.sun.com>; Fri, 08 May 2009 11:55:03 -0700 (PDT) Received: from [10.6.102.27] ([unknown] [10.6.102.27]) by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7.0-5.01 64bit (built Feb 19 2009)) with ESMTPSA id <0KJC00ETE9VPCX90@fe-sfbay-10.sun.com>; Fri, 08 May 2009 11:55:02 -0700 (PDT) Date: Fri, 08 May 2009 11:55:01 -0700 From: Alan Coopersmith Subject: Re: X Generic Event Extension (XGE), Version 1.0 [PSARC/2009/293 Self Review] In-reply-to: <18948.31556.327477.93111@gargle.gargle.HOWL> Sender: Alan.Coopersmith@Sun.COM To: James Carlson Cc: PSARC-ext@Sun.COM, xserver-group@Sun.COM, xwin-discuss@opensolaris.org Message-id: <4A048005.1090705@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=UTF-8 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 X-Enigmail-Version: 0.95.1 References: <200905080118.n481IujU017498@sac.sfbay.sun.com> <18948.31556.327477.93111@gargle.gargle.HOWL> User-Agent: Thunderbird 2.0.0.21 (X11/20090323) Status: RO Content-Length: 891 James Carlson wrote: > Alan Coopersmith writes: >> I am sponsoring this case for myself, and have marked it closed approved >> automatic, as it simply imports an X protocol extension from X.Org following >> the expected mechanisms. If anyone thinks more review is necessary, let >> me know and I will convert to a fasttrack. > > +1 > > (Curious: are there any users of this extension that will also be > delivered? Does the X server generate these events itself?) The first consumer planned is an update to the X Input Extension in a future Xorg release - unfortunately, that wasn't ready in time and slipped out of Xorg 1.6, so Xorg 1.6 has the infrastructure for negotiating the new event format with clients, but won't actually be sending any XGE format events yet. -- -Alan Coopersmith- alan.coopersmith@sun.com Sun Microsystems, Inc. - X Window System Engineering From carlsonj@phorcys.east.sun.com Fri May 8 12:01:16 2009 Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n48J1Flj002042 for ; Fri, 8 May 2009 12:01:15 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id n48J1CR9005180; Sat, 9 May 2009 03:01:14 +0800 (SGT) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KJC00407A61SJ00@nwk-avmta-1.sfbay.Sun.COM>; Fri, 08 May 2009 12:01:13 -0700 (PDT) Received: from dm-east-02.east.sun.com ([129.148.13.5]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KJC00BH9A5ZLKE0@nwk-avmta-1.sfbay.Sun.COM>; Fri, 08 May 2009 12:01:12 -0700 (PDT) Received: from phorcys.east.sun.com (phorcys.East.Sun.COM [129.148.174.143]) by dm-east-02.east.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n48J1ADq007491; Fri, 08 May 2009 15:01:10 -0400 (EDT) Received: from phorcys.east.sun.com (phorcys.local [127.0.0.1]) by phorcys.east.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n48J0MGU001139; Fri, 08 May 2009 15:00:22 -0400 (EDT) Received: (from carlsonj@localhost) by phorcys.east.sun.com (8.14.3+Sun/8.14.3/Submit) id n48J0M9D001136; Fri, 08 May 2009 15:00:22 -0400 (EDT) Date: Fri, 08 May 2009 15:00:22 -0400 From: James Carlson Subject: Re: X Generic Event Extension (XGE), Version 1.0 [PSARC/2009/293 Self Review] In-reply-to: <4A048005.1090705@sun.com> To: Alan Coopersmith Cc: PSARC-ext@sun.com, xserver-group@sun.com, xwin-discuss@opensolaris.org Message-id: <18948.33094.313118.514003@gargle.gargle.HOWL> MIME-version: 1.0 X-Mailer: VM 7.01 under Emacs 21.3.1 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200905080118.n481IujU017498@sac.sfbay.sun.com> <18948.31556.327477.93111@gargle.gargle.HOWL> <4A048005.1090705@sun.com> Status: RO Content-Length: 1122 Alan Coopersmith writes: > James Carlson wrote: > > Alan Coopersmith writes: > >> I am sponsoring this case for myself, and have marked it closed approved > >> automatic, as it simply imports an X protocol extension from X.Org following > >> the expected mechanisms. If anyone thinks more review is necessary, let > >> me know and I will convert to a fasttrack. > > > > +1 > > > > (Curious: are there any users of this extension that will also be > > delivered? Does the X server generate these events itself?) > > The first consumer planned is an update to the X Input Extension in a future > Xorg release - unfortunately, that wasn't ready in time and slipped out of > Xorg 1.6, so Xorg 1.6 has the infrastructure for negotiating the new event > format with clients, but won't actually be sending any XGE format events yet. OK; thanks. I was just curious about dependencies. No problem. -- James Carlson, Solaris Networking Sun Microsystems / 35 Network Drive 71.232W Vox +1 781 442 2084 MS UBUR02-212 / Burlington MA 01803-2757 42.496N Fax +1 781 442 1677