1This patch has been taken against SAMBA_3_0 Release 20028. 2 3The patch basically moves the GPFS-ACL functionalities into the new GPFS VFS module( vfs_gpfs ). 4 5Please read SAMBA_3_0/source/modules/README.nfs4acls.txt - generalised README file on Samba support for NFS4-ACLS. 6This README file is specific for GPFS only. 7 8Configuring GPFS ACL support 9=============================== 10 11Binary: (default install path is [samba]/lib/vfs/) 12- gpfs.so 13 14Its compiled by default, no additional configure option needed. 15 16To enable/use/load this module, include "vfs objects = gpfs" in the smb.conf file under concerned share-name. 17 18Example of smb.conf: 19 20[smbtest] 21path = /gpfs-test 22vfs objects = gpfs 23nfs4: mode = special 24nfs4: chown = yes 25nfs4: acedup = merge 26 27Adding "vfs objects = gpfs" to a share should be done only in case when NFS4 is really supported by the filesystem. 28(Otherwise you may get performance loss.) 29 30================================================== 31Below are some limitations listed for this module: 32================================================== 331. When a child file or child directory is created, the results are a bit different from windows as specified below: 34 35Eg: Prent directory is set to have 2 ACES - full access for owner and everyone 36 37Default ACL for Windows: 2 aces: allow ACE for owner and everyone 38Default ACL for GPFS: 6 aces: allow and deny ACEs for owner, group and everyone 39 40The below mentioned inheritance flags and its combinations are applied only to the owner ACE and not to everyone ACE 41 42"fi"------>File Inherit 43"di"------>Directory Inherit 44"oi"------>Inherit Only 45 46 47Parent dir: no inheritance flag set 48 Windows: index=0: GPFS(special mode): index=0: GPFS(simple mode): index=0: 49child File: default acl: 2 aces child file: default acl: 6 aces child file: default acl: 6 aces 50child dir: default acl: 2 aces child dir: default acl: 6 aces child dir: default acl: 6 aces 51 52 53Parent dir: "fi" flag set 54 Windows: index=1: GPFS(special mode): index=1: GPFS(simple mode): index=1: 55child file: no flag set child file: "fi" flag set child file: default acl: 6 aces 56child dir: "fioi" flag set child dir: "fi" flag set child dir: "fi" flag set 57 58 59Parent dir: "di" flag set 60 Windows: index=2: GPFS(special mode): index=2: GPFS(simple mode): index=2: 61child file: default acl: 2 aces child file: default acl: 6 aces child file: default acl: 6 aces 62 63 64Parent dir: "fidi" flag set 65 Windows: index=3: GPFS(special mode): index=3: GPFS(simple mode): index=3: 66child file: no flag set child file: "fidi" flag set child file: default acl: 6 aces 67 68 69Parent dir: "fioi" flag set 70 Windows: index=4: GPFS(special mode): index=4: GPFS(simple mode): index=4: 71child file: no flag set child file: "fi" flag set child file: default acl: 6 aces 72child dir: "fioi" flag set child dir: "fi" flag set child dir: "fi" flag set 73 74 75Parent dir: "dioi" flag set 76 Windows: index=5: GPFS(special mode): index=5: GPFS(simple mode): index=5: 77child file: default acl: 2 aces child file: default acl: 6 aces child file: default acl: 6 aces 78 79 80Parent dir: "fidioi" flag set 81 Windows: index=6: GPFS(special mode): index=6: GPFS(simple mode): index=6: 82child file: no flag set child file: "fidi" flag set child file: default acl: 6 aces 83