diff options
author | KORN Andras <[email protected]> | 2012-10-09 10:26:38 +0200 |
---|---|---|
committer | Brian Behlendorf <[email protected]> | 2012-10-09 09:54:16 -0700 |
commit | c8f259182d72f8ded5b9fbc4198f41782a7cbf77 (patch) | |
tree | 3e2428bd9651e27bf4a440bfc7f415faa669fc44 /man | |
parent | beb999445adaa6d794f0d706ca8a0c835cb1468c (diff) |
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 <[email protected]>
Closes #1026
Diffstat (limited to 'man')
-rw-r--r-- | man/man8/zfs.8 | 44 |
1 files changed, 43 insertions, 1 deletions
diff --git a/man/man8/zfs.8 b/man/man8/zfs.8 index fc701ac6e..59ecceb81 100644 --- a/man/man8/zfs.8 +++ b/man/man8/zfs.8 @@ -320,6 +320,10 @@ A file system \fBmountpoint\fR property of \fBnone\fR prevents the file system f .sp .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. +.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" .sp .LP @@ -738,6 +742,19 @@ Changing this property only affects newly-written data. Therefore, set this prop .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 +.ne 2 +.mk +.na \fB\fBdevices\fR=\fBon\fR | \fBoff\fR\fR .ad .sp .6 @@ -760,6 +777,25 @@ Controls whether processes can be executed from within this file system. The def .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 +.ne 2 +.mk +.na \fB\fBmountpoint\fR=\fIpath\fR | \fBnone\fR | \fBlegacy\fR\fR .ad .sp .6 @@ -812,7 +848,7 @@ Quotas cannot be set on volumes, as the \fBvolsize\fR property acts as an implic .ad .sp .6 .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 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 @@ -2605,8 +2641,11 @@ casesensitivity property checksum property compression property copies property +dedup property devices property exec property +logbias property +mlslabel property mountpoint property nbmand property normalization property @@ -2987,6 +3026,9 @@ pool/home/bob usedbysnapshots 0 - pool/home/bob usedbydataset 21K - pool/home/bob usedbychildren 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 .in -2 .sp |