aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/handbook/zfs
diff options
context:
space:
mode:
authorSevan Janiyan <sevan@FreeBSD.org>2017-08-18 19:31:46 +0000
committerSevan Janiyan <sevan@FreeBSD.org>2017-08-18 19:31:46 +0000
commit44748ca84b05a1cc8651be23e692af7e017405a0 (patch)
tree4e3d0a9c2c4da73211d5426de14ef65d090b2e6c /en_US.ISO8859-1/books/handbook/zfs
parenta258681767dd27b4eeeb6721426be0c3c98ffa74 (diff)
downloaddoc-44748ca84b05a1cc8651be23e692af7e017405a0.tar.gz
doc-44748ca84b05a1cc8651be23e692af7e017405a0.zip
Add get/set share properties subsection to handbook's ZFS chapter.
PR: 211022 Submitted by: Dan Bright <freebsd AT zaziork DOT com> Reviewed by: allanjude Approved by: bcr (mentor) Differential Revision: https://reviews.freebsd.org/D12009
Notes
Notes: svn path=/head/; revision=50688
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/zfs')
-rw-r--r--en_US.ISO8859-1/books/handbook/zfs/chapter.xml32
1 files changed, 32 insertions, 0 deletions
diff --git a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
index 7205add56e..5b6ab9e85e 100644
--- a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
@@ -1881,6 +1881,38 @@ NAME PROPERTY VALUE SOURCE
tank custom:costcenter - -
&prompt.root; <userinput>zfs get all <replaceable>tank</replaceable> | grep <replaceable>custom</replaceable>:<replaceable>costcenter</replaceable></userinput>
&prompt.root;</screen>
+
+ <sect3 xml:id="zfs-zfs-set-share">
+ <title>Getting and Setting Share Properties</title>
+
+ <para>Two commonly used and useful dataset properties are the
+ <acronym>NFS</acronym> and <acronym>SMB</acronym> share options.
+ Setting these define if and how <acronym>ZFS</acronym> datasets
+ may be shared on the network. At present, only setting sharing
+ via <acronym>NFS</acronym> is supported on &os;. To get the
+ current status of a share, enter:</para>
+
+ <screen>&prompt.root; <userinput>zfs get sharenfs <replaceable>mypool/usr/home</replaceable></userinput>
+ NAME PROPERTY VALUE SOURCE
+ mypool/usr/home sharenfs on local
+
+ &prompt.root; <userinput>zfs get sharesmb <replaceable>mypool/usr/home</replaceable></userinput>
+
+ NAME PROPERTY VALUE SOURCE
+ mypool/usr/home sharesmb off local</screen>
+
+ <para>To enable sharing of a dataset, enter:</para>
+
+ <screen>&prompt.root; <userinput> zfs set sharenfs=on <replaceable>mypool/usr/home</replaceable></userinput></screen>
+
+ <para>It is also possible to set additional options for sharing
+ datasets through <acronym>NFS</acronym>, such as
+ <option>-alldirs</option>, <option>-maproot</option> and
+ <option>-network</option>. To set additional options to a
+ dataset shared through NFS, enter:</para>
+
+ <screen>&prompt.root; <userinput> zfs set sharenfs="-alldirs,-maproot=<replaceable>root</replaceable>,-network=<replaceable>192.168.1.0/24</replaceable> <replaceable>mypool/usr/home</replaceable></userinput></screen>
+ </sect3>
</sect2>
<sect2 xml:id="zfs-zfs-snapshot">