From Mon Jul 28 11:53:43 2008 Date: Mon, 28 Jul 2008 11:53:43 -0700 (PDT) From: Postmaster Subject: Message from mail server Content-Length: 95 Mime-Version: 1.0 Status: RO X-IMAP: 1217271223 1 Delete. This is a system message. --END+PSEUDO-- From Tim.Haley@sun.com Tue Jul 22 11:35:20 2008 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 m6MIZJQT013468 for ; Tue, 22 Jul 2008 11:35:20 -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 m6MIZHtO023060; Tue, 22 Jul 2008 19:35:18 +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 <0K4F00D0B7MT6J00@nwk-avmta-2.sfbay.sun.com>; Tue, 22 Jul 2008 11:35:17 -0700 (PDT) Received: from dm-central-02.central.sun.com ([129.147.62.5]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K4F009DX7MSWI90@nwk-avmta-2.sfbay.sun.com>; Tue, 22 Jul 2008 11:35:16 -0700 (PDT) Received: from spidey.Central.Sun.COM (spidey.Central.Sun.COM [172.20.25.27]) by dm-central-02.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m6MIZGDm037670; Tue, 22 Jul 2008 12:35:16 -0600 (MDT) Received: from spidey.Central.Sun.COM (localhost [127.0.0.1]) by spidey.Central.Sun.COM (8.14.3+Sun/8.14.3) with ESMTP id m6MIDQxs028417; Tue, 22 Jul 2008 12:13:26 -0600 (MDT) Received: (from timh@localhost) by spidey.Central.Sun.COM (8.14.3+Sun/8.14.3/Submit) id m6MIDP89028415; Tue, 22 Jul 2008 12:13:25 -0600 (MDT) Date: Tue, 22 Jul 2008 12:13:25 -0600 (MDT) From: Tim Haley Subject: Excluding snapshot info from 'zfs list' [PSARC/2008/469 FastTrack timeout 07/29/2008] To: PSARC-ext@sun.com Cc: zfs-team@sun.com Message-id: <200807221813.m6MIDP89028415@spidey.Central.Sun.COM> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Content-Length: 4423 Status: RO X-Status: $$$$ X-UID: 0000000001 I am sponsoring this fast-track for Rich Morris. Requested release binding is patch for the 'listsnapshots' property and 'zfs list -t all' functionality. Requested release binding for the change to default 'zfs list' behavior is minor/micro. Template Version: @(#)sac_nextcase 1.66 04/17/08 SMI This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: Excluding snapshot info from 'zfs list' 1.2. Name of Document Author/Supplier: Author: Richard Morris 1.3 Date of This Document: 22 July, 2008 4. Technical Description This case changes the default output of the zfs list command. A. INTRODUCTION Currently when run without any options, the zfs list command lists all zfs datasets. This includes all filesystems, volumes, and snapshots. On systems with large number of snapshots, the snapshot info can flood the output, making the default zfs list command less useful in the case where the user is not interested in information about snapshots. One example is jurassic-x4600.sfbay which has 1733 zfs filesystems and 59,707 snapshots. This case changes the zfs list command to omit snapshots by default. Instead, zfs list will display only filesystems and volumes. A new pool level property will permit control of the zfs list output for that pool. The value for the new property can be set at pool creation time and import time, and later changed with the "zpool set" command. B. DESCRIPTION The zfs list command outputs the property information for the selected datasets in tabular form. Currently zfs datasets of all types are displayed. The -t option provides a way to specify one or more types to display. For example, specifying "-t snapshot,volume" displays only snapshots and volumes. This case adds a new pool level property named "listsnapshots" which can be abbreviated as "listsnaps". The default for the new property will be 'off'. When the value of this property is set to 'on' then zfs list includes snapshot information for all selected datasets in this pool. If the -r option is specified and "listsnaps" is 'on' then zfs list also displays snapshot info for all children of the selected datasets in this pool. The "listsnaps" property does not change the behavior of any subcommand of the zfs command other than list. If the "listsnaps" property is made available as a patch (Solaris 10), its default value will be 'on'. This will leave the default behavior of zfs list unchanged. Users may omit snapshot info from zfs list on this release by manually setting the property to 'off' for each pool. This case also adds a new "-t all" option to zfs list. Going forward, zfs list will include info about snapshots in a pool if "listsnaps" is 'on' for that pool or if "-t snapshot" or "-t all" is specified. The -t option to the zfs list command takes precedence over the value of the "listsnaps" property. zfs list -t snapshot displays all snapshots including those associated with pools where the "listsnaps" property is 'off'. C. MANPAGE CHANGES % diff zpool.1 zpool.new 646a648,653 > listsnaps=on | off > > Controls whether info about snapshots associated with > this pool is output when zfs list is run without the > -t option. The default value is "off". > % diff zfs.1 zfs.new 437,438c437 < The type of dataset: "filesystem", "volume", "snapshot", < or "clone". --- > The type of dataset: "filesystem", "volume", or "snapshot". 1239,1240c1244,1246 < name. By default, all datasets are displayed and contain < the following fields: --- > name. By default, all filesystems and volumes are displayed. > Snapshots are displayed if the "listsnaps" property is on > (the default is off). The following fields are displayed: 1313c1319 < tem", "snapshot" or "volume". For --- > tem", "snapshot", "volume", or "all". For 1942c1948,1949 < volumes in the system. --- > volumes in the system. Snapshots are displayed if the "listsnaps" > pool property is on (the default is off). See zpool(1M) for more > information on pool properties. 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 tim.haley@sun.com Wed Jul 30 10:12:55 2008 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 m6UHCsag021479 for ; Wed, 30 Jul 2008 10:12:55 -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 m6UHClX2024001; Wed, 30 Jul 2008 18:12:53 +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 <0K4T0060BX5FMN00@nwk-avmta-2.sfbay.sun.com>; Wed, 30 Jul 2008 10:12:51 -0700 (PDT) Received: from brmea-mail-2.sun.com ([192.18.98.43]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K4T002W2X5FVL70@nwk-avmta-2.sfbay.sun.com>; Wed, 30 Jul 2008 10:12:51 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m6UHCpQ8021957; Wed, 30 Jul 2008 17:12:51 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K4T00E01UQ08000@mail-amer.sun.com> (original mail from tim.haley@sun.com) ; Wed, 30 Jul 2008 11:12:51 -0600 (MDT) Received: from [172.20.25.27] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K4T000BSX5D9G80@mail-amer.sun.com>; Wed, 30 Jul 2008 11:12:49 -0600 (MDT) Date: Wed, 30 Jul 2008 11:12:17 -0600 From: Tim Haley Subject: Re: Excluding snapshot info from 'zfs list' [PSARC/2008/469 FastTrack timeout 07/29/2008] In-reply-to: <200807221813.m6MIDP89028415@spidey.Central.Sun.COM> Sender: Timothy.Haley@sun.com To: PSARC-ext@sun.com Cc: zfs-team@sun.com Message-id: <4890A0F1.6020703@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: <200807221813.m6MIDP89028415@spidey.Central.Sun.COM> User-Agent: Thunderbird 2.0.0.14 (X11/20080630) Status: RO Content-Length: 56 This case was approved in today's PSARC meeting. -tim