From 4f5791ebd03eaec1c7da0865a383175b05102712 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 5 May 2024 19:47:29 +0200 Subject: Adding upstream version 2:4.17.12+dfsg. Signed-off-by: Daniel Baumann --- docs-xml/manpages/vfs_nfs4acl_xattr.8.xml | 172 ++++++++++++++++++++++++++++++ 1 file changed, 172 insertions(+) create mode 100644 docs-xml/manpages/vfs_nfs4acl_xattr.8.xml (limited to 'docs-xml/manpages/vfs_nfs4acl_xattr.8.xml') diff --git a/docs-xml/manpages/vfs_nfs4acl_xattr.8.xml b/docs-xml/manpages/vfs_nfs4acl_xattr.8.xml new file mode 100644 index 0000000..d4ce40b --- /dev/null +++ b/docs-xml/manpages/vfs_nfs4acl_xattr.8.xml @@ -0,0 +1,172 @@ + + + + + + + vfs_nfs4acl_xattr + 8 + Samba + System Administration tools + &doc.version; + + + + + vfs_nfs4acl_xattr + Save NTFS-ACLs as NFS4 encoded blobs in extended + attributes + + + + + vfs objects = nfs4acl_xattr + + + + + DESCRIPTION + + This VFS module is part of the + samba + 7 suite. + + The vfs_acl_xattr VFS module stores NTFS Access + Control Lists (ACLs) in Extended Attributes (EAs/xattrs). This enables the + full mapping of Windows ACLs on Samba servers. + + + This module is stackable. + + + + + OPTIONS + + + + + + + nfs4acl_xattr:encoding = [nfs|ndr|xdr] + + This parameter configures the marshaling format used in the ACL + blob and the default extended attribute name used to store the blob. + + + When set to nfs - fetch and store the NT + ACL in NFS 4.0 or 4.1 compatible XDR encoding. By default this uses + the extended attribute "system.nfs4_acl". This setting also + disables validate_mode. + + When set to ndr (default) - store the NT + ACL with POSIX draft NFSv4 compatible NDR encoding. By default this + uses the extended attribute "security.nfs4acl_ndr". + + When set to xdr - store the NT ACL in a + format similar to NFS 4.1 RFC 5661 in XDR encoding. The main + differences to RFC 5661 are the use of ids instead of strings as users + and group identifiers and an additional attribute per nfsace4. By + default this encoding stores the blob in the extended attribute + "security.nfs4acl_xdr". + + + + + nfs4acl_xattr:version = [40|41] + + This parameter configures the NFS4 ACL level. Only + 41 fully supports mapping NT ACLs and should be + used. The default is 41. + + + + + nfs4acl_xattr:default acl style = [posix|windows|everyone] + + This parameter determines the type of ACL that is synthesized in + case a file or directory lacks an ACL extended attribute. + + When set to posix, an ACL will be + synthesized based on the POSIX mode permissions for user, group and + others, with an additional ACE for NT + Authority\SYSTEM will full rights. + + When set to windows, an ACL is synthesized + the same way Windows does it, only including permissions for the owner + and NT Authority\SYSTEM. + + When set to everyone, an ACL is synthesized + giving full permissions to everyone (S-1-1-0). + + The default for this option is + everyone. + + + + + nfs4acl_xattr:xattr_name = STRING + + This parameter configures the extended attribute name used to + store the marshaled ACL. + The default depends on the setting for + nfs4acl_xattr:encoding. + + + + + nfs4acl_xattr:nfs4_id_numeric = yes|no (default: no) + + This parameter tells the module how the NFS4 server encodes user + and group identifiers on the network. With the default setting the + module expects identifiers encoded as per the NFS4 RFC as + user@domain. + When set to yes, the module expects the + identifiers as numeric string. + The default for this optionsno. + + + + + nfs4acl_xattr:validate_mode = yes|no + + This parameter configures whether the module enforces the POSIX + mode is set to 0777 for directories and 0666 for files. If this + constrained is not met, the xattr with the ACL blob is + discarded. + The default depends on the setting for + nfs4acl_xattr:encoding: when set to + nfs this setting is disabled by default, + otherwise it is enabled. + + + + + + + + EXAMPLES + + A directory can be exported via Samba using this module as + follows: + + + + nfs4acl_xattr + /foo/bar + + + + + AUTHOR + + The original Samba software and related utilities + were created by Andrew Tridgell. Samba is now developed + by the Samba Team as an Open Source project similar + to the way the Linux kernel is developed. + + + + -- cgit v1.2.3