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:
zfs list -d and zfs get -d
1.2. Name of Document Author/Supplier:
Author: Chris Gerhard
1.3 Date of This Document:
12 March, 2009
4. Technical Description
This project proposes a -d flag for both the list and get sub-commands to the
zfs command. The -d option would take a single argument of a Natural number
that would allow the commands to recurse to a depth equal to that integer from
the dataset specified.
$ zfs list rpool
NAME USED AVAIL REFER MOUNTPOINT
rpool 24.5G 42.5G 29.5K /rpool
$ zfs list -r rpool
NAME USED AVAIL REFER MOUNTPOINT
rpool 24.5G 42.5G 29.5K /rpool
rpool/ROOT 3.47G 42.5G 18K /rpool/ROOT
rpool/ROOT/zfs103 3.47G 42.5G 3.47G /
rpool/dump 1.00G 42.5G 1.00G -
rpool/swap 20G 62.2G 276M -
$ zfs list -d 1 rpool
NAME USED AVAIL REFER MOUNTPOINT
rpool 24.5G 42.5G 29.5K /rpool
rpool/ROOT 3.47G 42.5G 18K /rpool/ROOT
rpool/dump 1.00G 42.5G 1.00G -
rpool/swap 20G 62.2G 276M -
$
The most common use for the flag would be to allow the listing of all the
snapshots of a dataset:
: exdev.eu FSS 3 $; ./zfs list -d 1 -t snapshot rpool
NAME USED AVAIL REFER MOUNTPOINT
rpool at zfs-auto-snap:weekly-2008-10-20-14:34 0 - 36K -
rpool at zfs-auto-snap:daily-2008-10-20-14:34 0 - 36K -
rpool at zfs-auto-snap:daily-2008-10-21-00:00 17K - 36K -
rpool at zfs-auto-snap:weekly-2008-10-22-00:00 0 - 41K -
rpool at zfs-auto-snap:daily-2008-10-22-00:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-22-16:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-22-17:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-22-18:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-22-19:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-22-20:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-22-21:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-22-22:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-22-23:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-00:00 0 - 41K -
rpool at zfs-auto-snap:daily-2008-10-23-00:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-01:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-02:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-03:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-04:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-05:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-06:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-07:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-08:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-09:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-10:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-11:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-12:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-13:00 0 - 41K -
rpool at zfs-auto-snap:hourly-2008-10-23-14:00 0 - 41K -
rpool at zfs-auto-snap:frequent-2008-10-23-14:15 0 - 41K -
rpool at zfs-auto-snap:frequent-2008-10-23-14:30 0 - 41K -
rpool at zfs-auto-snap:frequent-2008-10-23-14:45 0 - 41K -
: exdev.eu FSS 4 $;
Use of the -d and -r options would be mutually exclusive and result in a usage
error. Giving a negative depth or a non numeric depth would also result in an
error.
Updated man pages are in the case materials directory.
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
