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:
ZFS snapshot properties
1.2. Name of Document Author/Supplier:
Author: Matthew Ahrens
1.3 Date of This Document:
29 July, 2008
4. Technical Description
This case requests patch/micro release binding. The new interfaces are
committed.
A. INTRODUCTION
ZFS stores properties on filesystems and volumes. These properties are
manipulated with "zfs set", "zfs inherit", "zfs list", and "zfs get".
Properties fall into several categories:
* read-only properties, which are set by the system and report on the
state of the filesystem or snapshot (eg, space used).
* modifiable system properties, which users can change and which affect
ZFS behavior (eg, atime, setuid, quota)
* user properties, which system administrators can set but which do
not affect ZFS behavior. Administrators may define user properties
using names of their choosing. (eg, com.sun:billingdepartment)
Until now, properties on snapshots can not be modified; the modifiable
system properties which affect snapshots (eg, setuid, exec) always
inherit their setting from the containing filesystem or volume.
B. DESCRIPTION
This case adds the ability to set properties on snapshots. This
includes system properties that affect snapshots (devices, exec, setuid,
xattr, nbmand) and user properties. Set-once properties (eg,
normalization) can not be set on snapshots.
The "zfs set" and "zfs inherit" commands can now be used on snapshots.
Additionally, "zfs snapshot" will take a "-o property=value" option
(which can be specified multipe times to set many properties).
"zfs send -R" will send snapshot properties. Old software versions
which do not understand snapshot properties will ignore them when doing
a "zfs recv" of such a stream.
The zpool on-disk version number will be incremented, and snapshot
properties can only be set on upgraded pools.
C. MANPAGE CHANGES
To be determined.
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
