summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorKamil Dudka <kdudka@redhat.com>2009-02-17 13:16:54 +0100
committerJim Meyering <meyering@redhat.com>2009-02-17 14:12:44 +0100
commitdac5f12c6ed1225bfb8043d9ff7227d29439a955 (patch)
treed736baa51d46a7c6b53fe93aed03acb12c73f27e /doc
parent26d3d090bd08ff36b1f66af8d4b7974c5d5b6a95 (diff)
downloadcoreutils-dac5f12c6ed1225bfb8043d9ff7227d29439a955.tar.gz
install: add --compare (-C) option to install file only when necessary
* src/install.c (have_same_content): New function to compare files content. (extra_mode): New function checking for non-permission bits in mode. (need_copy): New function to check if copy is necessary. (main): Handle new option --compare (-C). (copy_file): Skip file copying if not necessary. (usage): Show new option --compare (-C) in --help. * tests/install/install-C: Basic tests for install --compare (-C). * tests/install/install-C-root: Tests requiring root privileges. * tests/install/install-C-selinux: Tests requiring SELinux. * tests/Makefile.am: Add new tests for install --compare (-C). * doc/coreutils.texi: Document new install option --compare (-C). * NEWS: Mention the change.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 57497e960..ba1e74e30 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2123,6 +2123,14 @@ The program accepts the following options. Also see @ref{Common options}.
@table @samp
+@item -C
+@itemx --compare
+@opindex -C
+@opindex --compare
+Compare each pair of source and destination files, and if the destination has
+identical content and any specified owner, group, permissions, and possibly
+SELinux context, then do not modify the destination at all.
+
@item -c
@itemx --crown-margin
@opindex -c