1VFS_GPFS(8)                                                        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
28NOTE:This  module  follows the posix-acl behaviour and hence allows permission
29stealing via chown. Samba might allow at a later point in  time,  to  restrict
30the  chown  via this module as such restrictions are the responsibility of the
31underlying filesystem than of Samba.
32
33This module is stackable.
34

OPTIONS

36       nfs4:mode = [ simple | special ]
37          Enable/Disable substitution of special IDs on GPFS.  This  parameter
38          should  not affect the windows users in anyway. It only ensures that
39          Samba sets the special IDs - OWNER@ and GROUP@ ( mappings to  simple
40          uids ) that are relevant to GPFS.
41
42          The following MODEs are understood by the module:
43
44             ·  simple(default) - do not use special IDs in GPFS ACEs
45
46             ·  special - use special IDs in GPFS ACEs.
47
48       nfs4:acedup = [dontcare|reject|ignore|merge]
49          This  parameter  configures how Samba handles duplicate ACEs encoun‐
50          tered in GPFS ACLs. GPFS allows/creates duplicate ACE for  different
51          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       nfs4:chown = [yes|no]
65          This parameter allows enabling or disabling the chown  supported  by
66          the  underlying  filesystem.  This  parameter should be enabled with
67          care as it might leave your system insecure.
68
69          Some filesystems allow chown as a) giving b)  stealing.  It  is  the
70          latter that is considered a risk.
71
72          Following is the behaviour of Samba for different values :
73
74             ·  yes - Enable chown if as supported by the under filesystem
75
76             ·  no (default) - Disable chown
77

EXAMPLES

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

CAVEATS

90       The gpfs gpl libraries are required by gpfs VFS module during both com‐
91       pilation 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
109
110                                                                   VFS_GPFS(8)
Impressum