From sacadmin Tue Apr 28 14:04:05 2009
Received: from zion.sfbay.sun.com (zion.SFBay.Sun.COM [129.146.17.75])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n3SL45js014914;
	Tue, 28 Apr 2009 14:04:05 -0700 (PDT)
Received: from zion.sfbay.sun.com (localhost [127.0.0.1])
	by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id n3SL454P005719;
	Tue, 28 Apr 2009 21:04:05 GMT
Received: (from mws@localhost)
	by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id n3SL45NL005715;
	Tue, 28 Apr 2009 14:04:05 -0700 (PDT)
Date: Tue, 28 Apr 2009 14:04:05 -0700 (PDT)
From: Michael Shapiro <mws@zion.sfbay.sun.com>
Message-Id: <200904282104.n3SL45NL005715@zion.sfbay.sun.com>
To: PSARC-record@sac.sfbay.sun.com
Subject: fmdump -m [PSARC/2009/265 FastTrack timeout 04/28/2009]
Status: RO
Content-Length: 550


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:
	 fmdump -m
    1.2. Name of Document Author/Supplier:
	 Author:  Robert Johnston
    1.3  Date of This Document:
	28 April, 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:
		OS/Net
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open


From mws@zion.sfbay.sun.com Tue Apr 28 14:09:34 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 n3SL9YDe015055
	for <psarc-ext@sac.sfbay.sun.com>; Tue, 28 Apr 2009 14:09:34 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n3SL9RNf024561;
	Tue, 28 Apr 2009 15:09:33 -0600 (MDT)
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 <0KIT00C01XFVOP00@brm-avmta-1.central.sun.com>; Tue,
 28 Apr 2009 15:09:31 -0600 (MDT)
Received: from zion.sfbay.sun.com ([129.146.17.75])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KIT00AZHXFU4U10@brm-avmta-1.central.sun.com>; Tue,
 28 Apr 2009 15:09:31 -0600 (MDT)
Received: from zion.sfbay.sun.com (localhost [127.0.0.1])
	by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id n3SL9U9n005837; Tue,
 28 Apr 2009 21:09:30 +0000 (GMT)
Received: (from mws@localhost)	by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit)
 id n3SL9UbR005836; Tue, 28 Apr 2009 14:09:30 -0700 (PDT)
Date: Tue, 28 Apr 2009 14:09:29 -0700 (PDT)
From: Michael Shapiro <mws@zion.sfbay.sun.com>
Subject: PSARC 2009/265 fmdump -m
To: PSARC-ext@sun.com
Cc: mws@sun.com, robert.johnston@sun.com
Message-id: <200904282109.n3SL9UbR005836@zion.sfbay.sun.com>
MIME-version: 1.0
X-Mailer: ELM [version 2.4ME+ PL31H (25)]
Content-type: text/plain; charset=US-ASCII
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 2146


I am sponsoring the following case for Rob Johnston to add a -m
option to fmdump to permit administrators to retrieve the human-readable
message for a fault entry from an FMA log.

This interface extension should be considered Stable and have binding
for a Micro release, should we ever wish to put it into an update.

As this is a straightforward, consistent, and trivial extension to an
existing utility, and has the full concensus of the FMA team,
I am filing this fasttrack as closed-approved-automatic.

If anyone has any questions, please use the alias.

-Mike

---8<---

1. Introduction
    1.1. Project/Component Working Name:
	 New -m option for fmdump(1m)
    1.2. Name of Document Author/Supplier:
	 Author:  Rob Johnston
    1.3  Date of This Document:
	 16 April, 2009
4. Technical Description

   4.1. Project Description:
	This project extends fmdump(1m) with a new command-line option (-m)
        which will print the localized diagnosis message associated with each
	entry in the Fault Manager's fault log (/var/fm/fmd/fltlog).

	This project enhances the usability of fmdump by providing an
	additional, more intuitive view of the data in the fault log.
	The localized message emitted by fmdump will be identical in
	format and content to the original message that appeared on
	the console and in syslog when the event occurred.

   4.2. Details:
	See draft man page change and example output in the case directory.

   4.3. Bug/RFE Number(s):
	6810965 port fmdump -m to ON
    
   4.4. Interfaces:
	The command-line options and human-readable output for fmdump(1m) are
        evolving.
    
   4.5. Doc Impact:
	This project will require a small update to the fmdump(1M) man page
	per the following CR:

	6829745 Need to document new -m option for fmdump

	A copy of the fmdump(1m) man page with the proposed updates is
	included in the case directory.

    
6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		ON
    6.5. ARC review type: Automatic
    6.6. ARC Exposure: open


-- 
Mike Shapiro, Sun Microsystems Open Storage / Fishworks. blogs.sun.com/mws/

From gww@eng.sun.com Tue Apr 28 14:30:56 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 n3SLUuBS015604
	for <psarc-ext@sac.sfbay.sun.com>; Tue, 28 Apr 2009 14:30:56 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n3SLUlDK023577;
	Tue, 28 Apr 2009 14:30:55 -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 <0KIT00E0VYFJT600@brm-avmta-1.central.sun.com>; Tue,
 28 Apr 2009 15:30:55 -0600 (MDT)
Received: from dm-eng-02.sfbay.sun.com ([129.146.11.32])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KIT00A9RYFH4Z30@brm-avmta-1.central.sun.com>; Tue,
 28 Apr 2009 15:30:54 -0600 (MDT)
Received: from marduk.eng.sun.com (marduk.SFBay.Sun.COM [129.146.108.224])
	by dm-eng-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2)
 with ESMTP id n3SLUrtM031152; Tue, 28 Apr 2009 14:30:53 -0700 (PDT)
Received: from marduk.eng.sun.com (localhost [127.0.0.1])
	by marduk.eng.sun.com (8.13.6+Sun/8.12.11) with ESMTP id n3SLU9Zv013212; Tue,
 28 Apr 2009 14:30:09 -0700 (PDT)
Received: (from gww@localhost)
	by marduk.eng.sun.com (8.13.6+Sun/8.12.11/Submit) id n3SLU8ll013211; Tue,
 28 Apr 2009 14:30:09 -0700 (PDT)
Date: Tue, 28 Apr 2009 14:30:09 -0700 (PDT)
From: Gary Winiger <gww@eng.sun.com>
Subject: Re: PSARC 2009/265 fmdump -m
To: PSARC-ext@sun.com, mws@zion.sfbay.sun.com
Cc: mws@sun.com, robert.johnston@sun.com
Message-id: <200904282130.n3SLU8ll013211@marduk.eng.sun.com>
Content-transfer-encoding: 7BIT
X-Sun-Charset: US-ASCII
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 585

> I am sponsoring the following case for Rob Johnston to add a -m
> option to fmdump to permit administrators to retrieve the human-readable
> message for a fault entry from an FMA log.

>    4.4. Interfaces:
> 	The command-line options and human-readable output for fmdump(1m) are
>         evolving.

	Nit.  Evolving is old speak.  In new speak it would be Committed.
	Do you really what to say the human-readable output is a Committed
	programming interface.  Perhaps command line option is Committed
	and human-readable output is Not-An-Interface (also part of new speak).

Gary..

From Robert.Johnston@Sun.COM Tue Apr 28 15:34: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 n3SMY6Br017469
	for <psarc-ext@sac.sfbay.sun.com>; Tue, 28 Apr 2009 15:34:06 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n3SMY2So021401
	for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Tue, 28 Apr 2009 15:34:06 -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 <0KIU000131CTB900@nwk-avmta-1.sfbay.Sun.COM> for psarc-ext@sun.com
 (ORCPT psarc-ext@sun.com); Tue, 28 Apr 2009 15:34:05 -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 <0KIU00IHJ1CSIV60@nwk-avmta-1.sfbay.Sun.COM> for
 psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Tue,
 28 Apr 2009 15:34:05 -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 n3SMY4kI022291	for
 <psarc-ext@sun.com>; Tue, 28 Apr 2009 22:34:04 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-5.01 64bit (built Feb 19 2009))
 id <0KIT00H00Y6CDM00@mail-amer.sun.com> for psarc-ext@sun.com
 (ORCPT psarc-ext@sun.com); Tue, 28 Apr 2009 16:34:04 -0600 (MDT)
Received: from [129.146.226.55] ([unknown] [129.146.226.55])
 by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-5.01 64bit (built Feb 19 2009))
 with ESMTPSA id <0KIU00H6E1CO0P10@mail-amer.sun.com>; Tue,
 28 Apr 2009 16:34:00 -0600 (MDT)
Date: Tue, 28 Apr 2009 15:33:50 -0700
From: Rob Johnston <Robert.Johnston@Sun.COM>
Subject: Re: PSARC 2009/265 fmdump -m
In-reply-to: <200904282130.n3SLU8ll013211@marduk.eng.sun.com>
Sender: Robert.Johnston@Sun.COM
To: Gary Winiger <gww@eng.sun.com>
Cc: psarc-ext@Sun.COM, mws@zion.sfbay.sun.com, Robert.Johnston@Sun.COM
Message-id: <49F7844E.40804@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
References: <200904282130.n3SLU8ll013211@marduk.eng.sun.com>
User-Agent: Thunderbird 2.0.0.21 (X11/20090323)
Status: RO
Content-Length: 688

Gary Winiger wrote:
>> I am sponsoring the following case for Rob Johnston to add a -m
>> option to fmdump to permit administrators to retrieve the human-readable
>> message for a fault entry from an FMA log.
> 
>>    4.4. Interfaces:
>> 	The command-line options and human-readable output for fmdump(1m) are
>>         evolving.
> 
> 	Nit.  Evolving is old speak.  In new speak it would be Committed.

Ok.

> 	Do you really what to say the human-readable output is a Committed
> 	programming interface.

No - definitely not :)

> Perhaps command line option is Committed
> 	and human-readable output is Not-An-Interface (also part of new speak).

Yes, that sounds better.

thanks,

rob


