Print this page
9286 want refreservation=auto

@@ -741,11 +741,11 @@
        Limits the amount of space a dataset can consume.  This property
        enforces a hard limit on the amount of space used.  This hard limit
        does not include space used by descendents, including file systems and
        snapshots.
 
-     refreservation=size|none
+     refreservation=size|none|auto
        The minimum amount of space guaranteed to a dataset, not including its
        descendents.  When the amount of space used is below this value, the
        dataset is treated as if it were taking up the amount of space
        specified by refreservation.  The refreservation reservation is
        accounted for in the parent datasets' space used, and counts against

@@ -753,21 +753,30 @@
 
        If refreservation is set, a snapshot is only allowed if there is enough
        free pool space outside of this reservation to accommodate the current
        number of "referenced" bytes in the dataset.
 
+       If refreservation is set to auto, a volume is made dense (or "not
+       sparse").  refreservation=auto is only supported on volumes. See
+       volsize in the Native Properties section for more information about
+       sparse volumes.
+
        This property can also be referred to by its shortened column name,
        refreserv.
 
-     reservation=size|none
+     reservation=size|none|auto
        The minimum amount of space guaranteed to a dataset and its
        descendants.  When the amount of space used is below this value, the
        dataset is treated as if it were taking up the amount of space
        specified by its reservation.  Reservations are accounted for in the
        parent datasets' space used, and count against the parent datasets'
        quotas and reservations.
 
+       See refreservation=auto above for a description of the behavior of
+       setting reservation to auto.  If the pool is at version 9 or later,
+       refreservation=auto should be used instead.
+
        This property can also be referred to by its shortened column name,
        reserv.
 
      secondarycache=all|none|metadata
        Controls what is cached in the secondary cache (L2ARC).  If this

@@ -878,13 +887,15 @@
 
        Though not recommended, a "sparse volume" (also known as "thin
        provisioning") can be created by specifying the -s option to the zfs
        create -V command, or by changing the reservation after the volume has
        been created.  A "sparse volume" is a volume where the reservation is
-       less then the volume size.  Consequently, writes to a sparse volume can
-       fail with ENOSPC when the pool is low on space.  For a sparse volume,
-       changes to volsize are not reflected in the reservation.
+       less than the size of the volume plus the space required to store its
+       metadata.  Consequently, writes to a sparse volume can fail with ENOSPC
+       when the pool is low on space.  For a sparse volume, changes to volsize
+       are not reflected in the reservation.  A sparse volume can be made
+       dense (or "not sparse") by setting the reservation to auto.
 
      vscan=on|off
        Controls whether regular files should be scanned for viruses when a
        file is opened and closed.  In addition to enabling this property, the
        virus scan service must also be enabled for virus scanning to occur.