← Back to branch summary

~ubuntu-branches/ubuntu/vivid/samba/vivid

« back to all changes in this revision

Viewing changes to docs/manpages/vfs_gpfs.8

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2011-12-21 13:18:04 UTC
  • mfrom: (0.39.21 sid)
  • Revision ID: package-import@ubuntu.com-20111221131804-xtlr39wx6njehxxr
Tags: 2:3.6.1-3ubuntu1
* Merge from Debian testing.  Remaining changes:
  + debian/patches/VERSION.patch:
    - set SAMBA_VERSION_SUFFIX to Ubuntu.
  + debian/patches/error-trans.fix-276472:
    - Add the translation of Unix Error code -ENOTSUP to NT Error Code
    - NT_STATUS_NOT_SUPPORTED to prevent the Permission denied error.
  + debian/smb.conf:
    - add "(Samba, Ubuntu)" to server string.
    - comment out the default [homes] share, and add a comment about
      "valid users = %S" to show users how to restrict access to
      \\server\username to only username.
    - Set 'usershare allow guests', so that usershare admins are 
      allowed to create public shares in addition to authenticated
      ones.
    - add map to guest = Bad user, maps bad username to guest access.
  + debian/samba-common.config:
    - Do not change priority to high if dhclient3 is installed.
    - Use priority medium instead of high for the workgroup question.
  + debian/control:
    - Don't build against or suggest ctdb.
    - Add dependency on samba-common-bin to samba.
  + Add ufw integration:
    - Created debian/samba.ufw.profile
    - debian/rules, debian/samba.dirs, debian/samba.files: install
      profile
    - debian/control: have samba suggest ufw
  + Add apport hook:
    - Created debian/source_samba.py.
    - debian/rules, debian/samba.dirs, debian/samba-common-bin.files: install
  + Switch to upstart:
    - Add debian/samba.{nmbd,smbd}.upstart.
  + debian/samba.logrotate, debian/samba-common.dhcp, debian/samba.if-up:
    - Make them upstart compatible
  + debian/samba.postinst: 
    - Avoid scary pdbedit warnings on first import.
  + debian/samba-common.postinst: Add more informative error message for
    the case where smb.conf was manually deleted
  + debian/patches/fix-debuglevel-name-conflict.patch: don't use 'debug_level'
    as a global variable name in an NSS module 
  + Dropped:
    - debian/patches/error-trans.fix-276472
    - debian/patches/fix-debuglevel-name-conflict.patch

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/manpages/vfs_gpfs.8
2
2
.\"     Title: vfs_gpfs
3
3
.\"    Author: [see the "AUTHOR" section]
4
4
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5
 
.\"      Date: 08/02/2011
 
5
.\"      Date: 10/18/2011
6
6
.\"    Manual: System Administration tools
7
 
.\"    Source: Samba 3.5
 
7
.\"    Source: Samba 3.6
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "VFS_GPFS" "8" "08/02/2011" "Samba 3\&.5" "System Administration tools"
 
10
.TH "VFS_GPFS" "8" "10/18/2011" "Samba 3\&.6" "System Administration tools"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * set default formatting
13
13
.\" -----------------------------------------------------------------
66
66
.IP \(bu 2.3
67
67
.\}
68
68
Lease support on GPFS
 
69
.RE
69
70
.sp
70
71
.RE
71
72
.PP
74
75
This module is stackable\&.
75
76
.SH "OPTIONS"
76
77
.PP
 
78
gpfs:sharemodes = [ yes | no ]
 
79
.RS 4
 
80
Enable/Disable cross node sharemode handling for GPFS\&.
 
81
.sp
 
82
.RS 4
 
83
.ie n \{\
 
84
\h'-04'\(bu\h'+03'\c
 
85
.\}
 
86
.el \{\
 
87
.sp -1
 
88
.IP \(bu 2.3
 
89
.\}
 
90
 
 
91
yes(default)
 
92
\- propagate sharemodes across all GPFS nodes\&.
 
93
.RE
 
94
.sp
 
95
.RS 4
 
96
.ie n \{\
 
97
\h'-04'\(bu\h'+03'\c
 
98
.\}
 
99
.el \{\
 
100
.sp -1
 
101
.IP \(bu 2.3
 
102
.\}
 
103
 
 
104
no
 
105
\- 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\&.
 
106
.RE
 
107
.sp
 
108
.RE
 
109
.RE
 
110
.PP
 
111
gpfs:leases = [ yes | no ]
 
112
.RS 4
 
113
Enable/Disable cross node leases (oplocks) for GPFS\&. You should also set the
 
114
oplocks
 
115
and
 
116
kernel oplocks
 
117
options to the same value\&.
 
118
.sp
 
119
.RS 4
 
120
.ie n \{\
 
121
\h'-04'\(bu\h'+03'\c
 
122
.\}
 
123
.el \{\
 
124
.sp -1
 
125
.IP \(bu 2.3
 
126
.\}
 
127
 
 
128
yes(default)
 
129
\- propagate leases across all GPFS nodes\&.
 
130
.RE
 
131
.sp
 
132
.RS 4
 
133
.ie n \{\
 
134
\h'-04'\(bu\h'+03'\c
 
135
.\}
 
136
.el \{\
 
137
.sp -1
 
138
.IP \(bu 2.3
 
139
.\}
 
140
 
 
141
no
 
142
\- 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\&.
 
143
.RE
 
144
.sp
 
145
.RE
 
146
.RE
 
147
.PP
 
148
gpfs:hsm = [ yes | no ]
 
149
.RS 4
 
150
Enable/Disable announcing if this FS has HSM enabled\&.
 
151
.sp
 
152
.RS 4
 
153
.ie n \{\
 
154
\h'-04'\(bu\h'+03'\c
 
155
.\}
 
156
.el \{\
 
157
.sp -1
 
158
.IP \(bu 2.3
 
159
.\}
 
160
 
 
161
no(default)
 
162
\- Do not announce HSM\&.
 
163
.RE
 
164
.sp
 
165
.RS 4
 
166
.ie n \{\
 
167
\h'-04'\(bu\h'+03'\c
 
168
.\}
 
169
.el \{\
 
170
.sp -1
 
171
.IP \(bu 2.3
 
172
.\}
 
173
 
 
174
no
 
175
\- Announce HSM\&.
 
176
.RE
 
177
.sp
 
178
.RE
 
179
.RE
 
180
.PP
 
181
gpfs:getrealfilename = [ yes | no ]
 
182
.RS 4
 
183
Enable/Disable usage of the
 
184
gpfs_get_realfilename_path()
 
185
function\&. This improves the casesensitive wildcard file name access\&.
 
186
.sp
 
187
.RS 4
 
188
.ie n \{\
 
189
\h'-04'\(bu\h'+03'\c
 
190
.\}
 
191
.el \{\
 
192
.sp -1
 
193
.IP \(bu 2.3
 
194
.\}
 
195
 
 
196
yes(default)
 
197
\- use
 
198
gpfs_get_realfilename_path()\&.
 
199
.RE
 
200
.sp
 
201
.RS 4
 
202
.ie n \{\
 
203
\h'-04'\(bu\h'+03'\c
 
204
.\}
 
205
.el \{\
 
206
.sp -1
 
207
.IP \(bu 2.3
 
208
.\}
 
209
 
 
210
no
 
211
\- do not use
 
212
gpfs_get_realfilename_path()\&. It seems that
 
213
gpfs_get_realfilename_path()
 
214
doesn\'t work on AIX\&.
 
215
.RE
 
216
.sp
 
217
.RE
 
218
.RE
 
219
.PP
 
220
gpfs:winattr = [ yes | no ]
 
221
.RS 4
 
222
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\&.
 
223
.sp
 
224
.RS 4
 
225
.ie n \{\
 
226
\h'-04'\(bu\h'+03'\c
 
227
.\}
 
228
.el \{\
 
229
.sp -1
 
230
.IP \(bu 2.3
 
231
.\}
 
232
 
 
233
no(default)
 
234
\- do not use GPFS windows attributes\&.
 
235
.RE
 
236
.sp
 
237
.RS 4
 
238
.ie n \{\
 
239
\h'-04'\(bu\h'+03'\c
 
240
.\}
 
241
.el \{\
 
242
.sp -1
 
243
.IP \(bu 2.3
 
244
.\}
 
245
 
 
246
yes
 
247
\- use GPFS windows attributes\&.
 
248
.RE
 
249
.sp
 
250
.RE
 
251
.RE
 
252
.PP
 
253
gpfs:merge_writeappend = [ yes | no ]
 
254
.RS 4
 
255
GPFS ACLs doesn\'t know about the \'APPEND\' right\&. This optionen lets Samba map the \'APPEND\' right to \'WRITE\'\&.
 
256
.sp
 
257
.RS 4
 
258
.ie n \{\
 
259
\h'-04'\(bu\h'+03'\c
 
260
.\}
 
261
.el \{\
 
262
.sp -1
 
263
.IP \(bu 2.3
 
264
.\}
 
265
 
 
266
yes(default)
 
267
\- map \'APPEND\' to \'WRITE\'\&.
 
268
.RE
 
269
.sp
 
270
.RS 4
 
271
.ie n \{\
 
272
\h'-04'\(bu\h'+03'\c
 
273
.\}
 
274
.el \{\
 
275
.sp -1
 
276
.IP \(bu 2.3
 
277
.\}
 
278
 
 
279
no
 
280
\- do not map \'APPEND\' to \'WRITE\'\&.
 
281
.RE
 
282
.sp
 
283
.RE
 
284
.RE
 
285
.PP
 
286
gpfs:refuse_dacl_protected = [ yes | no ]
 
287
.RS 4
 
288
As GPFS does not support the ACE4_FLAG_NO_PROPAGATE NFSv4 flag (which would be the mapping for the DESC_DACL_PROTECTED flag), the status of this flag is currently silently ignored by Samba\&. That means that if you deselect the "Allow inheritable permissions\&.\&.\&." checkbox in Windows\' ACL dialog and then apply the ACL, the flag will be back immediately\&.
 
289
.sp
 
290
To make sure that automatic migration with e\&.g\&. robocopy does not lead to ACLs silently (and unintentionally) changed, you can set
 
291
gpfs:refuse_dacl_protected = yes
 
292
to enable an explicit check for this flag and if set, it will return NT_STATUS_NOT_SUPPORTED so errors are shown up on the Windows side and the Administrator is aware of the ACLs not being settable like intended
 
293
.sp
 
294
.RS 4
 
295
.ie n \{\
 
296
\h'-04'\(bu\h'+03'\c
 
297
.\}
 
298
.el \{\
 
299
.sp -1
 
300
.IP \(bu 2.3
 
301
.\}
 
302
 
 
303
no(default)
 
304
\- ignore the DESC_DACL_PROTECTED flags\&.
 
305
.RE
 
306
.sp
 
307
.RS 4
 
308
.ie n \{\
 
309
\h'-04'\(bu\h'+03'\c
 
310
.\}
 
311
.el \{\
 
312
.sp -1
 
313
.IP \(bu 2.3
 
314
.\}
 
315
 
 
316
yes
 
317
\- reject ACLs with DESC_DACL_PROTECTED\&.
 
318
.RE
 
319
.sp
 
320
.RE
 
321
.RE
 
322
.PP
77
323
nfs4:mode = [ simple | special ]
78
324
.RS 4
79
325
Enable/Disable substitution of special IDs on GPFS\&. This parameter should not affect the windows users in anyway\&. It only ensures that Samba sets the special IDs \- OWNER@ and GROUP@ ( mappings to simple uids ) that are relevant to GPFS\&.
102
348
.\}
103
349
special
104
350
\- use special IDs in GPFS ACEs\&.
 
351
.RE
105
352
.sp
106
353
.RE
107
354
.RE
158
405
.\}
159
406
merge
160
407
\- bitwise OR the 2 ace\&.flag fields and 2 ace\&.mask fields of the 2 duplicate ACEs into 1 ACE
 
408
.RE
161
409
.sp
162
410
.RE
163
411
.RE
192
440
.\}
193
441
no (default)
194
442
\- Disable chown
 
443
.RE
 
444
.sp
 
445
.RE
 
446
.RE
 
447
.PP
 
448
gpfs:syncio = [yes|no]
 
449
.RS 4
 
450
This parameter makes Samba open all files with O_SYNC\&. This triggers optimizations in GPFS for workloads that heavily share files\&.
 
451
.sp
 
452
Following is the behaviour of Samba for different values:
 
453
.sp
 
454
.RS 4
 
455
.ie n \{\
 
456
\h'-04'\(bu\h'+03'\c
 
457
.\}
 
458
.el \{\
 
459
.sp -1
 
460
.IP \(bu 2.3
 
461
.\}
 
462
yesOpen files with O_SYNC
 
463
.RE
 
464
.sp
 
465
.RS 4
 
466
.ie n \{\
 
467
\h'-04'\(bu\h'+03'\c
 
468
.\}
 
469
.el \{\
 
470
.sp -1
 
471
.IP \(bu 2.3
 
472
.\}
 
473
no (default)Open files as normal Samba would do
 
474
.RE
195
475
.sp
196
476
.RE
197
477
.RE
214
494
.\}
215
495
.SH "CAVEATS"
216
496
.PP
217
 
The gpfs gpl libraries are required by
 
497
Depending on the version of gpfs, the
 
498
libgpfs_gpl
 
499
library or the
 
500
libgpfs
 
501
library is needed at runtime by the
218
502
gpfs
219
 
VFS module during both compilation and runtime\&. Also this VFS module is tested to work on SLES 9/10 and RHEL 4\&.4
 
503
VFS module: Starting with gpfs 3\&.2\&.1 PTF8, the complete
 
504
libgpfs
 
505
is available as open source and
 
506
libgpfs_gpl
 
507
does no longer exist\&. With earlier versions of gpfs, only the
 
508
libgpfs_gpl
 
509
library was open source and could be used at run time\&.
 
510
.PP
 
511
At build time, only the header file
 
512
gpfs_gpl\&.h
 
513
is required , which is a symlink to
 
514
gpfs\&.h
 
515
in gpfs versions newer than 3\&.2\&.1 PTF8\&.
220
516
.SH "VERSION"
221
517
.PP
222
518
This man page is correct for version 3\&.0\&.25 of the Samba suite\&.