docs-xml: vfs_gpfs: add comment "per share option"

[obnox/samba/samba-obnox.git] / docs-xml / manpages-3 / vfs_gpfs.8.xml

diff --git a/docs-xml/manpages-3/vfs_gpfs.8.xml b/docs-xml/manpages-3/vfs_gpfs.8.xml
index 2107b74a6cf189d3f54ae75f7eddc0e2a011f534..526d86d0d039bdfb84e3c2cfce6aed317c9b4531 100644 (file)
--- a/docs-xml/manpages-3/vfs_gpfs.8.xml
+++ b/docs-xml/manpages-3/vfs_gpfs.8.xml
@@ -50,6 +50,8 @@
 
        <para>This module is stackable.</para>
 
+       <para>Since Samba 4.0 all options are per share options.</para>
+
 </refsect1>
 
 
@@ -174,7 +176,7 @@
                <listitem>
                <para>
                GPFS ACLs doesn't know about the 'APPEND' right.
-               This optionen lets Samba map the 'APPEND' right to 'WRITE'.
+               This option lets Samba map the 'APPEND' right to 'WRITE'.
                </para>
 
                <itemizedlist>
@@ -190,6 +192,26 @@
                </varlistentry>
                <varlistentry>
 
+               <term>gpfs:acl = [ yes | no ]</term>
+               <listitem>
+               <para>
+               This option lets Samba use or ignore GPFS ACLs.
+               </para>
+
+               <itemizedlist>
+               <listitem><para>
+               <command>yes(default)</command> - use GPFS ACLs.
+               </para></listitem>
+               <listitem><para>
+               <command>no</command> - do not use GPFS ACLs and pass everything
+               to the next SMB_VFS module.
+               </para></listitem>
+               </itemizedlist>
+               </listitem>
+
+               </varlistentry>
+               <varlistentry>
+
                <term>gpfs:refuse_dacl_protected = [ yes | no ]</term>
                <listitem>
                <para>
@@ -221,6 +243,71 @@
                </varlistentry>
                <varlistentry>
 
+               <term>gpfs:dfreequota = [ yes | no ]</term>
+               <listitem>
+               <para>
+               Adjust reporting of the size and free space of a share
+               according to quotas. If this setting is "yes", a
+               request for size and free space will also evaluate the
+               user quota of the user requesting the data, the group
+               quota of the primary group of the user and the fileset
+               quota for the fileset containing the top level
+               directory of the share.
+               </para>
+
+               <para>
+               If any of the soft or hard quota limits has been
+               reached, the free space will be reported as 0. If a
+               quota is in place, but the limits have not been
+               reached, the free space will be reported according to
+               the space left in the quota. If more than one quota
+               applies the free space will be reported as the smallest
+               space left in those quotas. The size of the share
+               will be reported according to the quota usage. If more
+               than one quota applies, the smallest size will be
+               reported for the share size according to these quotas.
+               </para>
+
+               <itemizedlist>
+               <listitem><para>
+               <command>yes</command> - include the quotas
+               when reporting the share size and free space
+               </para></listitem>
+               <listitem><para>
+               <command>no(default)</command> - do not include quotas,
+               simply report the size and free space of the file system
+               </para></listitem>
+               </itemizedlist>
+               </listitem>
+
+               </varlistentry>
+               <varlistentry>
+
+               <term>gpfs:prealloc = [ yes | no ]</term>
+               <listitem>
+               <para>
+               If set to yes the gpfs_prealloc function will be used in the
+               fallocate callback when appropriate. If set to no gpfs_prealloc
+               will not be used. In both cases the system and libc calls are
+               avoided.
+               </para>
+
+               <itemizedlist>
+               <listitem><para>
+               <command>yes (default)</command> - Use gpfs_prealloc for the
+               fallocate callback.
+               </para></listitem>
+               <listitem><para>
+               <command>no</command> - Do not use gpfs_prealloc for the
+               fallocate callback.
+               </para></listitem>
+               </itemizedlist>
+               </listitem>
+
+               </varlistentry>
+
+               <varlistentry>
+
                <term>nfs4:mode = [ simple | special ]</term>
                <listitem>
                <para>