1VFS_GPFS(8)               System Administration tools              VFS_GPFS(8)
2
3
4

NAME

6       vfs_gpfs - gpfs specific samba extensions like acls and prealloc
7

SYNOPSIS

9       vfs objects = gpfs
10

DESCRIPTION

12       This VFS module is part of the samba(7) suite.
13
14       The gpfs VFS module is the home for all gpfs extensions that Samba
15       requires for proper integration with GPFS. It uses the GPL library
16       interfaces provided by GPFS.
17
18       Currently the gpfs vfs module provides extensions in following areas :
19
20       ·   NFSv4 ACL Interfaces with configurable options for GPFS
21
22       ·   Kernel oplock support on GPFS
23
24       ·   Lease support on GPFS
25
26
27       NOTE:This module follows the posix-acl behaviour and hence allows
28       permission stealing via chown. Samba might allow at a later point in
29       time, to restrict the chown via this module as such restrictions are
30       the responsibility of the underlying filesystem than of Samba.
31
32       This module is stackable.
33

OPTIONS

35       nfs4:mode = [ simple | special ]
36           Enable/Disable substitution of special IDs on GPFS. This parameter
37           should not affect the windows users in anyway. It only ensures that
38           Samba sets the special IDs - OWNER@ and GROUP@ ( mappings to simple
39           uids ) that are relevant to GPFS.
40
41           The following MODEs are understood by the module:
42
43           ·   simple(default) - do not use special IDs in GPFS ACEs
44
45           ·   special - use special IDs in GPFS ACEs.
46
47
48       nfs4:acedup = [dontcare|reject|ignore|merge]
49           This parameter configures how Samba handles duplicate ACEs
50           encountered in GPFS ACLs. GPFS allows/creates duplicate ACE for
51           different bits for same ID.
52
53           Following is the behaviour of Samba for different values :
54
55           ·   dontcare (default) - copy the ACEs as they come
56
57           ·   reject - stop operation and exit with error on ACL set op
58
59           ·   ignore - don´t include the second matching ACE
60
61           ·   merge - bitwise OR the 2 ace.flag fields and 2 ace.mask fields
62               of the 2 duplicate ACEs into 1 ACE
63
64
65       nfs4:chown = [yes|no]
66           This parameter allows enabling or disabling the chown supported by
67           the underlying filesystem. This parameter should be enabled with
68           care as it might leave your system insecure.
69
70           Some filesystems allow chown as a) giving b) stealing. It is the
71           latter that is considered a risk.
72
73           Following is the behaviour of Samba for different values :
74
75           ·   yes - Enable chown if as supported by the under filesystem
76
77           ·   no (default) - Disable chown
78
79

EXAMPLES

81       A GPFS mount can be exported via Samba as follows :
82
83                   [samba_gpfs_share]
84                vfs objects = gpfs
85                path = /test/gpfs_mount
86                nfs4: mode = special
87                nfs4: acedup = merge
88

CAVEATS

90       The gpfs gpl libraries are required by gpfs VFS module during both
91       compilation and runtime. Also this VFS module is tested to work on SLES
92       9/10 and RHEL 4.4
93

VERSION

95       This man page is correct for version 3.0.25 of the Samba suite.
96

AUTHOR

98       The original Samba software and related utilities were created by
99       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
100       Source project similar to the way the Linux kernel is developed.
101
102       The GPFS VFS module was created with contributions from Volker Lendecke
103       and the developers at IBM.
104
105       This manpage was created by the IBM FSCC team
106
107
108
109Samba 3.5                         08/02/2011                       VFS_GPFS(8)
Impressum