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

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">