Copyright 2006 Sun Microsystems, Inc.
______________________________________________________________

Name(s) of person (s) answer questions?

        Sarah Jelinek
	Rich Lowe, richlowe@richlowe.net

What specifically is the proposal that we are reviewing?

	Addition of the -s and -S options to the 'zfs list' command for
	selecting columns to display and sort from. See svcs(1) for
	an example.

	This ARC case is generated from an opensolaris sponsor request for
	RFE 6276925 option to sort 'zfs list' output. Solution provided
	by Richard Lowe, sponsored by Sarah Jelinek.

Summary:

	These options are being added to enable sorting of the 'zfs list'
	output. 

	-s col               Sorts output by column.  col  should
                             be  a column name. See COLUMNS below
                             for available columns.  Multiple  -s
			     options are evaluated left to right, in
			     descreasing order of importance.

		So for example, the output for the command:

			'zfs list -s avail -S refer' 

		will be in ascending order of space available and for the 
		datasets where that is equal, sort in descending 
		order of space referenced.

	-S col               Sorts by col in the  opposite  order
			     as option -s.

	Numeric types sort in ascending/descending order.

	String types sort in alphabetical order.

	Types inappropriate for a row sort that row to the literal
	bottom, regardless of the specified ordering.  For example,
	the property 'available' makes no sense on a snapshot. 

	If no sorting options are specified the existing behavior of
	'zfs list' is preserved.

	**************************************************************

	COLUMNS:

	type             
        creation         
        used           
        available        
        referenced       
        compressratio  
        mounted       
        origin 
        quota
        reservation
        volsize   
        volblocksize 
        recordsize  
        mountpoint 
        sharenfs 
        checksum
        atime 
        devices
        exec
        setuid
        readonly
        zoned
        snapdir
        aclmode
        aclinherit

	This project is requesting approval for patch binding.

EXPORTED INTERFACES:
                          Proposed                              Specified
Interface                 Stability                             in what
Name                      Classification                        document?
------------------------------------------------------------------------------
zfs list -s/-S		Evolving				This document.