"usershare owner only" docs.

Jeremy.

diff --git a/docs/smbdotconf/misc/usershareowneronly.xml b/docs/smbdotconf/misc/usershareowneronly.xml
new file mode 100644 (file)
index 0000000..4aab43a
--- /dev/null
+++ b/docs/smbdotconf/misc/usershareowneronly.xml
@@ -0,0 +1,19 @@
+<samba:parameter name="usershare owner only"
+                context="G"
+                basic="1" advanced="1"
+                type="boolean"
+                xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+       <para>This parameter controls whether the pathname exported by
+       a user defined shares must be owned by the user creating the
+       user defined share or not. If set to True (the default) then
+       smbd checks that the directory path being shared is owned by
+       the user who owns the usershare file defining this share and
+       refuses to create the share if not. If set to False then no
+       such check is performed and any directory path may be exported
+       regardless of who owns it.
+       </para>
+
+</description>
+<value type="default">True</value>
+</samba:parameter>