726
727 When set to all, ZFS stores an extra copy of all metadata. If a single
728 on-disk block is corrupt, at worst a single block of user data (which
729 is recordsize bytes long) can be lost.
730
731 When set to most, ZFS stores an extra copy of most types of metadata.
732 This can improve performance of random writes, because less metadata
733 must be written. In practice, at worst about 100 blocks (of recordsize
734 bytes each) of user data can be lost if a single on-disk block is
735 corrupt. The exact behavior of which metadata blocks are stored
736 redundantly may change in future releases.
737
738 The default value is all.
739
740 refquota=size|none
741 Limits the amount of space a dataset can consume. This property
742 enforces a hard limit on the amount of space used. This hard limit
743 does not include space used by descendents, including file systems and
744 snapshots.
745
746 refreservation=size|none
747 The minimum amount of space guaranteed to a dataset, not including its
748 descendents. When the amount of space used is below this value, the
749 dataset is treated as if it were taking up the amount of space
750 specified by refreservation. The refreservation reservation is
751 accounted for in the parent datasets' space used, and counts against
752 the parent datasets' quotas and reservations.
753
754 If refreservation is set, a snapshot is only allowed if there is enough
755 free pool space outside of this reservation to accommodate the current
756 number of "referenced" bytes in the dataset.
757
758 This property can also be referred to by its shortened column name,
759 refreserv.
760
761 reservation=size|none
762 The minimum amount of space guaranteed to a dataset and its
763 descendants. When the amount of space used is below this value, the
764 dataset is treated as if it were taking up the amount of space
765 specified by its reservation. Reservations are accounted for in the
766 parent datasets' space used, and count against the parent datasets'
767 quotas and reservations.
768
769 This property can also be referred to by its shortened column name,
770 reserv.
771
772 secondarycache=all|none|metadata
773 Controls what is cached in the secondary cache (L2ARC). If this
774 property is set to all, then both user data and metadata is cached. If
775 this property is set to none, then neither user data nor metadata is
776 cached. If this property is set to metadata, then only metadata is
777 cached. The default value is all.
778
779 setuid=on|off
780 Controls whether the setuid bit is respected for the file system. The
781 default value is on.
782
783 sharesmb=on|off|opts
784 Controls whether the file system is shared via SMB, and what options
785 are to be used. A file system with the sharesmb property set to off is
786 managed through traditional tools such as sharemgr(1M). Otherwise, the
787 file system is automatically shared and unshared with the zfs share and
788 zfs unshare commands. If the property is set to on, the sharemgr(1M)
863 volsize=size
864 For volumes, specifies the logical size of the volume. By default,
865 creating a volume establishes a reservation of equal size. For storage
866 pools with a version number of 9 or higher, a refreservation is set
867 instead. Any changes to volsize are reflected in an equivalent change
868 to the reservation (or refreservation). The volsize can only be set to
869 a multiple of volblocksize, and cannot be zero.
870
871 The reservation is kept equal to the volume's logical size to prevent
872 unexpected behavior for consumers. Without the reservation, the volume
873 could run out of space, resulting in undefined behavior or data
874 corruption, depending on how the volume is used. These effects can
875 also occur when the volume size is changed while it is in use
876 (particularly when shrinking the size). Extreme care should be used
877 when adjusting the volume size.
878
879 Though not recommended, a "sparse volume" (also known as "thin
880 provisioning") can be created by specifying the -s option to the zfs
881 create -V command, or by changing the reservation after the volume has
882 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.
886
887 vscan=on|off
888 Controls whether regular files should be scanned for viruses when a
889 file is opened and closed. In addition to enabling this property, the
890 virus scan service must also be enabled for virus scanning to occur.
891 The default value is off.
892
893 xattr=on|off
894 Controls whether extended attributes are enabled for this file system.
895 The default value is on.
896
897 zoned=on|off
898 Controls whether the dataset is managed from a non-global zone. See
899 the Zones section for more information. The default value is off.
900
901 The following three properties cannot be changed after the file system is
902 created, and therefore, should be set when the file system is created.
903 If the properties are not set with the zfs create or zpool create
904 commands, these properties are inherited from the parent dataset. If the
905 parent dataset lacks these properties due to having been created prior to
|
726
727 When set to all, ZFS stores an extra copy of all metadata. If a single
728 on-disk block is corrupt, at worst a single block of user data (which
729 is recordsize bytes long) can be lost.
730
731 When set to most, ZFS stores an extra copy of most types of metadata.
732 This can improve performance of random writes, because less metadata
733 must be written. In practice, at worst about 100 blocks (of recordsize
734 bytes each) of user data can be lost if a single on-disk block is
735 corrupt. The exact behavior of which metadata blocks are stored
736 redundantly may change in future releases.
737
738 The default value is all.
739
740 refquota=size|none
741 Limits the amount of space a dataset can consume. This property
742 enforces a hard limit on the amount of space used. This hard limit
743 does not include space used by descendents, including file systems and
744 snapshots.
745
746 refreservation=size|none|auto
747 The minimum amount of space guaranteed to a dataset, not including its
748 descendents. When the amount of space used is below this value, the
749 dataset is treated as if it were taking up the amount of space
750 specified by refreservation. The refreservation reservation is
751 accounted for in the parent datasets' space used, and counts against
752 the parent datasets' quotas and reservations.
753
754 If refreservation is set, a snapshot is only allowed if there is enough
755 free pool space outside of this reservation to accommodate the current
756 number of "referenced" bytes in the dataset.
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
763 This property can also be referred to by its shortened column name,
764 refreserv.
765
766 reservation=size|none|auto
767 The minimum amount of space guaranteed to a dataset and its
768 descendants. When the amount of space used is below this value, the
769 dataset is treated as if it were taking up the amount of space
770 specified by its reservation. Reservations are accounted for in the
771 parent datasets' space used, and count against the parent datasets'
772 quotas and reservations.
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
778 This property can also be referred to by its shortened column name,
779 reserv.
780
781 secondarycache=all|none|metadata
782 Controls what is cached in the secondary cache (L2ARC). If this
783 property is set to all, then both user data and metadata is cached. If
784 this property is set to none, then neither user data nor metadata is
785 cached. If this property is set to metadata, then only metadata is
786 cached. The default value is all.
787
788 setuid=on|off
789 Controls whether the setuid bit is respected for the file system. The
790 default value is on.
791
792 sharesmb=on|off|opts
793 Controls whether the file system is shared via SMB, and what options
794 are to be used. A file system with the sharesmb property set to off is
795 managed through traditional tools such as sharemgr(1M). Otherwise, the
796 file system is automatically shared and unshared with the zfs share and
797 zfs unshare commands. If the property is set to on, the sharemgr(1M)
872 volsize=size
873 For volumes, specifies the logical size of the volume. By default,
874 creating a volume establishes a reservation of equal size. For storage
875 pools with a version number of 9 or higher, a refreservation is set
876 instead. Any changes to volsize are reflected in an equivalent change
877 to the reservation (or refreservation). The volsize can only be set to
878 a multiple of volblocksize, and cannot be zero.
879
880 The reservation is kept equal to the volume's logical size to prevent
881 unexpected behavior for consumers. Without the reservation, the volume
882 could run out of space, resulting in undefined behavior or data
883 corruption, depending on how the volume is used. These effects can
884 also occur when the volume size is changed while it is in use
885 (particularly when shrinking the size). Extreme care should be used
886 when adjusting the volume size.
887
888 Though not recommended, a "sparse volume" (also known as "thin
889 provisioning") can be created by specifying the -s option to the zfs
890 create -V command, or by changing the reservation after the volume has
891 been created. A "sparse volume" is a volume where the reservation is
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.
897
898 vscan=on|off
899 Controls whether regular files should be scanned for viruses when a
900 file is opened and closed. In addition to enabling this property, the
901 virus scan service must also be enabled for virus scanning to occur.
902 The default value is off.
903
904 xattr=on|off
905 Controls whether extended attributes are enabled for this file system.
906 The default value is on.
907
908 zoned=on|off
909 Controls whether the dataset is managed from a non-global zone. See
910 the Zones section for more information. The default value is off.
911
912 The following three properties cannot be changed after the file system is
913 created, and therefore, should be set when the file system is created.
914 If the properties are not set with the zfs create or zpool create
915 commands, these properties are inherited from the parent dataset. If the
916 parent dataset lacks these properties due to having been created prior to
|