Changeset 745 for trunk/server/docs-xml/manpages-3/vfs_gpfs.8.xml
- Timestamp:
- Nov 27, 2012, 4:43:17 PM (13 years ago)
- Location:
- trunk/server
- Files:
-
- 2 edited
-
. (modified) (1 prop)
-
docs-xml/manpages-3/vfs_gpfs.8.xml (modified) (4 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/server
- Property svn:mergeinfo changed
/vendor/current merged: 581,587,591,594,597,600,615,618,740
- Property svn:mergeinfo changed
-
trunk/server/docs-xml/manpages-3/vfs_gpfs.8.xml
r414 r745 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version">3. 5</refmiscinfo>10 <refmiscinfo class="version">3.6</refmiscinfo> 11 11 </refmeta> 12 12 … … 61 61 <varlistentry> 62 62 63 <term>gpfs:sharemodes = [ yes | no ]</term> 64 <listitem> 65 <para> 66 Enable/Disable cross node sharemode handling for GPFS. 67 </para> 68 69 <itemizedlist> 70 <listitem><para> 71 <command>yes(default)</command> - propagate sharemodes across all GPFS nodes. 72 </para></listitem> 73 <listitem><para> 74 <command>no</command> - do not propagate sharemodes across all GPFS nodes. 75 This should only be used if the GPFS file system is 76 exclusively exported by Samba. Access by local unix application or 77 NFS exports could lead to corrupted files. 78 </para></listitem> 79 </itemizedlist> 80 </listitem> 81 82 </varlistentry> 83 <varlistentry> 84 85 <term>gpfs:leases = [ yes | no ]</term> 86 <listitem> 87 <para> 88 Enable/Disable cross node leases (oplocks) for GPFS. 89 You should also set the <command>oplocks</command> and <command>kernel oplocks</command> 90 options to the same value. 91 </para> 92 93 <itemizedlist> 94 <listitem><para> 95 <command>yes(default)</command> - propagate leases across all GPFS nodes. 96 </para></listitem> 97 <listitem><para> 98 <command>no</command> - do not propagate leases across all GPFS nodes. 99 This should only be used if the GPFS file system is 100 exclusively exported by Samba. Access by local unix application or 101 NFS exports could lead to corrupted files. 102 </para></listitem> 103 </itemizedlist> 104 </listitem> 105 106 </varlistentry> 107 108 <varlistentry> 109 110 <term>gpfs:hsm = [ yes | no ]</term> 111 <listitem> 112 <para> 113 Enable/Disable announcing if this FS has HSM enabled. 114 </para> 115 116 <itemizedlist> 117 <listitem><para> 118 <command>no(default)</command> - Do not announce HSM. 119 </para></listitem> 120 <listitem><para> 121 <command>no</command> - Announce HSM. 122 </para></listitem> 123 </itemizedlist> 124 </listitem> 125 126 </varlistentry> 127 128 <varlistentry> 129 130 <term>gpfs:getrealfilename = [ yes | no ]</term> 131 <listitem> 132 <para> 133 Enable/Disable usage of the <command>gpfs_get_realfilename_path()</command> function. 134 This improves the casesensitive wildcard file name access. 135 </para> 136 137 <itemizedlist> 138 <listitem><para> 139 <command>yes(default)</command> - use <command>gpfs_get_realfilename_path()</command>. 140 </para></listitem> 141 <listitem><para> 142 <command>no</command> - do not use <command>gpfs_get_realfilename_path()</command>. 143 It seems that <command>gpfs_get_realfilename_path()</command> doesn't work on AIX. 144 </para></listitem> 145 </itemizedlist> 146 </listitem> 147 148 </varlistentry> 149 <varlistentry> 150 151 <term>gpfs:winattr = [ yes | no ]</term> 152 <listitem> 153 <para> 154 Enable/Disable usage of the windows attributes in GPFS. 155 GPFS is able to store windows file attributes e.g. HIDDEN, 156 READONLY, SYSTEM and others natively. That means Samba doesn't 157 need to map them to permission bits or extended attributes. 158 </para> 159 160 <itemizedlist> 161 <listitem><para> 162 <command>no(default)</command> - do not use GPFS windows attributes. 163 </para></listitem> 164 <listitem><para> 165 <command>yes</command> - use GPFS windows attributes. 166 </para></listitem> 167 </itemizedlist> 168 </listitem> 169 170 </varlistentry> 171 <varlistentry> 172 173 <term>gpfs:merge_writeappend = [ yes | no ]</term> 174 <listitem> 175 <para> 176 GPFS ACLs doesn't know about the 'APPEND' right. 177 This optionen lets Samba map the 'APPEND' right to 'WRITE'. 178 </para> 179 180 <itemizedlist> 181 <listitem><para> 182 <command>yes(default)</command> - map 'APPEND' to 'WRITE'. 183 </para></listitem> 184 <listitem><para> 185 <command>no</command> - do not map 'APPEND' to 'WRITE'. 186 </para></listitem> 187 </itemizedlist> 188 </listitem> 189 190 </varlistentry> 191 <varlistentry> 192 193 <term>gpfs:refuse_dacl_protected = [ yes | no ]</term> 194 <listitem> 195 <para> 196 As GPFS does not support the ACE4_FLAG_NO_PROPAGATE NFSv4 flag (which would be 197 the mapping for the DESC_DACL_PROTECTED flag), the status of this flag is 198 currently silently ignored by Samba. That means that if you deselect the "Allow 199 inheritable permissions..." checkbox in Windows' ACL dialog and then apply the 200 ACL, the flag will be back immediately. 201 </para> 202 <para> 203 To make sure that automatic migration with e.g. robocopy does not lead to 204 ACLs silently (and unintentionally) changed, you can set 205 <command>gpfs:refuse_dacl_protected = yes</command> to enable an explicit 206 check for this flag and if set, it will return NT_STATUS_NOT_SUPPORTED so 207 errors are shown up on the Windows side and the Administrator is aware of 208 the ACLs not being settable like intended 209 </para> 210 211 <itemizedlist> 212 <listitem><para> 213 <command>no(default)</command> - ignore the DESC_DACL_PROTECTED flags. 214 </para></listitem> 215 <listitem><para> 216 <command>yes</command> - reject ACLs with DESC_DACL_PROTECTED. 217 </para></listitem> 218 </itemizedlist> 219 </listitem> 220 221 </varlistentry> 222 <varlistentry> 223 63 224 <term>nfs4:mode = [ simple | special ]</term> 64 225 <listitem> … … 112 273 <listitem><para><command>yes</command> - Enable chown if as supported by the under filesystem</para></listitem> 113 274 <listitem><para><command>no (default)</command> - Disable chown</para></listitem> 275 </itemizedlist> 276 </listitem> 277 </varlistentry> 278 279 <varlistentry> 280 <term>gpfs:syncio = [yes|no]</term> 281 <listitem> 282 <para>This parameter makes Samba open all files with O_SYNC. 283 This triggers optimizations in GPFS for workloads that 284 heavily share files.</para> 285 286 <para>Following is the behaviour of Samba for different 287 values: 288 </para> 289 <itemizedlist> 290 <listitem><para><command>yes</command>Open files with O_SYNC 291 </para></listitem> 292 <listitem><para><command>no (default)</command>Open files as 293 normal Samba would do 294 </para></listitem> 114 295 </itemizedlist> 115 296 </listitem> … … 135 316 <refsect1> 136 317 <title>CAVEATS</title> 137 <para>The gpfs gpl libraries are required by <command>gpfs</command> VFS 138 module during both compilation and runtime. 139 Also this VFS module is tested to work on SLES 9/10 and RHEL 4.4 318 <para> 319 Depending on the version of gpfs, the <command>libgpfs_gpl</command> 320 library or the <command>libgpfs</command> library is needed at 321 runtime by the <command>gpfs</command> VFS module: 322 Starting with gpfs 3.2.1 PTF8, the complete <command>libgpfs</command> 323 is available as open source and <command>libgpfs_gpl</command> does no 324 longer exist. With earlier versions of gpfs, only the 325 <command>libgpfs_gpl</command> library was open source and could be 326 used at run time. 327 </para> 328 <para> 329 At build time, only the header file <command>gpfs_gpl.h</command> 330 is required , which is a symlink to <command>gpfs.h</command> in 331 gpfs versions newer than 3.2.1 PTF8. 140 332 </para> 141 333 </refsect1>
Note:
See TracChangeset
for help on using the changeset viewer.
