zfs.8: add missing info about dedup, mlslabel
These sections were missing from the `zfs.8` man page. Add them. Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov> Closes #1026
This commit is contained in:
parent
beb999445a
commit
c8f259182d
|
@ -320,6 +320,10 @@ A file system \fBmountpoint\fR property of \fBnone\fR prevents the file system f
|
||||||
.sp
|
.sp
|
||||||
.LP
|
.LP
|
||||||
If needed, \fBZFS\fR file systems can also be managed with traditional tools (\fBmount\fR, \fBumount\fR, \fB/etc/fstab\fR). If a file system's mount point is set to \fBlegacy\fR, \fBZFS\fR makes no attempt to manage the file system, and the administrator is responsible for mounting and unmounting the file system.
|
If needed, \fBZFS\fR file systems can also be managed with traditional tools (\fBmount\fR, \fBumount\fR, \fB/etc/fstab\fR). If a file system's mount point is set to \fBlegacy\fR, \fBZFS\fR makes no attempt to manage the file system, and the administrator is responsible for mounting and unmounting the file system.
|
||||||
|
.SS "Deduplication"
|
||||||
|
.sp
|
||||||
|
.LP
|
||||||
|
Deduplication is the process for removing redundant data at the block-level, reducing the total amount of data stored. If a file system has the \fBdedup\fR property enabled, duplicate data blocks are removed synchronously. The result is that only unique data is stored and common components are shared among files.
|
||||||
.SS "Native Properties"
|
.SS "Native Properties"
|
||||||
.sp
|
.sp
|
||||||
.LP
|
.LP
|
||||||
|
@ -734,6 +738,19 @@ Controls the number of copies of data stored for this dataset. These copies are
|
||||||
Changing this property only affects newly-written data. Therefore, set this property at file system creation time by using the \fB-o\fR \fBcopies=\fR\fIN\fR option.
|
Changing this property only affects newly-written data. Therefore, set this property at file system creation time by using the \fB-o\fR \fBcopies=\fR\fIN\fR option.
|
||||||
.RE
|
.RE
|
||||||
|
|
||||||
|
.sp
|
||||||
|
.ne 2
|
||||||
|
.mk
|
||||||
|
.na
|
||||||
|
\fB\fBdedup\fR=\fBon\fR | \fBoff\fR | \fBverify\fR | \fBsha256\fR[,\fBverify\fR]\fR
|
||||||
|
.ad
|
||||||
|
.sp .6
|
||||||
|
.RS 4n
|
||||||
|
Controls whether deduplication is in effect for a dataset. The default value is \fBoff\fR. The default checksum used for deduplication is \fBsha256\fR (subject to change). When \fBdedup\fR is enabled, the \fBdedup\fR checksum algorithm overrides the \fBchecksum\fR property. Setting the value to \fBverify\fR is equivalent to specifying \fBsha256,verify\fR.
|
||||||
|
.sp
|
||||||
|
If the property is set to \fBverify\fR, then, whenever two blocks have the same signature, ZFS will do a byte-for-byte comparison with the existing block to ensure that the contents are identical.
|
||||||
|
.RE
|
||||||
|
|
||||||
.sp
|
.sp
|
||||||
.ne 2
|
.ne 2
|
||||||
.mk
|
.mk
|
||||||
|
@ -756,6 +773,25 @@ Controls whether device nodes can be opened on this file system. The default val
|
||||||
Controls whether processes can be executed from within this file system. The default value is \fBon\fR.
|
Controls whether processes can be executed from within this file system. The default value is \fBon\fR.
|
||||||
.RE
|
.RE
|
||||||
|
|
||||||
|
.sp
|
||||||
|
.ne 2
|
||||||
|
.mk
|
||||||
|
.na
|
||||||
|
\fB\fBmlslabel\fR=\fIlabel\fR | \fBnone\fR\fR
|
||||||
|
.ad
|
||||||
|
.sp .6
|
||||||
|
.RS 4n
|
||||||
|
The \fBmlslabel\fR property is a sensitivity label that determines if a dataset can be mounted in a zone on a system with Trusted Extensions enabled. If the labeled dataset matches the labeled zone, the dataset can be mounted and accessed from the labeled zone.
|
||||||
|
.sp
|
||||||
|
When the \fBmlslabel\fR property is not set, the default value is \fBnone\fR. Setting the \fBmlslabel\fR property to \fBnone\fR is equivalent to removing the property.
|
||||||
|
.sp
|
||||||
|
The \fBmlslabel\fR property can be modified only when Trusted Extensions is enabled and only with appropriate privilege. Rights to modify it cannot be delegated. When changing a label to a higher label or setting the initial dataset label, the \fB{PRIV_FILE_UPGRADE_SL}\fR privilege is required. When changing a label to a lower label or the default (\fBnone\fR), the \fB{PRIV_FILE_DOWNGRADE_SL}\fR privilege is required. Changing the dataset to labels other than the default can be done only when the dataset is not mounted. When a dataset with the default label is mounted into a labeled-zone, the mount operation automatically sets the \fBmlslabel\fR property to the label of that zone.
|
||||||
|
.sp
|
||||||
|
When Trusted Extensions is \fBnot\fR enabled, only datasets with the default label (\fBnone\fR) can be mounted.
|
||||||
|
.sp
|
||||||
|
Zones are a Solaris feature and are not relevant on Linux.
|
||||||
|
.RE
|
||||||
|
|
||||||
.sp
|
.sp
|
||||||
.ne 2
|
.ne 2
|
||||||
.mk
|
.mk
|
||||||
|
@ -812,7 +848,7 @@ Quotas cannot be set on volumes, as the \fBvolsize\fR property acts as an implic
|
||||||
.ad
|
.ad
|
||||||
.sp .6
|
.sp .6
|
||||||
.RS 4n
|
.RS 4n
|
||||||
Limits the amount of space consumed by the specified user. User space consumption is identified by the \fBuserspace@\fR\fIuser\fR property.
|
Limits the amount of space consumed by the specified user. Similar to the \fBrefquota\fR property, the \fBuserquota\fR space calculation does not include space that is used by descendent datasets, such as snapshots and clones. User space consumption is identified by the \fBuserspace@\fR\fIuser\fR property.
|
||||||
.sp
|
.sp
|
||||||
Enforcement of user quotas may be delayed by several seconds. This delay means that a user might exceed their quota before the system notices that they are over quota and begins to refuse additional writes with the \fBEDQUOT\fR error message . See the \fBzfs userspace\fR subcommand for more information.
|
Enforcement of user quotas may be delayed by several seconds. This delay means that a user might exceed their quota before the system notices that they are over quota and begins to refuse additional writes with the \fBEDQUOT\fR error message . See the \fBzfs userspace\fR subcommand for more information.
|
||||||
.sp
|
.sp
|
||||||
|
@ -2605,8 +2641,11 @@ casesensitivity property
|
||||||
checksum property
|
checksum property
|
||||||
compression property
|
compression property
|
||||||
copies property
|
copies property
|
||||||
|
dedup property
|
||||||
devices property
|
devices property
|
||||||
exec property
|
exec property
|
||||||
|
logbias property
|
||||||
|
mlslabel property
|
||||||
mountpoint property
|
mountpoint property
|
||||||
nbmand property
|
nbmand property
|
||||||
normalization property
|
normalization property
|
||||||
|
@ -2987,6 +3026,9 @@ pool/home/bob usedbysnapshots 0 -
|
||||||
pool/home/bob usedbydataset 21K -
|
pool/home/bob usedbydataset 21K -
|
||||||
pool/home/bob usedbychildren 0 -
|
pool/home/bob usedbychildren 0 -
|
||||||
pool/home/bob usedbyrefreservation 0 -
|
pool/home/bob usedbyrefreservation 0 -
|
||||||
|
pool/home/bob logbias latency default
|
||||||
|
pool/home/bob dedup off default
|
||||||
|
pool/home/bob mlslabel none default
|
||||||
.fi
|
.fi
|
||||||
.in -2
|
.in -2
|
||||||
.sp
|
.sp
|
||||||
|
|
Loading…
Reference in New Issue