From sacadmin Tue Sep 23 17:26:34 2008 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 m8O0QYXq022502; Tue, 23 Sep 2008 17:26:34 -0700 (PDT) Received: (from cindi@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m8O0QY6g022498; Tue, 23 Sep 2008 17:26:34 -0700 (PDT) Date: Tue, 23 Sep 2008 17:26:34 -0700 (PDT) From: Cynthia McGuire Message-Id: <200809240026.m8O0QY6g022498@sac.sfbay.sun.com> To: PSARC-record@sac.sfbay.sun.com Cc: fma-core@sun.com, psarc-ext@sun.com, tarik.soydan@sun.com, vuong.nguyen@sun.com Subject: Extensions to fmd for LDOMs IO [PSARC/2008/605 FastTrack timeout 09/26/2008] Status: RO Content-Length: 987 This case seeks a patch binding. A shortened timer was requested to accomodate schedule demands. If any ARC member requires more time, please let us know. Cindi This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: Extensions to fmd for LDOMs IO 1.2. Name of Document Author/Supplier: Author: Tarik Soydan 1.3 Date of This Document: 23 September, 2008 4. Technical Description fmd interfaces -------------- Exported Interface Stability ----------------------------- ----------- fmd_xprt_log() Consolidation Private fmd_hdl_checkpoint() Consolidation Private See the case directory for more detail 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 cindi@sac.sfbay.sun.com Tue Sep 23 17:26:36 2008 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 m8O0Qadv022509 for ; Tue, 23 Sep 2008 17:26:36 -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 m8O0QagI020794; Tue, 23 Sep 2008 17:26:36 -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 <0K7O00A01BWC1W00@nwk-avmta-1.sfbay.Sun.COM>; Tue, 23 Sep 2008 17:26:36 -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 <0K7O0080BBWCI140@nwk-avmta-1.sfbay.Sun.COM>; Tue, 23 Sep 2008 17:26:36 -0700 (PDT) Received: from sac.sfbay.sun.com (new-sac.SFBay.Sun.COM [129.146.175.65]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m8O0QZDU041836; Tue, 23 Sep 2008 17:26:35 -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 m8O0QYXq022502; Tue, 23 Sep 2008 17:26:34 -0700 (PDT) Received: (from cindi@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m8O0QY6g022498; Tue, 23 Sep 2008 17:26:34 -0700 (PDT) Date: Tue, 23 Sep 2008 17:26:34 -0700 (PDT) From: Cynthia McGuire Subject: Extensions to fmd for LDOMs IO [PSARC/2008/605 FastTrack timeout 09/26/2008] To: PSARC-record@sac.sfbay.sun.com Cc: fma-core@sun.com, psarc-ext@sun.com, tarik.soydan@sun.com, vuong.nguyen@sun.com Message-id: <200809240026.m8O0QY6g022498@sac.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 987 This case seeks a patch binding. A shortened timer was requested to accomodate schedule demands. If any ARC member requires more time, please let us know. Cindi This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: Extensions to fmd for LDOMs IO 1.2. Name of Document Author/Supplier: Author: Tarik Soydan 1.3 Date of This Document: 23 September, 2008 4. Technical Description fmd interfaces -------------- Exported Interface Stability ----------------------------- ----------- fmd_xprt_log() Consolidation Private fmd_hdl_checkpoint() Consolidation Private See the case directory for more detail 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 Richard.Matthews@sun.com Tue Oct 7 16:50:56 2008 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 m97Nougg014370 for ; Tue, 7 Oct 2008 16:50:56 -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 m97NouLC013272; Tue, 7 Oct 2008 16:50:56 -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 <0K8E008177KS3900@nwk-avmta-1.sfbay.Sun.COM>; Tue, 07 Oct 2008 16:50:52 -0700 (PDT) Received: from brmea-mail-2.sun.com ([192.18.98.43]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K8E0002H7KR1730@nwk-avmta-1.sfbay.Sun.COM>; Tue, 07 Oct 2008 16:50:52 -0700 (PDT) Received: from fe-amer-09.sun.com ([192.18.109.79]) by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m97Nop60014129; Tue, 07 Oct 2008 23:50:51 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K8E003017DNFU00@mail-amer.sun.com> (original mail from Richard.Matthews@Sun.COM); Tue, 07 Oct 2008 17:50:51 -0600 (MDT) Received: from [129.152.9.14] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K8E00M1B7KPM3A0@mail-amer.sun.com>; Tue, 07 Oct 2008 17:50:50 -0600 (MDT) Date: Tue, 07 Oct 2008 18:50:49 -0500 From: Rick Matthews Subject: PSARC/2008/605 - Extensions to fmd for LDOMs IO Sender: Richard.Matthews@sun.com To: PSARC@sun.com, psarc-ext@sun.com Reply-to: Richard.Matthews@sun.com Message-id: <48EBF5D9.6080707@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 User-Agent: Thunderbird 2.0.0.14 (X11/20080505) Status: RO Content-Length: 547 +1 nit: Section 1. para 4, "event is invalid" rather than "event is ivalid"? -- --------------------------------------------------------------------- Rick Matthews email: Rick.Matthews@sun.com Sun Microsystems, Inc. phone:+1(651) 554-1518 1270 Eagan Industrial Road phone(internal): 54418 Suite 160 fax: +1(651) 554-1540 Eagan, MN 55121-1231 USA main: +1(651) 554-1500 --------------------------------------------------------------------- From sacadmin Tue Oct 7 16:50:56 2008 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 m97NouMW014372 for ; Tue, 7 Oct 2008 16:50:56 -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 m97NouLC013272; Tue, 7 Oct 2008 16:50:56 -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 <0K8E008177KS3900@nwk-avmta-1.sfbay.Sun.COM>; Tue, 07 Oct 2008 16:50:52 -0700 (PDT) Received: from brmea-mail-2.sun.com ([192.18.98.43]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K8E0002H7KR1730@nwk-avmta-1.sfbay.Sun.COM>; Tue, 07 Oct 2008 16:50:52 -0700 (PDT) Received: from fe-amer-09.sun.com ([192.18.109.79]) by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m97Nop60014129; Tue, 07 Oct 2008 23:50:51 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K8E003017DNFU00@mail-amer.sun.com> (original mail from Richard.Matthews@Sun.COM); Tue, 07 Oct 2008 17:50:51 -0600 (MDT) Received: from [129.152.9.14] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K8E00M1B7KPM3A0@mail-amer.sun.com>; Tue, 07 Oct 2008 17:50:50 -0600 (MDT) Date: Tue, 07 Oct 2008 18:50:49 -0500 From: Rick Matthews Subject: PSARC/2008/605 - Extensions to fmd for LDOMs IO Sender: Richard.Matthews@sun.com To: PSARC@sun.com, psarc-ext@sun.com Reply-to: Richard.Matthews@sun.com Message-id: <48EBF5D9.6080707@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 User-Agent: Thunderbird 2.0.0.14 (X11/20080505) Status: RO Content-Length: 547 +1 nit: Section 1. para 4, "event is invalid" rather than "event is ivalid"? -- --------------------------------------------------------------------- Rick Matthews email: Rick.Matthews@sun.com Sun Microsystems, Inc. phone:+1(651) 554-1518 1270 Eagan Industrial Road phone(internal): 54418 Suite 160 fax: +1(651) 554-1540 Eagan, MN 55121-1231 USA main: +1(651) 554-1500 --------------------------------------------------------------------- From Tarik.Soydan@Sun.COM Tue Oct 7 17:07:49 2008 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 m9807mSh015628 for ; Tue, 7 Oct 2008 17:07:48 -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 m9807bR4015987; Wed, 8 Oct 2008 01:07:47 +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 <0K8E009038CXZH00@nwk-avmta-1.sfbay.Sun.COM>; Tue, 07 Oct 2008 17:07:45 -0700 (PDT) Received: from brmea-mail-1.sun.com ([192.18.98.31]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K8E000HY8CX1F50@nwk-avmta-1.sfbay.Sun.COM>; Tue, 07 Oct 2008 17:07:45 -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 m9807jiW001401; Wed, 08 Oct 2008 00:07:45 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K8E001018462A00@mail-amer.sun.com> (original mail from Tarik.Soydan@Sun.COM); Tue, 07 Oct 2008 18:07:45 -0600 (MDT) Received: from [129.148.181.81] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K8E002PF8CS5P90@mail-amer.sun.com>; Tue, 07 Oct 2008 18:07:41 -0600 (MDT) Date: Tue, 07 Oct 2008 20:15:48 -0400 From: Tarik Soydan - Sun BOS Software Subject: Re: PSARC/2008/605 - Extensions to fmd for LDOMs IO In-reply-to: <48EBF5D9.6080707@Sun.COM> Sender: Tarik.Soydan@Sun.COM To: Richard.Matthews@Sun.COM Cc: PSARC@Sun.COM, psarc-ext@Sun.COM Message-id: <48EBFBB4.9010300@sun.com> MIME-version: 1.0 Content-type: multipart/mixed; boundary="Boundary_(ID_Y8g4fj4fWxCJ8HEEO8O/wA)" X-PMX-Version: 5.4.1.325704 References: <48EBF5D9.6080707@Sun.COM> User-Agent: Thunderbird 2.0.0.14 (X11/20080505) Status: RO Content-Length: 3073 This is a multi-part message in MIME format. --Boundary_(ID_Y8g4fj4fWxCJ8HEEO8O/wA) Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT Here is an updated version of fmd_api.txt. In addition to fixing the typo, it changes the API name from fmd_hdl_checkpoint() to fmd_thr_checkpoint() as requested by Mike Shapiro. -tarik On 10/07/08 19:50, Rick Matthews wrote: > +1 > > nit: Section 1. para 4, "event is invalid" rather than "event is ivalid"? > --Boundary_(ID_Y8g4fj4fWxCJ8HEEO8O/wA) Content-type: text/plain; name=fmd_api.txt Content-transfer-encoding: 7BIT Content-disposition: inline; filename=fmd_api.txt # # fmd_api.txt 1.2 08/10/02 # ############ Introduction ############ This document describes new FMD APIs introduced by the LDOMs IO FMA project. These interfaces were needed by the event transport in order to improve RAS. An API was needed to save ereports in the error log without also posting them to the FMD event queue. This allows ereports destined for a root domain to be saved in the control domain's error log. This way there would be a log of all ereports coming from the SP and we would have a record of them in case they could not be delivered to the root domain. An API was needed to checkpoint module data on demand. This allows event transport queues to be saved as new events come in from the SP. The existing mechanism where FMD saves checkpoint buffers on event delivery to a module was not sufficient since these events do not come from FMD. ############### API Description ############### 1. New interface to log ereports without also dispatching them. void fmd_xprt_log(fmd_hdl_t *hdl, fmd_xprt_t *xp, nvlist_t *nvl, hrtime_t hrt) This interface is similar to the existing fmd_xprt_post() interface, but only logs the event to the ereport log if it is an ereport, and does not post it to the fault manager dispatch queue. Log the newly received event for transport "xp" whose payload is specified by the name-value pair list "nvl" to the error log if it is of the class "ereport.*". The fault manager assumes responsibility for deallocating "nvl" when it has completed the logging operation. If the event is invalid (i.e. not an ereport), the fault manager will automatically discard the event and update the transport statistics appropriately. If the transport has some mechanism to determine a high-resolution time at which the event was originally queued for the transport, this time can be specified as the "hrt" parameter; otherwise zero should be specified. See the FMD PRM for more verbiage on this. 2. New interface for a module to request a checkpoint. void fmd_thr_checkpoint(fmd_hdl_t *hdl) Request the fault manager to save a checkpoint for the module associated with the handle "hdl". This interface may only be called from an FMD auxiliary thread. If it is called by some other thread it will cause a module abort. Refer to the FMD PRM section 7 for more info on checkpointing. --Boundary_(ID_Y8g4fj4fWxCJ8HEEO8O/wA)-- From sacadmin Tue Oct 7 17:07:50 2008 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 m9807nXJ015632 for ; Tue, 7 Oct 2008 17:07:50 -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 m9807bR4015987; Wed, 8 Oct 2008 01:07:47 +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 <0K8E009038CXZH00@nwk-avmta-1.sfbay.Sun.COM>; Tue, 07 Oct 2008 17:07:45 -0700 (PDT) Received: from brmea-mail-1.sun.com ([192.18.98.31]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K8E000HY8CX1F50@nwk-avmta-1.sfbay.Sun.COM>; Tue, 07 Oct 2008 17:07:45 -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 m9807jiW001401; Wed, 08 Oct 2008 00:07:45 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K8E001018462A00@mail-amer.sun.com> (original mail from Tarik.Soydan@Sun.COM); Tue, 07 Oct 2008 18:07:45 -0600 (MDT) Received: from [129.148.181.81] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K8E002PF8CS5P90@mail-amer.sun.com>; Tue, 07 Oct 2008 18:07:41 -0600 (MDT) Date: Tue, 07 Oct 2008 20:15:48 -0400 From: Tarik Soydan - Sun BOS Software Subject: Re: PSARC/2008/605 - Extensions to fmd for LDOMs IO In-reply-to: <48EBF5D9.6080707@Sun.COM> Sender: Tarik.Soydan@Sun.COM To: Richard.Matthews@Sun.COM Cc: PSARC@Sun.COM, psarc-ext@Sun.COM Message-id: <48EBFBB4.9010300@sun.com> MIME-version: 1.0 Content-type: multipart/mixed; boundary="Boundary_(ID_Y8g4fj4fWxCJ8HEEO8O/wA)" X-PMX-Version: 5.4.1.325704 References: <48EBF5D9.6080707@Sun.COM> User-Agent: Thunderbird 2.0.0.14 (X11/20080505) Status: RO Content-Length: 3073 This is a multi-part message in MIME format. --Boundary_(ID_Y8g4fj4fWxCJ8HEEO8O/wA) Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT Here is an updated version of fmd_api.txt. In addition to fixing the typo, it changes the API name from fmd_hdl_checkpoint() to fmd_thr_checkpoint() as requested by Mike Shapiro. -tarik On 10/07/08 19:50, Rick Matthews wrote: > +1 > > nit: Section 1. para 4, "event is invalid" rather than "event is ivalid"? > --Boundary_(ID_Y8g4fj4fWxCJ8HEEO8O/wA) Content-type: text/plain; name=fmd_api.txt Content-transfer-encoding: 7BIT Content-disposition: inline; filename=fmd_api.txt # # fmd_api.txt 1.2 08/10/02 # ############ Introduction ############ This document describes new FMD APIs introduced by the LDOMs IO FMA project. These interfaces were needed by the event transport in order to improve RAS. An API was needed to save ereports in the error log without also posting them to the FMD event queue. This allows ereports destined for a root domain to be saved in the control domain's error log. This way there would be a log of all ereports coming from the SP and we would have a record of them in case they could not be delivered to the root domain. An API was needed to checkpoint module data on demand. This allows event transport queues to be saved as new events come in from the SP. The existing mechanism where FMD saves checkpoint buffers on event delivery to a module was not sufficient since these events do not come from FMD. ############### API Description ############### 1. New interface to log ereports without also dispatching them. void fmd_xprt_log(fmd_hdl_t *hdl, fmd_xprt_t *xp, nvlist_t *nvl, hrtime_t hrt) This interface is similar to the existing fmd_xprt_post() interface, but only logs the event to the ereport log if it is an ereport, and does not post it to the fault manager dispatch queue. Log the newly received event for transport "xp" whose payload is specified by the name-value pair list "nvl" to the error log if it is of the class "ereport.*". The fault manager assumes responsibility for deallocating "nvl" when it has completed the logging operation. If the event is invalid (i.e. not an ereport), the fault manager will automatically discard the event and update the transport statistics appropriately. If the transport has some mechanism to determine a high-resolution time at which the event was originally queued for the transport, this time can be specified as the "hrt" parameter; otherwise zero should be specified. See the FMD PRM for more verbiage on this. 2. New interface for a module to request a checkpoint. void fmd_thr_checkpoint(fmd_hdl_t *hdl) Request the fault manager to save a checkpoint for the module associated with the handle "hdl". This interface may only be called from an FMD auxiliary thread. If it is called by some other thread it will cause a module abort. Refer to the FMD PRM section 7 for more info on checkpointing. --Boundary_(ID_Y8g4fj4fWxCJ8HEEO8O/wA)-- From cindi@sun.com Thu Oct 9 09:39:16 2008 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 m99GdGmq011302 for ; Thu, 9 Oct 2008 09:39:16 -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 m99Gd1MY044594; Thu, 9 Oct 2008 10:39:11 -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 <0K8H00M3DCX9SI00@nwk-avmta-1.sfbay.Sun.COM>; Thu, 09 Oct 2008 09:39:09 -0700 (PDT) Received: from sca-ea-mail-1.sun.com ([192.18.43.24]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K8H00CH9CX50C80@nwk-avmta-1.sfbay.Sun.COM>; Thu, 09 Oct 2008 09:39:05 -0700 (PDT) Received: from relay16i.sun.com (ip126.net129179-4.block1.us.syntegra.com [129.179.4.126]) by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m99Gcrhl004903; Thu, 09 Oct 2008 16:39:05 +0000 (GMT) Received: from mmp13es.mmp.us.syntegra.com ([160.41.208.13] [160.41.208.13]) by relay16i.sun.com with ESMTP id BT-MMP-333396; Thu, 09 Oct 2008 16:39:05 +0000 (Z) Received: from relay13i.sun.com (relay13i.sun.com [129.179.4.123]) by mmp13es.mmp.us.syntegra.com with ESMTP id BT-MMP-145004; Thu, 09 Oct 2008 16:39:05 +0000 (Z) Received: from ozz.sf.fishpong.com ([198.144.208.55] [198.144.208.55]) by relay1i.sun.com with ESMTP id BT-MMP-7307355; Thu, 09 Oct 2008 16:39:04 +0000 (Z) Received: from [127.0.0.1] (localhost [127.0.0.1]) by ozz.sf.fishpong.com (8.14.2+Sun/8.14.2) with ESMTP id m99GcpWm220241; Thu, 09 Oct 2008 09:38:51 -0700 (PDT) Date: Thu, 09 Oct 2008 09:38:51 -0700 From: Cynthia McGuire Subject: Extensions to fmd for LDOMs IO [PSARC/2008/605 FastTrack timeout 09/26/2008] To: psarc-ext@sun.com Cc: fma-core@sun.com, Tarik Soydan - Sun BOS Software , Vuong Nguyen Message-id: <48EE339B.2070900@sun.com> MIME-version: 1.0 Content-type: multipart/mixed; boundary="Boundary_(ID_cDobkCE7/09oENh6rjc2qw)" X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-Antispam: No, score=0.0/5.0, scanned in 0.073sec at (localhost [127.0.0.1]) by smf-spamd v1.3.1 - http://smfs.sf.net/ User-Agent: Thunderbird 2.0.0.9 (X11/20080213) Status: RO Content-Length: 2885 This is a multi-part message in MIME format. --Boundary_(ID_cDobkCE7/09oENh6rjc2qw) Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT Based on comments recieved, the project team is updating the API specification (attached). The case is now approved. Cindi --Boundary_(ID_cDobkCE7/09oENh6rjc2qw) Content-type: text/plain; name=fmd_api.txt Content-transfer-encoding: 7BIT Content-disposition: inline; filename=fmd_api.txt # # fmd_api.txt 1.2 08/10/02 # ############ Introduction ############ This document describes new FMD APIs introduced by the LDOMs IO FMA project. These interfaces were needed by the event transport in order to improve RAS. An API was needed to save ereports in the error log without also posting them to the FMD event queue. This allows ereports destined for a root domain to be saved in the control domain's error log. This way there would be a log of all ereports coming from the SP and we would have a record of them in case they could not be delivered to the root domain. An API was needed to checkpoint module data on demand. This allows event transport queues to be saved as new events come in from the SP. The existing mechanism where FMD saves checkpoint buffers on event delivery to a module was not sufficient since these events do not come from FMD. ############### API Description ############### 1. New interface to log ereports without also dispatching them. void fmd_xprt_log(fmd_hdl_t *hdl, fmd_xprt_t *xp, nvlist_t *nvl, hrtime_t hrt) This interface is similar to the existing fmd_xprt_post() interface, but only logs the event to the ereport log if it is an ereport, and does not post it to the fault manager dispatch queue. Log the newly received event for transport "xp" whose payload is specified by the name-value pair list "nvl" to the error log if it is of the class "ereport.*". The fault manager assumes responsibility for deallocating "nvl" when it has completed the logging operation. If the event is invalid (i.e. not an ereport), the fault manager will automatically discard the event and update the transport statistics appropriately. If the transport has some mechanism to determine a high-resolution time at which the event was originally queued for the transport, this time can be specified as the "hrt" parameter; otherwise zero should be specified. See the FMD PRM for more verbiage on this. 2. New interface for a module to request a checkpoint. void fmd_thr_checkpoint(fmd_hdl_t *hdl) Request the fault manager to save a checkpoint for the module associated with the handle "hdl". This interface may only be called from an FMD auxiliary thread. If it is called by some other thread it will cause a module abort. Refer to the FMD PRM section 7 for more info on checkpointing. --Boundary_(ID_cDobkCE7/09oENh6rjc2qw)--