From Sebastien.Roy@sun.com Thu Feb 12 07:32:48 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 n1CFWmMW026112
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 12 Feb 2009 07:32:48 -0800 (PST)
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.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1CFWe3t018941
	for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Thu, 12 Feb 2009 07:32:48 -0800 (PST)
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 <0KEY00K9FLUMGA00@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com
 (ORCPT psarc-ext@sun.com); Thu, 12 Feb 2009 07:32:46 -0800 (PST)
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 <0KEY00JMCLUDY410@nwk-avmta-2.sfbay.sun.com> for
 psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Thu,
 12 Feb 2009 07:32:38 -0800 (PST)
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 n1CFWblk015950	for
 <psarc-ext@sun.com>; Thu, 12 Feb 2009 15:32:37 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 id <0KEY00100L1UQH00@mail-amer.sun.com> for psarc-ext@sun.com
 (ORCPT psarc-ext@sun.com); Thu, 12 Feb 2009 08:32:37 -0700 (MST)
Received: from [129.148.174.103] ([unknown] [129.148.174.103])
 by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 with ESMTPSA id <0KEY00163LU9QI60@mail-amer.sun.com> for psarc-ext@sun.com
 (ORCPT psarc-ext@sun.com); Thu, 12 Feb 2009 08:32:33 -0700 (MST)
Date: Thu, 12 Feb 2009 10:32:19 -0500
From: Sebastien Roy <Sebastien.Roy@sun.com>
Subject: PSARC 2009/099 dladm show-usage modifications
Sender: Sebastien.Roy@sun.com
To: psarc-ext <psarc-ext@sun.com>
Cc: Cathy Zhou <Cathy.Zhou@sun.com>
Message-id: <1234452739.21527.6.camel@strat>
Organization: Sun Microsystems
MIME-version: 1.0
X-Mailer: Evolution 2.24.2
Content-type: text/plain; charset=UTF-8
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 2253

This self-review case which I'm submitting on behalf of Cathy Zhou is
closed approved automatic due to its trivial nature, but as with other
such cases, it will be upgraded to a fast-track if need be.

Updated dladm(1M) and flowadm(1M) man pages are in the materials
directory.

Overview
========

    This case is to correct several inconsistencies of the show-usage
    subcommand between the current implementation and the man page which
    was proposed in PSARC/2006/357, for both dladm(1M) and flowadm(1M)
    commands. Further, an additional '-a' option will be added.

Details
=======

  - Manpage inconsistencies 

  1. Remove the '-t' option

     The usage records are always in chronological order, so '-t' is not
     necessary.

  2. Remove the '-p' option

     The usage information will be printed out to stdout. Further, since
     the '-F' option will be used to specify the output format, '-p' is
     redundant and therefore is removed. 

  3. Use the '-F' option to specify the output format

     Specifying the format of the network usage data output. The only
     argument it currently takes is "gnuplot", which means the format
     will be suitable for input to gnuplot.

  4. Add the '-d' option

      Display the dates of the records in the usage data.

  - The new '-a' option

    Today, the default behavior of the "dladm show-usage" and "flowadm
    show-usage" subcommands is to show the historical usage information,
    including the usage information for the flows and links that have
    already been deleted.  This could easily causes confusion since the
    default behavior of all other dladm and flowadm subcommands is
    showing information only for the existing set of links and flows on
    the current system.

    At the same time, historical information could be useful especially
    for auditing purposes. Therefore, we propose to add an additional '-a'
    option for both "dladm show-usage" and "flowadm show-usage" subcommands
    and all historical usage information will still be showed if '-a' is
    specified.  The default behavior will be only to show the usage
    information for the existing links and flows.

References
==========

    [1] dladm(1M) manpage
    [2] flowadm(1M) manpage


From carlsonj@phorcys.east.sun.com Thu Feb 12 07:56:14 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 n1CFuErf027111
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 12 Feb 2009 07:56:14 -0800 (PST)
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 n1CFu98A064956;
	Thu, 12 Feb 2009 08:56:10 -0700 (MST)
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 <0KEY00L1BMXLNR00@nwk-avmta-2.sfbay.sun.com>; Thu,
 12 Feb 2009 07:56:09 -0800 (PST)
Received: from phorcys.east.sun.com ([129.148.174.143])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KEY00J33MXJYA40@nwk-avmta-2.sfbay.sun.com>; Thu,
 12 Feb 2009 07:56:07 -0800 (PST)
Received: from phorcys.east.sun.com (localhost [127.0.0.1])
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n1CFu6Kr007726; Thu,
 12 Feb 2009 10:56:06 -0500 (EST)
Received: (from carlsonj@localhost)
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3/Submit) id n1CFu6bb007723; Thu,
 12 Feb 2009 10:56:06 -0500 (EST)
Date: Thu, 12 Feb 2009 10:56:06 -0500
From: James Carlson <james.d.carlson@sun.com>
Subject: Re: PSARC 2009/099 dladm show-usage modifications
In-reply-to: <1234452739.21527.6.camel@strat>
To: Sebastien Roy <Sebastien.Roy@sun.com>
Cc: psarc-ext <psarc-ext@sun.com>, Cathy Zhou <Cathy.Zhou@sun.com>
Message-id: <18836.18070.256645.541760@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: <1234452739.21527.6.camel@strat>
Status: RO
Content-Length: 471

Sebastien Roy writes:
> This self-review case which I'm submitting on behalf of Cathy Zhou is
> closed approved automatic due to its trivial nature, but as with other
> such cases, it will be upgraded to a fast-track if need be.

Good to see.

+1

-- 
James Carlson, Solaris Networking              <james.d.carlson@sun.com>
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

