On 1/31/23 13:23, Ondrej Valousek wrote:
Yes, that's nice, thanks!
However I think it would be also fair to mention that ACLs will not be
converted/translated (I.e. no posix to nfsv4 or vice versa). We are not that
clever.
OK, I installed that along with the attached further patch to talk about
ACL translation (this can be in the manual rather than the man page as
it's reasonably obscure).From 7a8db7dbafc932cb08403b863a1c1edec5d283ca Mon Sep 17 00:00:00 2001
From: Paul Eggert <egg...@cs.ucla.edu>
Date: Tue, 31 Jan 2023 13:52:39 -0800
Subject: [PATCH] doc: document --preserve=mode better
* doc/coreutils.texi: Spruce up cp --preserve=mode doc.
---
doc/coreutils.texi | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 143b93de9..97c5280d3 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8972,7 +8972,13 @@ of one or more of the following strings:
@table @samp
@item mode
-Preserve the file mode bits and access control lists.
+@cindex access control lists (ACLs)
+Preserve attributes relevant to access permissions,
+including file mode bits and (if possible) access control lists (ACLs).
+ACL preservation is system-dependent, and ACLs are not necessarily
+translated when the source and destination are on file systems with
+different ACL formats (e.g., NFSv4 versus POSIX formats).
+
@item ownership
Preserve the owner and group. On most modern systems,
only users with appropriate privileges may change the owner of a file,
@@ -9014,6 +9020,7 @@ $ mkdir b c; (cd b; : > a; ln -s a b); cp -aL b c; ls -i1 c/b
@item context
Preserve SELinux security context of the file, or fail with full diagnostics.
@item xattr
+@cindex access control lists (ACLs)
Preserve extended attributes of the file, or fail with full diagnostics.
If @command{cp} is built without xattr support, ignore this option.
If SELinux context, ACLs or Capabilities are implemented using xattrs,
--
2.39.1
