From sacadmin Wed Apr  7 22:20:07 2010
Received: from localhost.sfbay.sun.com (denali.SFBay.Sun.COM [129.146.17.46])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o385K7P8001026;
	Wed, 7 Apr 2010 22:20:07 -0700 (PDT)
Received: from localhost.sfbay.sun.com (localhost [127.0.0.1] (may be forged))
	by localhost.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id o385K6JG025994;
	Wed, 7 Apr 2010 22:20:06 -0700 (PDT)
Received: (from ahrens@localhost)
	by localhost.sfbay.sun.com (8.14.3+Sun/8.14.3/Submit) id o385K6NW025990;
	Wed, 7 Apr 2010 22:20:06 -0700 (PDT)
Date: Wed, 7 Apr 2010 22:20:06 -0700 (PDT)
From: Matthew Ahrens <ahrens@sac.sfbay.sun.com>
Message-Id: <201004080520.o385K6NW025990@localhost.sfbay.sun.com>
To: PSARC@sac.sfbay.sun.com
Cc: zfs-eng@sun.com
Subject: zpool status/list interval and count [PSARC/2010/121 FastTrack timeout 04/21/2010]
Status: RO
Content-Length: 5392


Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
This information is Oracle Proprietary: Need-to-Know
1. Introduction
    1.1. Project/Component Working Name:
	 zpool status/list interval and count
    1.2. Name of Document Author/Supplier:
	 Author:  Lin Ling
    1.3  Date of This Document:
	07 April, 2010
4. Technical Description

1. Introduction
     1.1. Project/Component Working Name:
          Add interval and count to zpool status and zpool list
     1.2. Name of Document Author/Supplier:
          Author:  Lin Ling
     1.3  Date of This Document:
          7 April, 2010


4. Technical Description

	While resilver or scrub is in progress, it would be
	useful to have zpool status loop to monitor its progress.
	It would also come in handy to have zpool list loop to
	see the space allocation changes.

	To do so, we can add an 'interval' and a 'count' argument
	to zpool status and zpool list commands, just like
	zpool iostat.

	The 'interval' argument indicates how many seconds between
	two printed reports. The 'count' argument indicates how many
	reports to be printed.

	To match zpool iostat -T feature, also adding [-T d|u] option
	to zpool status and zpool list command.


Man page changes:

--- man.before	Mon Apr  5 15:15:03 2010
+++ man.after	Wed Apr  7 11:51:05 2010
@@ -51,10 +51,10 @@
           [-D] [-f] [-R root] [-F [-n]] pool |id [newpool]
 
-     zpool iostat [-T u | d ] [-v] [pool] ... [interval[count]]
+     zpool iostat [-T d|u ] [-v] [pool] ... [interval[ count]]
 
-     zpool list [-H] [-o property[,...]] [pool] ...
+     zpool list [-H] [-o property[,...]] [-T d|u] [pool] ... [interval [count]]
 
 
@@ -93,7 +93,7 @@
           newpool [device ...]
 
-     zpool status [-xv] [pool] ...
+     zpool status [-xv] [-T d|u] [pool] ... [interval [count]]
 
 
      zpool upgrade
@@ -1352,7 +1352,7 @@
 
-     zpool iostat [-T u | d] [-v] [pool] ... [interval[count]]
+     zpool iostat [-T d|u] [-v] [pool] ... [interval[count]]
 
          Displays I/O statistics for the given pools. When  given
          an  interval,  the statistics are printed every interval
@@ -1361,13 +1361,13 @@
          If count is specified, the  command  exits  after  count
          reports are printed.
 
-         -T u | d
+         -T d|u
 
              Display a time stamp.
 
-             Specify u for a printed representation of the inter-
-             nal  representation  of time. See time(2). Specify d
-             for standard date format. See date(1).
+             Specify d for standard date format. See date(1).
+	     Specify u for a printed representation of the inter-
+             nal  representation  of time. See time(2).
 
 
          -v
@@ -1391,12 +1391,16 @@
 
 
-     zpool list [-H] [-o props[,...]] [pool] ...
+     zpool list [-H] [-o props[,...]] [-T d|u] [pool] ... [interval [count]]
 
          Lists the given pools along with  a  health  status  and
          space  usage.  When given no arguments, all pools in the
          system are listed.
 
+         When given an interval, the status and space usage are printed
+	 every interval seconds until Ctrl-C is pressed. If count is specified,
+	 the command exits after count reports are printed.
+
          -H
 
              Scripted mode. Do not display headers, and  separate
@@ -1410,8 +1414,15 @@
              ties. The default list  is  name,  size,  allocated,
              free, capacity, health, altroot.
 
+	 -T d|u
 
+             Display a time stamp.
 
+             Specify d for standard date format. See date(1).
+	     Specify u for a printed representation of the inter-
+             nal  representation  of time. See time(2).
+
+
      zpool offline [-t] pool device ...
 
          Takes the specified physical device offline.  While  the
@@ -1611,7 +1622,7 @@
 
 
 
-     zpool status [-xv] [pool] ...
+     zpool status [-xv] [-T d|u] [pool] ... [interval [count]]
 
          Displays the detailed health status for the given pools.
          If no pool is specified, then the status of each pool in
@@ -1619,6 +1630,11 @@
          and device health, see the "Device Failure and Recovery"
          section.
 
+         When given an interval, the detail status for the given pools
+	 are printed every interval seconds until Ctrl-C is pressed.
+	 If count is specified, the command exits after count reports
+	 are printed.
+
          If a scrub or resilver  is  in  progress,  this  command
          reports  the  percentage  done and the estimated time to
          completion. Both of these are only approximate,  because
@@ -1637,8 +1653,15 @@
              out  a  complete  list  of all data errors since the
              last complete pool scrub.
 
+	 -T d|u
 
+             Display a time stamp.
 
+             Specify d for standard date format. See date(1).
+	     Specify u for a printed representation of the inter-
+             nal  representation  of time. See time(2).
+
+
      zpool upgrade
 

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


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: closed
        6.6.1. Rationale: ?

From sacadmin Thu Apr  8 02:15:24 2010
Received: from dm-sfbay-01.sfbay.sun.com (dm-sfbay-01.SFBay.Sun.COM [129.145.155.118])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o389FN9J022405;
	Thu, 8 Apr 2010 02:15:23 -0700 (PDT)
Received: from sca-ea-mail-1.sun.com (sca-ea-mail-1.Sun.COM [192.18.43.24])
	by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o389FNQ7029709;
	Thu, 8 Apr 2010 02:15:23 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o389FI77005524;
	Thu, 8 Apr 2010 09:15:18 GMT
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o386R9As018726;
	Thu, 8 Apr 2010 09:15:16 GMT
Received: from abhmt019.oracle.com by acsmt355.oracle.com
	with ESMTP id 157041541270718093; Thu, 08 Apr 2010 02:14:53 -0700
Received: from [10.7.251.221] (/10.7.251.221)
	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Thu, 08 Apr 2010 02:14:53 -0700
Message-ID: <4BBD9E8A.7010507@Oracle.COM>
Date: Thu, 08 Apr 2010 10:14:50 +0100
From: Darren J Moffat <Darren.Moffat@Oracle.COM>
Organization: Oracle Solaris Security
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.8) Gecko/20100315 Lightning/1.0b1 Thunderbird/3.0.3
MIME-Version: 1.0
To: Matthew Ahrens <ahrens@sac.sfbay.sun.com>
CC: PSARC@sac.sfbay.sun.com, zfs-eng@sun.com
Subject: Re: zpool status/list interval and count [PSARC/2010/121 FastTrack
 timeout 04/21/2010]
References: <201004080520.o385K6NW025990@localhost.sfbay.sun.com>
In-Reply-To: <201004080520.o385K6NW025990@localhost.sfbay.sun.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090208.4BBD9EA6.0051:SCFMA4539814,ss=1,fgs=0
Status: RO
Content-Length: 957

On 08/04/2010 06:20, Matthew Ahrens wrote:
> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
> This information is Oracle Proprietary: Need-to-Know
> 1. Introduction
>      1.1. Project/Component Working Name:
> 	 zpool status/list interval and count
>      1.2. Name of Document Author/Supplier:
> 	 Author:  Lin Ling
>      1.3  Date of This Document:
> 	07 April, 2010
> 4. Technical Description
>
> 1. Introduction
>       1.1. Project/Component Working Name:
>            Add interval and count to zpool status and zpool list
>       1.2. Name of Document Author/Supplier:
>            Author:  Lin Ling
>       1.3  Date of This Document:
>            7 April, 2010

This case is a very obvious extension of functionality already available 
in one zpool(1M) subcommand to others.  As such I would have been happy 
for it to be filed as closed-approved-automatic.  However since it is a 
FastTrack it gets my +1 as specified.

-- 
Darren J Moffat

From sacadmin Wed Apr 21 16:29:40 2010
Received: from dm-sfbay-01.sfbay.sun.com (dm-sfbay-01.SFBay.Sun.COM [129.145.155.118])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3LNTekh026079
	for <PSARC@sac.sfbay.sun.com>; Wed, 21 Apr 2010 16:29:40 -0700 (PDT)
Received: from brmea-mail-1.sun.com (brmea-mail-1.Sun.COM [192.18.98.31])
	by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3LNTdN0024615;
	Wed, 21 Apr 2010 16:29:39 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3LNTdNO021702;
	Wed, 21 Apr 2010 23:29:39 GMT
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o3LMJ5Ih006214;
	Wed, 21 Apr 2010 23:29:37 GMT
Received: from abhmt017.oracle.com by acsmt353.oracle.com
	with ESMTP id 179509251271892534; Wed, 21 Apr 2010 16:28:54 -0700
Received: from stationary.local (/10.7.251.178)
	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Wed, 21 Apr 2010 16:28:54 -0700
Message-ID: <4BCF8A34.9030706@oracle.com>
Date: Wed, 21 Apr 2010 16:28:52 -0700
From: Matthew Ahrens <matthew.ahrens@oracle.com>
User-Agent: Thunderbird 2.0.0.24 (Macintosh/20100228)
MIME-Version: 1.0
To: Matthew Ahrens <ahrens@dm-eng-01.sfbay.sun.com>
CC: PSARC@sac.sfbay.sun.com, zfs-eng@sun.com
Subject: Re: zpool status/list interval and count [PSARC/2010/121 FastTrack
 timeout 04/21/2010]
References: <201004080520.o385K6NW025990@localhost.sfbay.sun.com>
In-Reply-To: <201004080520.o385K6NW025990@localhost.sfbay.sun.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090208.4BCF8A62.014B:SCFMA4539814,ss=1,fgs=0
Status: RO
Content-Length: 51

This case was approved at today's meeting.

--matt

