From sacadmin Thu May 28 11:30:24 2009 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 n4SIUOG9008197; Thu, 28 May 2009 11:30:24 -0700 (PDT) Received: (from jb25718@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id n4SIUOee008193; Thu, 28 May 2009 11:30:24 -0700 (PDT) Date: Thu, 28 May 2009 11:30:24 -0700 (PDT) From: Jordan Brown Message-Id: <200905281830.n4SIUOee008193@sac.sfbay.sun.com> To: PSARC-record@sac.sfbay.sun.com Cc: Robert.Thurlow@sun.com Subject: rpcgen error reporting [PSARC/2009/323 FastTrack timeout 06/04/2009] Status: RO Content-Length: 554 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: rpcgen error reporting 1.2. Name of Document Author/Supplier: Author: Jordan Brown 1.3 Date of This Document: 28 May, 2009 4. Technical Description 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 Jordan.Brown@sun.com Thu May 28 11:35:44 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 n4SIZil6008363 for ; Thu, 28 May 2009 11:35:44 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n4SIZhdn002073 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Thu, 28 May 2009 11:35:44 -0700 (PDT) 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 <0KKD00C0JABKF300@brm-avmta-1.central.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Thu, 28 May 2009 12:35:44 -0600 (MDT) Received: from sca-es-mail-1.sun.com ([192.18.43.132]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KKD00FBGABJTNE0@brm-avmta-1.central.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Thu, 28 May 2009 12:35:43 -0600 (MDT) 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 n4SIZhm8016521 for ; Thu, 28 May 2009 11:35:43 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KKD00800A0QWA00@fe-sfbay-10.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Thu, 28 May 2009 11:35:43 -0700 (PDT) Received: from [129.145.155.47] ([unknown] [129.145.155.47]) by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KKD00DPFAB103E0@fe-sfbay-10.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Thu, 28 May 2009 11:35:25 -0700 (PDT) Date: Thu, 28 May 2009 11:35:25 -0700 From: Jordan Brown Subject: 2009/323 - rpcgen error reporting Sender: Jordan.Brown@sun.com To: psarc-ext@sun.com Message-id: <4A1ED96D.4010103@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 User-Agent: Thunderbird 2.0.0.14 (X11/20080505) Status: RO Content-Length: 2891 I am sponsoring the following for fast track approval. The timer expires Thursday 4 June 2009. PSARC 2009/323 - rpcgen error reporting Name: rpcgen error reporting Submitter: Jordan Brown Owner: Jordan Brown Interest: Robert.Thurlow@sun.com Status: waiting fast-track 06/04/2009 Exposure: open SUMMARY Adds a mechanism to allow an application using rpcgen-created server code to control how errors are reported. BACKGROUND rpcgen's generated service code (*_svc.c) includes a function _msgout that it calls to report errors it encounters. The application is provided only limited and ill-documented ways to control the operation of this function; it either calls syslog() or writes to standard error. PROBLEM If the developer wants more control over error reporting it is necessary to statically create the file, edit it to replace _msgout, and check in the resulting file. This creates an ongoing maintenance headache, since changes to the *.x file must be hand-merged into this file. PROPOSAL Define a public interface allowing the developer to intercept message output, by allowing the use of a compile-time macro to specify an alternate routine. DETAILS If the *_svc.c file is compiled with a macro RPC_MSGOUT defined, perhaps using a compiler option like -DRPC_MSGOUT=mymsgfunc, the value specified will be used as the name of a printf-like function to be called with any errors to be reported. That function must conform to the signature extern void RPC_MSGOUT(const char *fmt, ...); COMMENTS The existing _msgout function takes a single argument, a message to be printed. If we're making this a public interface, it seems to make sense to provide for future expansion, which is why this case proposes to define the function as a printf-like function. Current error reporting behavior is formally undefined. The suggested manual page text below slightly defines it, by specifying that standard error and/or the system log are used, but avoids specifying how that decision is made. DELIVERY VEHICLE Solaris RELEASE Patch COMMITMENT LEVEL Committed TESTIMONIALS Rob Thurlow has reviewed this proposal and endorses it. MANUAL PAGE Add to the manual page text along the lines of: SERVER ERROR REPORTING By default, errors detected by proto_svc.c will be reported to standard error and/or the system log. This behavior can be overridden by compiling the file with a definition of RPC_MSGOUT, e.g. -DRPC_MSGOUT=mymsgfunc. The function specified will be called to report errors. It must conform to this printf-like signature: extern void RPC_MSGOUT(const char *fmt, ...); From carlsonj@phorcys.east.sun.com Thu May 28 11:43:41 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 n4SIherW008538 for ; Thu, 28 May 2009 11:43:40 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n4SIhSvU000386 for <@sunmail2sca.sfbay.sun.com:psarc-ext@Sun.COM>; Thu, 28 May 2009 19:43:39 +0100 (BST) 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 <0KKD00K0DAOQGU00@nwk-avmta-2.sfbay.sun.com> for psarc-ext@Sun.COM (ORCPT psarc-ext@Sun.COM); Thu, 28 May 2009 11:43:38 -0700 (PDT) Received: from dm-east-01.east.sun.com ([129.148.9.192]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KKD00HOTAOP6S30@nwk-avmta-2.sfbay.sun.com> for psarc-ext@Sun.COM (ORCPT psarc-ext@Sun.COM); Thu, 28 May 2009 11:43:37 -0700 (PDT) Received: from phorcys.east.sun.com (phorcys.East.Sun.COM [129.148.174.143]) by dm-east-01.east.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n4SIhajC038683; Thu, 28 May 2009 14:43:36 -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 n4SIgWwG025709; Thu, 28 May 2009 14:42:32 -0400 (EDT) Received: (from carlsonj@localhost) by phorcys.east.sun.com (8.14.3+Sun/8.14.3/Submit) id n4SIgW2q025706; Thu, 28 May 2009 14:42:32 -0400 (EDT) Date: Thu, 28 May 2009 14:42:32 -0400 From: James Carlson Subject: Re: 2009/323 - rpcgen error reporting In-reply-to: <4A1ED96D.4010103@sun.com> To: Jordan Brown Cc: psarc-ext@sun.com Message-id: <18974.56088.444970.415469@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: <4A1ED96D.4010103@sun.com> Status: RO Content-Length: 392 Jordan Brown writes: > TESTIMONIALS > > Rob Thurlow has reviewed this proposal and endorses it. ;-} I'm pretty sure I reviewed that one, too, and liked it. +1 -- 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 Jordan.Brown@Sun.COM Wed Jun 3 10:06:57 2009 Received: from dm-sfbay-02.sfbay.sun.com (dm-sfbay-02.SFBay.Sun.COM [129.146.11.31]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n53H6vgN013358 for ; Wed, 3 Jun 2009 10:06:57 -0700 (PDT) Received: from sca-es-mail-2.sun.com (sca-es-mail-2.Sun.COM [192.18.43.133]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n53H6vau051971 for ; Wed, 3 Jun 2009 10:06:57 -0700 (PDT) Received: from fe-sfbay-09.sun.com ([192.18.43.129]) by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n53H6pW2004518 for ; Wed, 3 Jun 2009 10:06:52 -0700 (PDT) MIME-version: 1.0 Content-transfer-encoding: 7BIT Content-type: text/plain; CHARSET=US-ASCII; format=flowed Received: from conversion-daemon.fe-sfbay-09.sun.com by fe-sfbay-09.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KKO00H00A1O4700@fe-sfbay-09.sun.com> for PSARC-ext@sac.sfbay.sun.com; Wed, 03 Jun 2009 10:06:51 -0700 (PDT) Received: from [129.145.155.47] ([unknown] [129.145.155.47]) by fe-sfbay-09.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KKO009Y3A7F4M30@fe-sfbay-09.sun.com> for PSARC-ext@sac.sfbay.sun.com; Wed, 03 Jun 2009 10:06:51 -0700 (PDT) Date: Wed, 03 Jun 2009 10:06:51 -0700 From: Jordan Brown Subject: 2009/323 rpcgen error reporting - approved Sender: Jordan.Brown@Sun.COM To: PSARC-ext@sac.sfbay.sun.com Message-id: <4A26ADAB.7000507@sun.com> User-Agent: Thunderbird 2.0.0.14 (X11/20080505) Status: RO Content-Length: 43 This case was approved at today's meeting.