[prev in list] [next in list] [prev in thread] [next in thread] 

List:       coreutils-bug
Subject:    bug#61035: [PATCH] cp: improve help regarding ACLs
From:       Paul Eggert <eggert () cs ! ucla ! edu>
Date:       2023-01-31 21:56:54
Message-ID: fc0eefe6-3074-c4d1-4567-3871cc77ec0b () cs ! ucla ! edu
[Download RAW message or body]

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).


["0001-doc-document-preserve-mode-better.patch" (text/x-patch)]

From 7a8db7dbafc932cb08403b863a1c1edec5d283ca Mon Sep 17 00:00:00 2001
From: Paul Eggert <eggert@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



[prev in list] [next in list] [prev in thread] [next in thread]