Print this page 
9286 want refreservation=auto
Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/zfs.1m.man.txt
          +++ new/usr/src/man/man1m/zfs.1m.man.txt
↓ open down ↓ 735 lines elided ↑ open up ↑ 
 736  736         redundantly may change in future releases.
 737  737  
 738  738         The default value is all.
 739  739  
 740  740       refquota=size|none
 741  741         Limits the amount of space a dataset can consume.  This property
 742  742         enforces a hard limit on the amount of space used.  This hard limit
 743  743         does not include space used by descendents, including file systems and
 744  744         snapshots.
 745  745  
 746      -     refreservation=size|none
      746 +     refreservation=size|none|auto
 747  747         The minimum amount of space guaranteed to a dataset, not including its
 748  748         descendents.  When the amount of space used is below this value, the
 749  749         dataset is treated as if it were taking up the amount of space
 750  750         specified by refreservation.  The refreservation reservation is
 751  751         accounted for in the parent datasets' space used, and counts against
 752  752         the parent datasets' quotas and reservations.
 753  753  
 754  754         If refreservation is set, a snapshot is only allowed if there is enough
 755  755         free pool space outside of this reservation to accommodate the current
 756  756         number of "referenced" bytes in the dataset.
 757  757  
      758 +       If refreservation is set to auto, a volume is made dense (or "not
      759 +       sparse").  refreservation=auto is only supported on volumes. See
      760 +       volsize in the Native Properties section for more information about
      761 +       sparse volumes.
      762 +
 758  763         This property can also be referred to by its shortened column name,
 759  764         refreserv.
 760  765  
 761      -     reservation=size|none
      766 +     reservation=size|none|auto
 762  767         The minimum amount of space guaranteed to a dataset and its
 763  768         descendants.  When the amount of space used is below this value, the
 764  769         dataset is treated as if it were taking up the amount of space
 765  770         specified by its reservation.  Reservations are accounted for in the
 766  771         parent datasets' space used, and count against the parent datasets'
 767  772         quotas and reservations.
 768  773  
      774 +       See refreservation=auto above for a description of the behavior of
      775 +       setting reservation to auto.  If the pool is at version 9 or later,
      776 +       refreservation=auto should be used instead.
      777 +
 769  778         This property can also be referred to by its shortened column name,
 770  779         reserv.
 771  780  
 772  781       secondarycache=all|none|metadata
 773  782         Controls what is cached in the secondary cache (L2ARC).  If this
 774  783         property is set to all, then both user data and metadata is cached.  If
 775  784         this property is set to none, then neither user data nor metadata is
 776  785         cached.  If this property is set to metadata, then only metadata is
 777  786         cached.  The default value is all.
 778  787
↓ open down ↓ 94 lines elided ↑ open up ↑ 
 873  882         could run out of space, resulting in undefined behavior or data
 874  883         corruption, depending on how the volume is used.  These effects can
 875  884         also occur when the volume size is changed while it is in use
 876  885         (particularly when shrinking the size).  Extreme care should be used
 877  886         when adjusting the volume size.
 878  887  
 879  888         Though not recommended, a "sparse volume" (also known as "thin
 880  889         provisioning") can be created by specifying the -s option to the zfs
 881  890         create -V command, or by changing the reservation after the volume has
 882  891         been created.  A "sparse volume" is a volume where the reservation is
 883      -       less then the volume size.  Consequently, writes to a sparse volume can
 884      -       fail with ENOSPC when the pool is low on space.  For a sparse volume,
 885      -       changes to volsize are not reflected in the reservation.
      892 +       less than the size of the volume plus the space required to store its
      893 +       metadata.  Consequently, writes to a sparse volume can fail with ENOSPC
      894 +       when the pool is low on space.  For a sparse volume, changes to volsize
      895 +       are not reflected in the reservation.  A sparse volume can be made
      896 +       dense (or "not sparse") by setting the reservation to auto.
 886  897  
 887  898       vscan=on|off
 888  899         Controls whether regular files should be scanned for viruses when a
 889  900         file is opened and closed.  In addition to enabling this property, the
 890  901         virus scan service must also be enabled for virus scanning to occur.
 891  902         The default value is off.
 892  903  
 893  904       xattr=on|off
 894  905         Controls whether extended attributes are enabled for this file system.
 895  906         The default value is on.
↓ open down ↓ 1405 lines elided ↑ open up ↑ 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX