mirror of
https://git.savannah.gnu.org/git/coreutils.git
synced 2026-11-17 18:02:09 +03:00
doc: clarify the example for cp --preserve=links
* doc/coreutils.texi (cp invocation): Give more detail about what's happening in the example, explicitly calling out the --no-dereference option required to make the -H and -L options significant. Also mention the option order significance of the -H and -L options. Fixes http://bugs.gnu.org/15579
This commit is contained in:
1 parent
cba81e7b84
commit
bae9c38410
1 file changed
+5
-3
+5
-3
@@ -8257,9 +8257,11 @@ $ mkdir c; : > a; ln -s a b; cp -aH a b c; ls -i1 c
|
||||
@noindent
|
||||
Note the inputs: @file{b} is a symlink to regular file @file{a},
|
||||
yet the files in destination directory, @file{c/}, are hard-linked.
|
||||
Since @option{-a} implies @option{--preserve=links}, and since @option{-H}
|
||||
tells @command{cp} to dereference command line arguments, it sees two files
|
||||
with the same inode number, and preserves the perceived hard link.
|
||||
Since @option{-a} implies @option{--no-dereference} it would copy the symlink,
|
||||
but the later @option{-H} tells @command{cp} to dereference the command line
|
||||
arguments where it then sees two files with the same inode number.
|
||||
Then the @option{--preserve=links} option also implied by @option{-a}
|
||||
will preserve the perceived hard link.
|
||||
|
||||
Here is a similar example that exercises @command{cp}'s @option{-L} option:
|
||||
@smallexample
|
||||
|
||||
Reference in new issue
Block a user