From darrenm@sac.sfbay.sun.com Tue Oct 13 02:21:33 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 n9D9LWL2022375 for ; Tue, 13 Oct 2009 02:21:33 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id n9D9LOwM007454; Tue, 13 Oct 2009 17:21:31 +0800 (SGT) 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 <0KRG00D094NT1100@nwk-avmta-2.sfbay.sun.com>; Tue, 13 Oct 2009 02:21:29 -0700 (PDT) Received: from dm-sfbay-02.sfbay.sun.com ([129.146.11.31]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KRG003BJ4NTWDD0@nwk-avmta-2.sfbay.sun.com>; Tue, 13 Oct 2009 02:21:29 -0700 (PDT) Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n9D9LRGp044058; Tue, 13 Oct 2009 02:21:27 -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 n9D9LPdQ022370; Tue, 13 Oct 2009 02:21:25 -0700 (PDT) Received: (from darrenm@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id n9D9LPM2022366; Tue, 13 Oct 2009 02:21:25 -0700 (PDT) Date: Tue, 13 Oct 2009 02:21:25 -0700 (PDT) From: Darren J Moffat Subject: door_xcreate - extended door creation interface for private doors [PSARC/2009/554 FastTrack timeout 10/20/2009] To: PSARC-ext@sun.com Cc: Gavin.Maltby@sun.com Message-id: <200910130921.n9D9LPM2022366@sac.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 2815 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: door_xcreate - extended door creation interface for private doors 1.2. Name of Document Author/Supplier: Author: Gavin Maltby 1.3 Date of This Document: 13 October, 2009 1.5. Email Aliases: 1.5.1. Responsible Manager: sridhar.yedunuthula@sun.com 1.5.2. Responsible Engineer: gavin.maltby@sun.com 4. Technical Description: 4.1. Details: A new member is added to the doors API - door_xcreate, dedicated to the creation of private (as in a having a dedicated pool of server threads) doors. This case seeks Micro/Patch binding (additional libraries that depend on this interface will require that binding). See the door_xcreate(3C) manpage in the case materials. Points to note: o This interface allows the appointment of a door server thread creation function on a per-door basis, something that is not possible with the existing door_create(3C) and door_server_create(3C) interfaces. This facility is the primary reason for the introduction of this interface - without it the use of door servers in general-purpose system libraries is problematic since the thread creation function is shared with the application which may itself offer a door server. o Through the provision of a library-supplied thread startup function that the developer is required to use for newly-created door server threads, this interface also simplifies the creation of private doors. When using door_xcreate(3C) the developer is not responsible for synchronizing the newly-created thread with the return of door_create, nor for calling door_bind(3C) for the new thread or causing the thread to enter service via door_return(3C). o The (Committed) door_create(3C) interface is unchanged in both interface and semantics. 4.5. Interfaces: Interface Stability ----------------------- ------------ libc`door_xcreate Committed libdoor`door_xcreate Uncommitted (see below) The libdoor library has been obsoleted in SunOS 5.11, so the main addition is to libc alongside existing Committed door interfaces there. Since this case seeks Micro/Patch binding, however, we will add the interface to libdoor. Note that libdoor has only SUNWprivate_1.1 interfaces, hence the Uncommitted when used via that library. 4.6. Doc Impact: New manpage door_xcreate(3C) - see case materials. Minor updates to door_create(3C) and libc(3lib) to reference the new interface. 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: ON 6.5. ARC review type: FastTrack 6.6. ARC Exposure: open From carlsonj@workingcode.com Tue Oct 13 05:00:43 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 n9DC0gRa026096 for ; Tue, 13 Oct 2009 05:00:42 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n9DC0aEn009701; Tue, 13 Oct 2009 13:00:41 +0100 (BST) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KRG00803C14E900@brm-avmta-1.central.sun.com>; Tue, 13 Oct 2009 06:00:40 -0600 (MDT) Received: from sca-ea-mail-3.sun.com ([192.18.43.21]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KRG00LVMC13BW40@brm-avmta-1.central.sun.com>; Tue, 13 Oct 2009 06:00:40 -0600 (MDT) Received: from relay14i.sun.com (ip124.net129179-4.block1.us.syntegra.com [129.179.4.124]) by sca-ea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n9DBvor8006217; Tue, 13 Oct 2009 12:00:39 +0000 (GMT) Received: from mmp14es.mmp.us.syntegra.com ([160.41.208.14] [160.41.208.14]) by relay14i.sun.com with ESMTP id BT-MMP-774425; Tue, 13 Oct 2009 11:58:39 +0000 (Z) Received: from relay14i.sun.com (relay14i.sun.com [129.179.4.124]) by mmp14es.mmp.us.syntegra.com with ESMTP id BT-MMP-277425; Tue, 13 Oct 2009 11:58:38 +0000 (Z) Received: from carlson.workingcode.com ([75.150.68.97] [75.150.68.97]) by relay1i.sun.com with ESMTP id BT-MMP-28972817; Tue, 13 Oct 2009 11:58:38 +0000 (Z) Received: from [10.50.24.188] (gate.abinitio.com [65.170.40.132]) (authenticated bits=0) by carlson.workingcode.com (8.14.2+Sun/8.14.3) with ESMTP id n9DBwbZm001395 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 13 Oct 2009 07:58:37 -0400 (EDT) Date: Tue, 13 Oct 2009 07:58:37 -0400 From: James Carlson Subject: Re: door_xcreate - extended door creation interface for private doors [PSARC/2009/554 FastTrack timeout 10/20/2009] In-reply-to: <200910130921.n9D9LPM2022366@sac.sfbay.sun.com> To: Darren J Moffat Cc: PSARC-ext@sun.com, gavin.maltby@sun.com Message-id: <4AD46B6D.20708@workingcode.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-DCC-dmv.com-Metrics: carlson 1181; Body=3 Fuz1=3 Fuz2=3 References: <200910130921.n9D9LPM2022366@sac.sfbay.sun.com> User-Agent: Thunderbird 2.0.0.22 (X11/20090605) Status: RO Content-Length: 785 Darren J Moffat wrote: o This interface allows the appointment of a door server thread > creation function on a per-door basis, something that > is not possible with the existing door_create(3C) and > door_server_create(3C) interfaces. This facility is the > primary reason for the introduction of this interface - without > it the use of door servers in general-purpose system libraries > is problematic since the thread creation function is shared > with the application which may itself offer a door server. This hints at it, but could you provide a more concrete usage case? I assume there's a consumer waiting for this, and details about the usage may be interesting. -- James Carlson 42.703N 71.076W From Gavin.Maltby@SUN.COM Tue Oct 13 06:04:33 2009 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n9DD4Wju026862 for ; Tue, 13 Oct 2009 06:04:32 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n9DD4TBq037174 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Tue, 13 Oct 2009 07:04:31 -0600 (MDT) 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 <0KRG00E0VEZH5200@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 13 Oct 2009 06:04:29 -0700 (PDT) Received: from gmp-eb-inf-1.sun.com ([192.18.6.21]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KRG00CMEEZCDZ10@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 13 Oct 2009 06:04:27 -0700 (PDT) Received: from fe-emea-09.sun.com (gmp-eb-lb-1-fe1.eu.sun.com [192.18.6.7] (may be forged)) by gmp-eb-inf-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n9DD4NTZ021366 for ; Tue, 13 Oct 2009 13:04:24 +0000 (GMT) Received: from conversion-daemon.fe-emea-09.sun.com by fe-emea-09.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) id <0KRG00D00CXC8900@fe-emea-09.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 13 Oct 2009 14:04:15 +0100 (BST) Received: from [192.168.254.86] ([unknown] [59.167.188.156]) by fe-emea-09.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) with ESMTPSA id <0KRG005PHEYNR0D0@fe-emea-09.sun.com>; Tue, 13 Oct 2009 14:04:02 +0100 (BST) Date: Wed, 14 Oct 2009 00:05:20 +1100 From: Gavin Maltby Subject: Re: door_xcreate - extended door creation interface for private doors [PSARC/2009/554 FastTrack timeout 10/20/2009] In-reply-to: <4AD46B6D.20708@workingcode.com> Sender: Gavin.Maltby@SUN.COM To: James Carlson Cc: Darren J Moffat , PSARC-ext@SUN.COM Message-id: <4AD47B10.40301@sun.com> MIME-version: 1.0 Content-type: text/plain; CHARSET=US-ASCII; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200910130921.n9D9LPM2022366@sac.sfbay.sun.com> <4AD46B6D.20708@workingcode.com> User-Agent: Thunderbird 2.0.0.22 (X11/20090909) Status: RO Content-Length: 1965 James Carlson wrote: > Darren J Moffat wrote: > o This interface allows the appointment of a door server thread >> creation function on a per-door basis, something that >> is not possible with the existing door_create(3C) and >> door_server_create(3C) interfaces. This facility is the >> primary reason for the introduction of this interface - without >> it the use of door servers in general-purpose system libraries >> is problematic since the thread creation function is shared >> with the application which may itself offer a door server. > > This hints at it, but could you provide a more concrete usage case? I > assume there's a consumer waiting for this, and details about the usage > may be interesting. The first consumer will be an addition the the GPEC (general-purpose event channels) interface: sysevent_evc_xsubscribe will use door_xcreate to allow full control over the delivery threads that GPEC uses in event callbacks. That ARC case will be along soon. The extended subscription interface sysevent_evc_xsubscribe will be used in a new Committed interface libfmevent which will allow a process to subscribe to FMA protocol events (of which there will be some new ones soon that describe things like SMF state transitions). This libfmevent interface will be usable directly, and also via scripting language bindings (e.g., a Perl script can subscribe to events). In both cases we do not have control over what other doors usage there may be in the process that is using libfmevent - so we cannot use the global door_server_create(3C) interface etc. Fishworks has also has problems with the global nature of door_server_create. In that case, being an appliance, they do have control over the exact context and so with some hackery were able to workaround this restriction (and a few others in the doors API). The door_xcreate interface has been designed to be of use in eliminating that hackery, too. Gavin From carlsonj@workingcode.com Tue Oct 13 06:45:55 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 n9DDjtf2027491 for ; Tue, 13 Oct 2009 06:45:55 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n9DDjrE0017872; Tue, 13 Oct 2009 14:45:54 +0100 (BST) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KRG00I07GWHOT00@brm-avmta-1.central.sun.com>; Tue, 13 Oct 2009 07:45:53 -0600 (MDT) Received: from sca-ea-mail-3.sun.com ([192.18.43.21]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KRG00L5DGWGBAC0@brm-avmta-1.central.sun.com>; Tue, 13 Oct 2009 07:45:52 -0600 (MDT) Received: from relay11i.sun.com (ip121.net129179-4.block1.us.syntegra.com [129.179.4.121]) by sca-ea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n9DDaCp8000996; Tue, 13 Oct 2009 13:45:52 +0000 (GMT) Received: from mmp13es.mmp.us.syntegra.com ([160.41.208.13] [160.41.208.13]) by relay11i.sun.com with ESMTP id BT-MMP-3979448; Tue, 13 Oct 2009 13:45:52 +0000 (Z) Received: from relay11i.sun.com (relay11i.sun.com [129.179.4.121]) by mmp13es.mmp.us.syntegra.com with ESMTP id BT-MMP-87736; Tue, 13 Oct 2009 13:45:51 +0000 (Z) Received: from carlson.workingcode.com ([75.150.68.97] [75.150.68.97]) by relay1i.sun.com with ESMTP id BT-MMP-9378060; Tue, 13 Oct 2009 13:45:51 +0000 (Z) Received: from [10.50.24.188] (gate.abinitio.com [65.170.40.132]) (authenticated bits=0) by carlson.workingcode.com (8.14.2+Sun/8.14.3) with ESMTP id n9DDjokd017530 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 13 Oct 2009 09:45:50 -0400 (EDT) Date: Tue, 13 Oct 2009 09:45:50 -0400 From: James Carlson Subject: Re: door_xcreate - extended door creation interface for private doors [PSARC/2009/554 FastTrack timeout 10/20/2009] In-reply-to: <4AD47B10.40301@sun.com> To: Gavin Maltby Cc: Darren J Moffat , PSARC-ext@sun.com Message-id: <4AD4848E.8060702@workingcode.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-DCC-dmv.com-Metrics: carlson 1181; Body=3 Fuz1=3 Fuz2=3 References: <200910130921.n9D9LPM2022366@sac.sfbay.sun.com> <4AD46B6D.20708@workingcode.com> <4AD47B10.40301@sun.com> User-Agent: Thunderbird 2.0.0.22 (X11/20090605) Status: RO Content-Length: 1543 Gavin Maltby wrote: > The first consumer will be an addition the the GPEC (general-purpose event > channels) interface: sysevent_evc_xsubscribe will use door_xcreate > to allow full control over the delivery threads that GPEC uses in > event callbacks. That ARC case will be along soon. The extended > subscription interface sysevent_evc_xsubscribe will be used in a new > Committed interface libfmevent which will allow a process to subscribe > to FMA protocol events (of which there will be some new ones soon that > describe things like SMF state transitions). This libfmevent interface > will be usable directly, and also via scripting language bindings > (e.g., a Perl script can subscribe to events). In both cases we do not > have control over what other doors usage there may be in the process > that is using libfmevent - so we cannot use the global > door_server_create(3C) > interface etc. Thanks; that's what I was looking for. > Fishworks has also has problems with the global nature of > door_server_create. > In that case, being an appliance, they do have control over the exact > context > and so with some hackery were able to workaround this restriction (and a > few > others in the doors API). The door_xcreate interface has been designed to > be of use in eliminating that hackery, too. Well ... with Fishworks not described in the open ARC, that's probably out of scope here. (Though good to know it's generally useful for others ...) -- James Carlson 42.703N 71.076W From Sebastien.Roy@sun.com Wed Oct 21 08:06:12 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 n9LF6BP3028723 for ; Wed, 21 Oct 2009 08:06:11 -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.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id n9LF68Z0002651 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 21 Oct 2009 08:06:11 -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 <0KRV00109DYBE900@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.COM); Wed, 21 Oct 2009 08:06:11 -0700 (PDT) Received: from brmea-mail-1.sun.com ([192.18.98.31]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KRV00DIDDYBCBE0@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.COM); Wed, 21 Oct 2009 08:06:11 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n9LF6B7Y027458 for ; Wed, 21 Oct 2009 15:06:11 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) id <0KRV00300C85OK00@mail-amer.sun.com> for PSARC-ext@Sun.COM (ORCPT PSARC-ext@Sun.COM); Wed, 21 Oct 2009 09:06:11 -0600 (MDT) Received: from [129.148.174.103] ([unknown] [129.148.174.103]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) with ESMTPSA id <0KRV001ZQDY0UT80@mail-amer.sun.com>; Wed, 21 Oct 2009 09:06:01 -0600 (MDT) Date: Wed, 21 Oct 2009 11:03:34 -0400 From: Sebastien Roy Subject: Re: door_xcreate - extended door creation interface for private doors [PSARC/2009/554 FastTrack timeout 10/20/2009] In-reply-to: <200910130921.n9D9LPM2022366@sac.sfbay.sun.com> Sender: Sebastien.Roy@sun.com To: Darren J Moffat Cc: PSARC-ext@sun.com Message-id: <1256137414.13241.49.camel@strat> Organization: Sun Microsystems MIME-version: 1.0 Content-type: text/plain; CHARSET=US-ASCII Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200910130921.n9D9LPM2022366@sac.sfbay.sun.com> Status: RO Content-Length: 403 On Tue, 2009-10-13 at 02:21 -0700, Darren J Moffat wrote: > 4. Technical Description: > 4.1. Details: > > A new member is added to the doors API - door_xcreate, > dedicated to the creation of private (as in a having a > dedicated pool of server threads) doors. This case > seeks Micro/Patch binding (additional libraries that depend > on this interface will require that binding). +1 -Seb