summaryrefslogtreecommitdiffstats
path: root/man/man8/zfs.8
diff options
context:
space:
mode:
authorEric Dillmann <[email protected]>2013-02-14 00:11:59 +0100
committerBrian Behlendorf <[email protected]>2013-03-05 12:37:54 -0800
commit0b4d1b5853791e1e447d74f0b229800d65b53071 (patch)
tree9d908b32fb62c3f9549de128195bdf67c6d50a7e /man/man8/zfs.8
parenta4430fce691d492aec382de0dfa937c05ee16500 (diff)
Add snapdev=[hidden|visible] dataset property
The new snapdev dataset property may be set to control the visibility of zvol snapshot devices. By default this value is set to 'hidden' which will prevent zvol snapshots from appearing under /dev/zvol/ and /dev/<dataset>/. When set to 'visible' all zvol snapshots for the dataset will be visible. This functionality was largely added because when automatic snapshoting is enabled large numbers of read-only zvol snapshots will be created. When creating these devices the kernel will attempt to read their partition tables, and blkid will attempt to identify any filesystems on those partitions. This leads to a variety of issues: 1) The zvol partition tables will be read in the context of the `modprobe zfs` for automatically imported pools. This is undesirable and should be done asynchronously, but for now reducing the number of visible devices helps. 2) Udev expects to be able to complete its work for a new block devices fairly quickly. When many zvol devices are added at the same time this is no longer be true. It can lead to udev timeouts and missing /dev/zvol links. 3) Simply having lots of devices in /dev/ can be aukward from a management standpoint. Hidding the devices your unlikely to ever use helps with this. Any snapshot device which is needed can be made visible by changing the snapdev property. NOTE: This patch changes the default behavior for zvols which was effectively 'snapdev=visible'. Signed-off-by: Brian Behlendorf <[email protected]> Closes #1235 Closes #945 Issue #956 Issue #756
Diffstat (limited to 'man/man8/zfs.8')
-rw-r--r--man/man8/zfs.811
1 files changed, 11 insertions, 0 deletions
diff --git a/man/man8/zfs.8 b/man/man8/zfs.8
index edfd5e797..6f648f7ae 100644
--- a/man/man8/zfs.8
+++ b/man/man8/zfs.8
@@ -1085,6 +1085,17 @@ Provide a hint to ZFS about handling of synchronous requests in this dataset. If
.ne 2
.mk
.na
+\fB\fBsnapdev\fR=\fBhidden\fR | \fBvisible\fR\fR
+.ad
+.sp .6
+.RS 4n
+Controls whether the snapshots devices of zvol's are hidden or visible. The default value is \fBhidden\fR.
+.RE
+
+.sp
+.ne 2
+.mk
+.na
\fB\fBsnapdir\fR=\fBhidden\fR | \fBvisible\fR\fR
.ad
.sp .6