From cindi@sac.sfbay.sun.com Mon Aug 13 11:04:06 2007 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 l7DI45m3019173 for ; Mon, 13 Aug 2007 11:04:06 -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 l7DI1TSJ038759; Mon, 13 Aug 2007 12:01:29 -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 <0JMQ00I214QP0300@brm-avmta-1.central.sun.com>; Mon, 13 Aug 2007 12:01:37 -0600 (MDT) Received: from sfbaymail2sca.sfbay.sun.com ([129.145.155.42]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMQ0059F4QNXLC0@brm-avmta-1.central.sun.com>; Mon, 13 Aug 2007 12:01:36 -0600 (MDT) Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132]) by sfbaymail2sca.sfbay.sun.com (8.13.6+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id l7DI1YF0026758; Mon, 13 Aug 2007 11:01:34 -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 l7DI3xgj019168; Mon, 13 Aug 2007 11:03:59 -0700 (PDT) Received: (from cindi@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id l7DI3xsY019164; Mon, 13 Aug 2007 11:03:59 -0700 (PDT) Date: Mon, 13 Aug 2007 11:03:59 -0700 (PDT) From: Cynthia McGuire Subject: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] To: PSARC-ext@Sun.Com Cc: adrian.frost@Sun.Com Message-id: <200708131803.l7DI3xsY019164@sac.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 Status: RO Content-Length: 1398 I am sponsoring the following case on behalf of Adrian Frost. This case extends the display output of fmadm faulty to provide more customer and field service relevant information regarding faulty components. A standard one week timer is set. Cindi This information is Copyright 2007 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: fmadm faulty command new output and arguments 1.2. Name of Document Author/Supplier: Author: Adrian Frost 1.3 Date of This Document: 13 August, 2007 4. Technical Description 4.1. Project Description: Improve the output of the fmadm faulty command so it is more friendly to user. With the new command output you should not need to go to the message file or use the fmdump command in order to understand faults. Add new flags to control output of fmadm faulty command. 4.2. Details: see draft man page change and examples of output in case directory 4.3. Bug/RFE Number(s): 6484879 4.4. Interfaces: fmadm command-line options are Evolving, human-readable output is Unstable. 4.5. Doc Impact: new man page fmadm(1M). Opportunity to improve FMA messages to use fmadm faulty instead of fmdump 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 gww@eng.sun.com Mon Aug 13 14:04:35 2007 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 l7DL4Z1a023688 for ; Mon, 13 Aug 2007 14:04:35 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l7DL20HP025928 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 13 Aug 2007 15:02:00 -0600 (MDT) 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 <0JMQ00H07D3NIS00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon, 13 Aug 2007 14:02:11 -0700 (PDT) Received: from engmail3mpk.sfbay.Sun.COM ([129.146.11.26]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMQ009G8D3MUDE0@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon, 13 Aug 2007 14:02:10 -0700 (PDT) Received: from marduk.eng.sun.com (marduk.SFBay.Sun.COM [129.146.108.224]) by engmail3mpk.sfbay.Sun.COM (8.13.6+Sun/8.13.6/ENSMAIL,v2.2) with ESMTP id l7DL29Nu028079; Mon, 13 Aug 2007 14:02:09 -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 l7DL6Hlv017183; Mon, 13 Aug 2007 14:06:17 -0700 (PDT) Received: (from gww@localhost) by marduk.eng.sun.com (8.13.6+Sun/8.12.11/Submit) id l7DL6H7a017182; Mon, 13 Aug 2007 14:06:17 -0700 (PDT) Date: Mon, 13 Aug 2007 14:06:17 -0700 (PDT) From: Gary Winiger Subject: Re: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] To: PSARC-ext@sun.com, cindi@sac.sfbay.sun.com Cc: adrian.frost@sun.com Message-id: <200708132106.l7DL6H7a017182@marduk.eng.sun.com> Content-transfer-encoding: 7BIT X-Sun-Charset: US-ASCII X-PMX-Version: 5.2.0.264296 Status: RO Content-Length: 170 > 4.4. Interfaces: > fmadm command-line options are Evolving, human-readable output is > Unstable. Hummm, how about Committed and Not-an-Interface respectively? From cindi@sun.com Mon Aug 13 18:44:52 2007 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 l7E1ipaO029718 for ; Mon, 13 Aug 2007 18:44:52 -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.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l7E1gP6c026052; Tue, 14 Aug 2007 02:42:26 +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 <0JMQ00M0XQ2NFI00@brm-avmta-1.central.sun.com>; Mon, 13 Aug 2007 19:42:23 -0600 (MDT) Received: from jurassic.eng.sun.com ([129.146.56.36]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMQ009DFQ2MTS80@brm-avmta-1.central.sun.com>; Mon, 13 Aug 2007 19:42:22 -0600 (MDT) Received: from [10.7.251.200] (punchin-cindi.SFBay.Sun.COM [10.7.251.200]) by jurassic.eng.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l7E1eXPj119246; Mon, 13 Aug 2007 18:40:33 -0700 (PDT) Date: Mon, 13 Aug 2007 18:42:11 -0700 From: cindi Subject: Re: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] In-reply-to: <200708132106.l7DL6H7a017182@marduk.eng.sun.com> To: Gary Winiger Cc: PSARC-ext@sun.com, cindi@sac.sfbay.sun.com, adrian.frost@sun.com Message-id: <46C10873.9090306@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200708132106.l7DL6H7a017182@marduk.eng.sun.com> User-Agent: Thunderbird 1.5.0.12 (Macintosh/20070509) Status: RO Content-Length: 212 sure. Cindi Gary Winiger wrote: >> 4.4. Interfaces: >> fmadm command-line options are Evolving, human-readable output is >> Unstable. > > Hummm, how about Committed and Not-an-Interface respectively? From jek3@sun.com Mon Aug 13 19:16:00 2007 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 l7E2G0WD000310 for ; Mon, 13 Aug 2007 19:16:00 -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 l7E2DMYe034635; Mon, 13 Aug 2007 20:13:23 -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 <0JMQ00A05RILB900@nwk-avmta-1.sfbay.Sun.COM>; Mon, 13 Aug 2007 19:13:33 -0700 (PDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.59]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMQ00AOSRIKMAE0@nwk-avmta-1.sfbay.Sun.COM>; Mon, 13 Aug 2007 19:13:32 -0700 (PDT) Received: from [129.150.12.124] (vpn-129-150-12-124.SFBay.Sun.COM [129.150.12.124]) by jurassic-x4600.sfbay.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l7E2DS4p531579; Mon, 13 Aug 2007 19:13:29 -0700 (PDT) Date: Mon, 13 Aug 2007 16:10:38 -1000 From: Joseph Kowalski Subject: Re: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] In-reply-to: <200708132106.l7DL6H7a017182@marduk.eng.sun.com> To: Gary Winiger Cc: PSARC-ext@sun.com, cindi@sac.sfbay.sun.com, adrian.frost@sun.com Message-id: <46C10F1E.1050902@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200708132106.l7DL6H7a017182@marduk.eng.sun.com> User-Agent: Thunderbird 1.5.0.5 (X11/20060925) Status: RO Content-Length: 291 Gary Winiger wrote: >> 4.4. Interfaces: >> fmadm command-line options are Evolving, human-readable output is >> Unstable. >> > > Hummm, how about Committed and Not-an-Interface respectively? > Not clear... Maybe they intended this to be Unstable/Uncommitted. Guys? - jek3 From cindi@sun.com Mon Aug 13 20:05:39 2007 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 l7E35djE002017 for ; Mon, 13 Aug 2007 20:05:39 -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 l7E33BfD024973; Mon, 13 Aug 2007 20:03:13 -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 <0JMQ0040HTTCJO00@brm-avmta-1.central.sun.com>; Mon, 13 Aug 2007 21:03:12 -0600 (MDT) Received: from jurassic.eng.sun.com ([129.146.226.130]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMQ0096QTTBTZB0@brm-avmta-1.central.sun.com>; Mon, 13 Aug 2007 21:03:12 -0600 (MDT) Received: from [10.7.251.200] (punchin-cindi.SFBay.Sun.COM [10.7.251.200]) by jurassic.eng.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l7E337Dk122077; Mon, 13 Aug 2007 20:03:07 -0700 (PDT) Date: Mon, 13 Aug 2007 20:04:45 -0700 From: cindi Subject: Re: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] In-reply-to: <46C10F1E.1050902@sun.com> To: Joseph Kowalski Cc: Gary Winiger , PSARC-ext@sun.com, cindi@sac.sfbay.sun.com, adrian.frost@sun.com Message-id: <46C11BCD.5030800@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200708132106.l7DL6H7a017182@marduk.eng.sun.com> <46C10F1E.1050902@sun.com> User-Agent: Thunderbird 1.5.0.12 (Macintosh/20070509) Status: RO Content-Length: 1194 From the original case for the fault manager, the command line options for fmdadm(1M) were classified as evolving and the output, unstable. It seems straightforward to map evolving to committed for the command line options. What is not so clear is the commitment level of the output. The new interface taxonomy suggests that such output is not an interface at all and should be classified as 'Not-an-interface': "In the course of reviewing or documenting interfaces, the situation often occurs that an attribute will be present which may be inferred to be an interface, but actually is not. A couple of common examples of this are output from CLIs intended only for human consumption and the exact layout of a GUI." The project team is happy to adjust the classification level to what is appropriate and customary. Please advise. Cindi Joseph Kowalski wrote: > Gary Winiger wrote: >>> 4.4. Interfaces: >>> fmadm command-line options are Evolving, human-readable output is >>> Unstable. >>> >> >> Hummm, how about Committed and Not-an-Interface respectively? >> > Not clear... Maybe they intended this to be Unstable/Uncommitted. Guys? > > - jek3 > From jek3@sun.com Mon Aug 13 20:45:46 2007 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 l7E3jjiF002267 for ; Mon, 13 Aug 2007 20:45:45 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail4.Singapore.Sun.COM (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id l7E3hDWX007780; Tue, 14 Aug 2007 11:43:16 +0800 (SGT) 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 <0JMQ0060HVO2ZF00@brm-avmta-1.central.sun.com>; Mon, 13 Aug 2007 21:43:14 -0600 (MDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMQ009K3VO1TRB0@brm-avmta-1.central.sun.com>; Mon, 13 Aug 2007 21:43:13 -0600 (MDT) Received: from [129.150.12.124] (vpn-129-150-12-124.SFBay.Sun.COM [129.150.12.124]) by jurassic-x4600.sfbay.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l7E3hAMI539509; Mon, 13 Aug 2007 20:43:11 -0700 (PDT) Date: Mon, 13 Aug 2007 17:40:21 -1000 From: Joseph Kowalski Subject: Re: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] In-reply-to: <46C11BCD.5030800@sun.com> To: cindi Cc: Gary Winiger , PSARC-ext@sun.com, cindi@sac.sfbay.sun.com, adrian.frost@sun.com Message-id: <46C12425.1030100@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200708132106.l7DL6H7a017182@marduk.eng.sun.com> <46C10F1E.1050902@sun.com> <46C11BCD.5030800@sun.com> User-Agent: Thunderbird 1.5.0.5 (X11/20060925) Status: RO Content-Length: 1490 cindi wrote: > From the original case for the fault manager, the command line options > for fmdadm(1M) were classified as evolving and the output, unstable. > It seems straightforward to map evolving to committed for the command > line options. What is not so clear is the commitment level of the > output. The new interface taxonomy suggests that such output is not an > interface at all and should be classified as 'Not-an-interface': > > "In the course of reviewing or documenting interfaces, the situation > often occurs that an attribute will be present which may be inferred > to be an interface, but actually is not. A couple of common examples > of this are output from CLIs intended only for human consumption and > the exact layout of a GUI." > > The project team is happy to adjust the classification level to what > is appropriate and customary. Please advise. > > Cindi Not-an-interface is a bit strange. Its design point was to make clear things which people might mistake as being interfaces. Perhaps this taxonomy was a mistake, but it really doesn't matter. Make the output either Not-an-interface or Volatile. Then again, if the original case declared the output as Unstable, the new name would be Uncommitted (People felt that Unstable was pejorative.) That has the only allows change in a Minor release, like S11, as if that's going to ever happen. :-) Maybe there is a little clean-up with the old classifications. Probably not a big deal. - jek3 From carlsonj@phorcys.east.sun.com Tue Aug 14 05:01:29 2007 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 l7EC1TbM011974 for ; Tue, 14 Aug 2007 05:01:29 -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 l7EBx1hW013284; Tue, 14 Aug 2007 04:59:02 -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 <0JMR00G0VIMDTP00@brm-avmta-1.central.sun.com>; Tue, 14 Aug 2007 05:59:01 -0600 (MDT) Received: from phorcys.east.sun.com ([129.148.174.143]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMR00DV0IMCYH10@brm-avmta-1.central.sun.com>; Tue, 14 Aug 2007 05:59:00 -0600 (MDT) Received: from phorcys.east.sun.com (localhost [127.0.0.1]) by phorcys.east.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l7EBx0dS012449; Tue, 14 Aug 2007 07:59:00 -0400 (EDT) Received: (from carlsonj@localhost) by phorcys.east.sun.com (8.14.1+Sun/8.14.1/Submit) id l7EBx0BW012446; Tue, 14 Aug 2007 07:59:00 -0400 (EDT) Date: Tue, 14 Aug 2007 07:59:00 -0400 From: James Carlson Subject: Re: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] In-reply-to: <46C11BCD.5030800@sun.com> To: cindi Cc: Joseph Kowalski , Gary Winiger , PSARC-ext@sun.com, Adrian.Frost@sun.com Message-id: <18113.39172.203011.433376@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.2.0.264296 References: <200708132106.l7DL6H7a017182@marduk.eng.sun.com> <46C10F1E.1050902@sun.com> <46C11BCD.5030800@sun.com> Status: RO Content-Length: 1719 > The project team is happy to adjust the classification level to what is > appropriate and customary. Please advise. The issue here is with how the outputs are intended to be used, what users will expect from them, and what you can provide. Looking at the changes (a diff-marked man page would have been helpful here!), I believe this case adds the following flags: -f -g -p -r -s -v -n max -u uid It seems to _remove_ the -i flag, which was previously Evolving. That removal (if it's correct) needs an explicit EOF, which I don't see in this case. As for the output formats, there seem to be just three of them -- 'faulty', 'faulty -f', and 'faulty -r'. Of those, I can believe that the first two are "Not-An-Interface," as the output appears to contain a lot of ordinary English text that would be foolish for anyone to parse. 'faulty -r' seems different. It looks like a simple field-oriented output that could be parsed, and should probably be at least Uncommitted. The other new output formats don't seem to be documented at all. I can find no documentation for the -s or -v flag. My guess would be Uncommitted and Not-An-Interface, respectively, but I'm not sure. CR 6484879 also doesn't seem to have substantive information about what the project team is attempting to do. I'd like to see an update that explains what happened to the "-i" option I see in the current man page, and provides some details (at least a stability level) for the new output variations. -- James Carlson, Solaris Networking Sun Microsystems / 1 Network Drive 71.232W Vox +1 781 442 2084 MS UBUR02-212 / Burlington MA 01803-2757 42.496N Fax +1 781 442 1677 From gww@eng.sun.com Tue Aug 14 07:39:18 2007 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 l7EEdIet014578 for ; Tue, 14 Aug 2007 07:39:18 -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 l7EEaqk0002657; Tue, 14 Aug 2007 07:36:53 -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 <0JMR0020HPXFPK00@brm-avmta-1.central.sun.com>; Tue, 14 Aug 2007 08:36:51 -0600 (MDT) Received: from engmail3mpk.sfbay.Sun.COM ([129.146.11.26]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMR00D85PXEYM90@brm-avmta-1.central.sun.com>; Tue, 14 Aug 2007 08:36:50 -0600 (MDT) Received: from marduk.eng.sun.com (marduk.SFBay.Sun.COM [129.146.108.224]) by engmail3mpk.sfbay.Sun.COM (8.13.6+Sun/8.13.6/ENSMAIL,v2.2) with ESMTP id l7EEamER019922; Tue, 14 Aug 2007 07:36:48 -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 l7EEYd9O001869; Tue, 14 Aug 2007 07:34:39 -0700 (PDT) Received: (from gww@localhost) by marduk.eng.sun.com (8.13.6+Sun/8.12.11/Submit) id l7EEYdkC001868; Tue, 14 Aug 2007 07:34:39 -0700 (PDT) Date: Tue, 14 Aug 2007 07:34:39 -0700 (PDT) From: Gary Winiger Subject: Re: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] To: jek3@sun.com, cindi@sun.com Cc: gww@eng.sun.com, PSARC-ext@sun.com, cindi@sac.sfbay.sun.com, adrian.frost@sun.com Message-id: <200708141434.l7EEYdkC001868@marduk.eng.sun.com> Content-transfer-encoding: 7BIT X-Sun-Charset: US-ASCII X-PMX-Version: 5.2.0.264296 Status: RO Content-Length: 1095 > "In the course of reviewing or documenting interfaces, the situation > often occurs that an attribute will be present which may be inferred to > be an interface, but actually is not. A couple of common examples of > this are output from CLIs intended only for human consumption and the > exact layout of a GUI." > > The project team is happy to adjust the classification level to what is > appropriate and customary. Please advise. IMO, it depends. Do you wish to declare the output to be a programming interface? Or is the output meant as "human readable." If a programming interface, how about Uncommitted? If to be processed by humans, N-a-I. I read your initial posting as N-a-I. Gary.. > > Cindi > > Joseph Kowalski wrote: > > Gary Winiger wrote: > >>> 4.4. Interfaces: > >>> fmadm command-line options are Evolving, human-readable output is > >>> Unstable. > >>> > >> > >> Hummm, how about Committed and Not-an-Interface respectively? > >> > > Not clear... Maybe they intended this to be Unstable/Uncommitted. Guys? > > > > - jek3 > > > From Adrian.Frost@sun.com Tue Aug 14 08:29:25 2007 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 l7EFTPdu015891 for ; Tue, 14 Aug 2007 08:29:25 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l7EFQktc055157 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Tue, 14 Aug 2007 09:26:47 -0600 (MDT) 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 <0JMR00407S8ZYC00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 14 Aug 2007 08:26:59 -0700 (PDT) Received: from gmp-ea-fw-1.sun.com ([129.156.42.5]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMR00IT0S8YVHE0@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 14 Aug 2007 08:26:59 -0700 (PDT) Received: from d1-emea-09.sun.com (d1-emea-09.sun.com [192.18.2.119]) by gmp-ea-fw-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id l7EFQvBA004522 for ; Tue, 14 Aug 2007 15:26:57 +0000 (GMT) Received: from conversion-daemon.d1-emea-09.sun.com by d1-emea-09.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0JMR00101S7G4D00@d1-emea-09.sun.com> (original mail from Adrian.Frost@Sun.COM) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 14 Aug 2007 16:26:57 +0100 (BST) Received: from [129.156.173.21] by d1-emea-09.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0JMR00I46S8X9JUT@d1-emea-09.sun.com>; Tue, 14 Aug 2007 16:26:57 +0100 (BST) Date: Tue, 14 Aug 2007 16:26:57 +0100 From: Adrian Frost Subject: Re: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] In-reply-to: <200708141434.l7EEYdkC001868@marduk.eng.sun.com> Sender: Adrian.Frost@sun.com To: Gary Winiger Cc: jek3@sun.com, cindi@sun.com, PSARC-ext@sun.com, cindi@sac.sfbay.sun.com Message-id: <46C1C9C1.9090006@sun.com> Organization: Sun Microsystems MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200708141434.l7EEYdkC001868@marduk.eng.sun.com> User-Agent: Thunderbird 2.0.0.0 (X11/20070605) Status: RO Content-Length: 1292 Gary Winiger wrote: >> "In the course of reviewing or documenting interfaces, the situation >> often occurs that an attribute will be present which may be inferred to >> be an interface, but actually is not. A couple of common examples of >> this are output from CLIs intended only for human consumption and the >> exact layout of a GUI." >> >> The project team is happy to adjust the classification level to what is >> appropriate and customary. Please advise. >> > > IMO, it depends. Do you wish to declare the output to be > a programming interface? Or is the output meant as "human > readable." If a programming interface, how about Uncommitted? > If to be processed by humans, N-a-I. I read your initial posting > as N-a-I. > All of the interfaces are intended to be human readable and not programming interfaces. > Gary.. > >> Cindi >> >> Joseph Kowalski wrote: >> >>> Gary Winiger wrote: >>> >>>>> 4.4. Interfaces: >>>>> fmadm command-line options are Evolving, human-readable output is >>>>> Unstable. >>>>> >>>>> >>>> Hummm, how about Committed and Not-an-Interface respectively? >>>> >>>> >>> Not clear... Maybe they intended this to be Unstable/Uncommitted. Guys? >>> >>> - jek3 >>> >>> From cindi@sun.com Tue Aug 14 11:39:52 2007 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 l7EIdpJK021793 for ; Tue, 14 Aug 2007 11:39:51 -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 l7EIbNb8006143; Tue, 14 Aug 2007 11:37:25 -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 <0JMS0092X12CMT00@nwk-avmta-1.sfbay.Sun.COM>; Tue, 14 Aug 2007 11:37:24 -0700 (PDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JMS009G712AL900@nwk-avmta-1.sfbay.Sun.COM>; Tue, 14 Aug 2007 11:37:22 -0700 (PDT) Received: from [129.146.228.215] (ozz.SFBay.Sun.COM [129.146.228.215]) by jurassic-x4600.sfbay.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l7EIbMLj640524; Tue, 14 Aug 2007 11:37:22 -0700 (PDT) Date: Tue, 14 Aug 2007 13:39:18 -0700 From: Cynthia McGuire Subject: Re: fmadm faulty command new output and arguments [PSARC/2007/460 FastTrack timeout 08/20/2007] In-reply-to: <200708131803.l7DI3xsY019164@sac.sfbay.sun.com> To: Cynthia McGuire Cc: PSARC-ext@sun.com, adrian.frost@sun.com Message-id: <46C212F6.8060109@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200708131803.l7DI3xsY019164@sac.sfbay.sun.com> User-Agent: Thunderbird 1.5 (X11/20060113) Status: RO Content-Length: 2038 Please find an updated version of the fmadm(1M) man page in the case directory. The -i option to the faulty subcommand was inadvertently omitted and has now been restored. There is also a man page diff and sample output for the -s option. The output for the remaining options should be straightforward from the man page description. The requested stability level for the new fmadm faulty options is Committed and the stability level for all new output variations displayed by fmadm faulty is Uncommitted. Cindi Cynthia McGuire wrote: > I am sponsoring the following case on behalf of Adrian Frost. This case > extends the display output of fmadm faulty to provide more customer and > field service relevant information regarding faulty components. A standard > one week timer is set. > > Cindi > > > This information is Copyright 2007 Sun Microsystems > 1. Introduction > 1.1. Project/Component Working Name: > fmadm faulty command new output and arguments > 1.2. Name of Document Author/Supplier: > Author: Adrian Frost > 1.3 Date of This Document: > 13 August, 2007 > 4. Technical Description > > 4.1. Project Description: > Improve the output of the fmadm faulty command so it is more friendly to user. With the new command output you should not need to go to the > message file or use the fmdump command in order to understand faults. > Add new flags to control output of fmadm faulty command. > > 4.2. Details: > see draft man page change and examples of output in case directory > > 4.3. Bug/RFE Number(s): > 6484879 > > 4.4. Interfaces: > fmadm command-line options are Evolving, human-readable output is > Unstable. > > 4.5. Doc Impact: > new man page fmadm(1M). > > Opportunity to improve FMA messages to use fmadm faulty instead of > fmdump > > 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 sacadmin Tue Sep 25 10:11:03 2007 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 l8PHB3hr010298; Tue, 25 Sep 2007 10:11:03 -0700 (PDT) Received: (from cindi@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id l8PHB3wu010294; Tue, 25 Sep 2007 10:11:03 -0700 (PDT) Date: Tue, 25 Sep 2007 10:11:03 -0700 (PDT) From: Cynthia McGuire Message-Id: <200709251711.l8PHB3wu010294@sac.sfbay.sun.com> To: PSARC-record@sac.sfbay.sun.com Cc: Adrian.Frost@sun.com Subject: Binding specification for PSARC/2007/460 [PSARC/2007/556 FastTrack timeout 09/25/2007] Status: RO Content-Length: 533 I am sponsoring this case on behalf of Adrian Frost. The changes are straightforward and qualify for Architectural self-review, but the project team wishes to record the following information. The release binding specification for PSARC/2007/460 was inadvertently left out of the case materials. This case corrects the ommission by specifying a patch release binding for PSARC/2007/460. The project team also wishes to modify the stability level for fmadm(1M) output for fmdadm(1M) from uncommitted to not-an-interface. Cindi