docs-xml/vfs_gpfs: document 'gpfs:winattr'

[metze/samba/wip.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 f926ecacf9028fe9d2e48bac0bd7c1f64ba592b8..3c7cc08f93391492cdb4196192669f837ae9f944 100644 (file)
--- a/docs-xml/manpages-3/vfs_gpfs.8.xml
+++ b/docs-xml/manpages-3/vfs_gpfs.8.xml
@@ -7,7 +7,7 @@
        <manvolnum>8</manvolnum>
        <refmiscinfo class="source">Samba</refmiscinfo>
        <refmiscinfo class="manual">System Administration tools</refmiscinfo>
-       <refmiscinfo class="version">3.2</refmiscinfo>
+       <refmiscinfo class="version">3.4</refmiscinfo>
 </refmeta>
 
 
@@ -60,6 +60,95 @@
 
                <varlistentry>
 
+               <term>gpfs:sharemodes = [ yes | no ]</term>
+               <listitem>
+               <para>
+               Enable/Disable cross node sharemode handling for GPFS.
+               </para>
+
+               <itemizedlist>
+               <listitem><para>
+               <command>yes(default)</command> - propagate sharemodes across all GPFS nodes.
+               </para></listitem>
+               <listitem><para>
+               <command>no</command> - do not propagate sharemodes across all GPFS nodes.
+               This should only be used if the GPFS file system is
+               exclusively exported by Samba. Access by local unix application or
+               NFS exports could lead to corrupted files.
+               </para></listitem>
+               </itemizedlist>
+               </listitem>
+
+               </varlistentry>
+               <varlistentry>
+
+               <term>gpfs:leases = [ yes | no ]</term>
+               <listitem>
+               <para>
+               Enable/Disable cross node leases (oplocks) for GPFS.
+               You should also set the <command>oplocks</command> and <command>kernel oplocks</command>
+               options to the same value.
+               </para>
+
+               <itemizedlist>
+               <listitem><para>
+               <command>yes(default)</command> - propagate leases across all GPFS nodes.
+               </para></listitem>
+               <listitem><para>
+               <command>no</command> - do not propagate leases across all GPFS nodes.
+               This should only be used if the GPFS file system is
+               exclusively exported by Samba. Access by local unix application or
+               NFS exports could lead to corrupted files.
+               </para></listitem>
+               </itemizedlist>
+               </listitem>
+
+               </varlistentry>
+               <varlistentry>
+
+               <term>gpfs:getrealfilename = [ yes | no ]</term>
+               <listitem>
+               <para>
+               Enable/Disable usage of the <command>gpfs_get_realfilename_path()</command> function.
+               This improves the casesensitive wildcard file name access.
+               </para>
+
+               <itemizedlist>
+               <listitem><para>
+               <command>yes(default)</command> - use <command>gpfs_get_realfilename_path()</command>.
+               </para></listitem>
+               <listitem><para>
+               <command>no</command> - do not use <command>gpfs_get_realfilename_path()</command>.
+               It seems that <command>gpfs_get_realfilename_path()</command> doesn't work on AIX.
+               </para></listitem>
+               </itemizedlist>
+               </listitem>
+
+               </varlistentry>
+               <varlistentry>
+
+               <term>gpfs:winattr = [ yes | no ]</term>
+               <listitem>
+               <para>
+               Enable/Disable usage of the windows attributes in GPFS.
+               GPFS is able to store windows file attributes e.g. HIDDEN,
+               READONLY, SYSTEM and others natively. That means Samba doesn't
+               need to map them to permission bits or extended attributes.
+               </para>
+
+               <itemizedlist>
+               <listitem><para>
+               <command>no(default)</command> - do not use GPFS windows attributes.
+               </para></listitem>
+               <listitem><para>
+               <command>yes</command> - use GPFS windows attributes.
+               </para></listitem>
+               </itemizedlist>
+               </listitem>
+
+               </varlistentry>
+               <varlistentry>
+
                <term>nfs4:mode = [ simple | special ]</term>
                <listitem>
                <para>