1 /* cp.c -- file copying (main routines)
2 Copyright (C) 1989-2016 Free Software Foundation, Inc.
4 This program is free software: you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation, either version 3 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program. If not, see <http://www.gnu.org/licenses/>.
17 Written by Torbjorn Granlund, David MacKenzie, and Jim Meyering. */
21 #include <sys/types.h>
23 #include <selinux/selinux.h>
27 #include "backupfile.h"
31 #include "filenamecat.h"
32 #include "ignore-value.h"
34 #include "stat-time.h"
39 # define lchown(name, uid, gid) chown (name, uid, gid)
42 #define ASSIGN_BASENAME_STRDUPA(Dest, File_name) \
46 ASSIGN_STRDUPA (tmp_abns_, (File_name)); \
47 Dest = last_component (tmp_abns_); \
48 strip_trailing_slashes (Dest); \
52 /* The official name of this program (e.g., no 'g' prefix). */
53 #define PROGRAM_NAME "cp"
56 proper_name_utf8 ("Torbjorn Granlund", "Torbj\303\266rn Granlund"), \
57 proper_name ("David MacKenzie"), \
58 proper_name ("Jim Meyering")
60 /* Used by do_copy, make_dir_parents_private, and re_protect
61 to keep a list of leading directories whose protections
62 need to be fixed after copying. */
68 struct dir_attr
*next
;
71 /* For long options that have no equivalent short option, use a
72 non-character as a pseudo short option, starting with CHAR_MAX + 1. */
75 ATTRIBUTES_ONLY_OPTION
= CHAR_MAX
+ 1,
77 NO_PRESERVE_ATTRIBUTES_OPTION
,
79 PRESERVE_ATTRIBUTES_OPTION
,
82 STRIP_TRAILING_SLASHES_OPTION
,
83 UNLINK_DEST_BEFORE_OPENING
86 /* True if the kernel is SELinux enabled. */
87 static bool selinux_enabled
;
89 /* If true, the command "cp x/e_file e_dir" uses "e_dir/x/e_file"
90 as its destination instead of the usual "e_dir/e_file." */
91 static bool parents_option
= false;
93 /* Remove any trailing slashes from each SOURCE argument. */
94 static bool remove_trailing_slashes
;
96 static char const *const sparse_type_string
[] =
98 "never", "auto", "always", NULL
100 static enum Sparse_type
const sparse_type
[] =
102 SPARSE_NEVER
, SPARSE_AUTO
, SPARSE_ALWAYS
104 ARGMATCH_VERIFY (sparse_type_string
, sparse_type
);
106 static char const *const reflink_type_string
[] =
108 "auto", "always", NULL
110 static enum Reflink_type
const reflink_type
[] =
112 REFLINK_AUTO
, REFLINK_ALWAYS
114 ARGMATCH_VERIFY (reflink_type_string
, reflink_type
);
116 static struct option
const long_opts
[] =
118 {"archive", no_argument
, NULL
, 'a'},
119 {"attributes-only", no_argument
, NULL
, ATTRIBUTES_ONLY_OPTION
},
120 {"backup", optional_argument
, NULL
, 'b'},
121 {"copy-contents", no_argument
, NULL
, COPY_CONTENTS_OPTION
},
122 {"dereference", no_argument
, NULL
, 'L'},
123 {"force", no_argument
, NULL
, 'f'},
124 {"interactive", no_argument
, NULL
, 'i'},
125 {"link", no_argument
, NULL
, 'l'},
126 {"no-clobber", no_argument
, NULL
, 'n'},
127 {"no-dereference", no_argument
, NULL
, 'P'},
128 {"no-preserve", required_argument
, NULL
, NO_PRESERVE_ATTRIBUTES_OPTION
},
129 {"no-target-directory", no_argument
, NULL
, 'T'},
130 {"one-file-system", no_argument
, NULL
, 'x'},
131 {"parents", no_argument
, NULL
, PARENTS_OPTION
},
132 {"path", no_argument
, NULL
, PARENTS_OPTION
}, /* Deprecated. */
133 {"preserve", optional_argument
, NULL
, PRESERVE_ATTRIBUTES_OPTION
},
134 {"recursive", no_argument
, NULL
, 'R'},
135 {"remove-destination", no_argument
, NULL
, UNLINK_DEST_BEFORE_OPENING
},
136 {"sparse", required_argument
, NULL
, SPARSE_OPTION
},
137 {"reflink", optional_argument
, NULL
, REFLINK_OPTION
},
138 {"strip-trailing-slashes", no_argument
, NULL
, STRIP_TRAILING_SLASHES_OPTION
},
139 {"suffix", required_argument
, NULL
, 'S'},
140 {"symbolic-link", no_argument
, NULL
, 's'},
141 {"target-directory", required_argument
, NULL
, 't'},
142 {"update", no_argument
, NULL
, 'u'},
143 {"verbose", no_argument
, NULL
, 'v'},
144 {GETOPT_SELINUX_CONTEXT_OPTION_DECL
},
145 {GETOPT_HELP_OPTION_DECL
},
146 {GETOPT_VERSION_OPTION_DECL
},
153 if (status
!= EXIT_SUCCESS
)
158 Usage: %s [OPTION]... [-T] SOURCE DEST\n\
159 or: %s [OPTION]... SOURCE... DIRECTORY\n\
160 or: %s [OPTION]... -t DIRECTORY SOURCE...\n\
162 program_name
, program_name
, program_name
);
164 Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY.\n\
167 emit_mandatory_arg_note ();
170 -a, --archive same as -dR --preserve=all\n\
171 --attributes-only don't copy the file data, just the attributes\n\
172 --backup[=CONTROL] make a backup of each existing destination file\
174 -b like --backup but does not accept an argument\n\
175 --copy-contents copy contents of special files when recursive\n\
176 -d same as --no-dereference --preserve=links\n\
179 -f, --force if an existing destination file cannot be\n\
180 opened, remove it and try again (this option\n\
181 is ignored when the -n option is also used)\n\
182 -i, --interactive prompt before overwrite (overrides a previous -n\
185 -H follow command-line symbolic links in SOURCE\n\
188 -l, --link hard link files instead of copying\n\
189 -L, --dereference always follow symbolic links in SOURCE\n\
192 -n, --no-clobber do not overwrite an existing file (overrides\n\
193 a previous -i option)\n\
194 -P, --no-dereference never follow symbolic links in SOURCE\n\
197 -p same as --preserve=mode,ownership,timestamps\n\
198 --preserve[=ATTR_LIST] preserve the specified attributes (default:\n\
199 mode,ownership,timestamps), if possible\n\
200 additional attributes: context, links, xattr,\
205 --no-preserve=ATTR_LIST don't preserve the specified attributes\n\
206 --parents use full source file name under DIRECTORY\n\
209 -R, -r, --recursive copy directories recursively\n\
210 --reflink[=WHEN] control clone/CoW copies. See below\n\
211 --remove-destination remove each existing destination file before\n\
212 attempting to open it (contrast with --force)\
215 --sparse=WHEN control creation of sparse files. See below\n\
216 --strip-trailing-slashes remove any trailing slashes from each SOURCE\n\
220 -s, --symbolic-link make symbolic links instead of copying\n\
221 -S, --suffix=SUFFIX override the usual backup suffix\n\
222 -t, --target-directory=DIRECTORY copy all SOURCE arguments into DIRECTORY\n\
223 -T, --no-target-directory treat DEST as a normal file\n\
226 -u, --update copy only when the SOURCE file is newer\n\
227 than the destination file or when the\n\
228 destination file is missing\n\
229 -v, --verbose explain what is being done\n\
230 -x, --one-file-system stay on this file system\n\
233 -Z set SELinux security context of destination\n\
234 file to default type\n\
235 --context[=CTX] like -Z, or if CTX is specified then set the\n\
236 SELinux or SMACK security context to CTX\n\
238 fputs (HELP_OPTION_DESCRIPTION
, stdout
);
239 fputs (VERSION_OPTION_DESCRIPTION
, stdout
);
242 By default, sparse SOURCE files are detected by a crude heuristic and the\n\
243 corresponding DEST file is made sparse as well. That is the behavior\n\
244 selected by --sparse=auto. Specify --sparse=always to create a sparse DEST\n\
245 file whenever the SOURCE file contains a long enough sequence of zero bytes.\n\
246 Use --sparse=never to inhibit creation of sparse files.\n\
248 When --reflink[=always] is specified, perform a lightweight copy, where the\n\
249 data blocks are copied only when modified. If this is not possible the copy\n\
250 fails, or if --reflink=auto is specified, fall back to a standard copy.\n\
254 The backup suffix is '~', unless set with --suffix or SIMPLE_BACKUP_SUFFIX.\n\
255 The version control method may be selected via the --backup option or through\n\
256 the VERSION_CONTROL environment variable. Here are the values:\n\
260 none, off never make backups (even if --backup is given)\n\
261 numbered, t make numbered backups\n\
262 existing, nil numbered if numbered backups exist, simple otherwise\n\
263 simple, never always make simple backups\n\
267 As a special case, cp makes a backup of SOURCE when the force and backup\n\
268 options are given and SOURCE and DEST are the same name for an existing,\n\
271 emit_ancillary_info (PROGRAM_NAME
);
276 /* Ensure that the parent directories of CONST_DST_NAME have the
277 correct protections, for the --parents option. This is done
278 after all copying has been completed, to allow permissions
279 that don't include user write/execute.
281 SRC_OFFSET is the index in CONST_DST_NAME of the beginning of the
282 source directory name.
284 ATTR_LIST is a null-terminated linked list of structures that
285 indicates the end of the filename of each intermediate directory
286 in CONST_DST_NAME that may need to have its attributes changed.
287 The command 'cp --parents --preserve a/b/c d/e_dir' changes the
288 attributes of the directories d/e_dir/a and d/e_dir/a/b to match
289 the corresponding source directories regardless of whether they
290 existed before the 'cp' command was given.
292 Return true if the parent of CONST_DST_NAME and any intermediate
293 directories specified by ATTR_LIST have the proper permissions
297 re_protect (char const *const_dst_name
, size_t src_offset
,
298 struct dir_attr
*attr_list
, const struct cp_options
*x
)
301 char *dst_name
; /* A copy of CONST_DST_NAME we can change. */
302 char *src_name
; /* The source name in 'dst_name'. */
304 ASSIGN_STRDUPA (dst_name
, const_dst_name
);
305 src_name
= dst_name
+ src_offset
;
307 for (p
= attr_list
; p
; p
= p
->next
)
309 dst_name
[p
->slash_offset
] = '\0';
311 /* Adjust the times (and if possible, ownership) for the copy.
312 chown turns off set[ug]id bits for non-root,
313 so do the chmod last. */
315 if (x
->preserve_timestamps
)
317 struct timespec timespec
[2];
319 timespec
[0] = get_stat_atime (&p
->st
);
320 timespec
[1] = get_stat_mtime (&p
->st
);
322 if (utimens (dst_name
, timespec
))
324 error (0, errno
, _("failed to preserve times for %s"),
330 if (x
->preserve_ownership
)
332 if (lchown (dst_name
, p
->st
.st_uid
, p
->st
.st_gid
) != 0)
334 if (! chown_failure_ok (x
))
336 error (0, errno
, _("failed to preserve ownership for %s"),
340 /* Failing to preserve ownership is OK. Still, try to preserve
341 the group, but ignore the possible error. */
342 ignore_value (lchown (dst_name
, -1, p
->st
.st_gid
));
346 if (x
->preserve_mode
)
348 if (copy_acl (src_name
, -1, dst_name
, -1, p
->st
.st_mode
) != 0)
351 else if (p
->restore_mode
)
353 if (lchmod (dst_name
, p
->st
.st_mode
) != 0)
355 error (0, errno
, _("failed to preserve permissions for %s"),
361 dst_name
[p
->slash_offset
] = '/';
366 /* Ensure that the parent directory of CONST_DIR exists, for
367 the --parents option.
369 SRC_OFFSET is the index in CONST_DIR (which is a destination
370 directory) of the beginning of the source directory name.
371 Create any leading directories that don't already exist.
372 If VERBOSE_FMT_STRING is nonzero, use it as a printf format
373 string for printing a message after successfully making a directory.
374 The format should take two string arguments: the names of the
375 source and destination directories.
376 Creates a linked list of attributes of intermediate directories,
377 *ATTR_LIST, for re_protect to use after calling copy.
378 Sets *NEW_DST if this function creates parent of CONST_DIR.
380 Return true if parent of CONST_DIR exists as a directory with the proper
381 permissions when done. */
383 /* FIXME: Synch this function with the one in ../lib/mkdir-p.c. */
386 make_dir_parents_private (char const *const_dir
, size_t src_offset
,
387 char const *verbose_fmt_string
,
388 struct dir_attr
**attr_list
, bool *new_dst
,
389 const struct cp_options
*x
)
392 char *dir
; /* A copy of CONST_DIR we can change. */
393 char *src
; /* Source name in DIR. */
394 char *dst_dir
; /* Leading directory of DIR. */
395 size_t dirlen
; /* Length of DIR. */
397 ASSIGN_STRDUPA (dir
, const_dir
);
399 src
= dir
+ src_offset
;
401 dirlen
= dir_len (dir
);
402 dst_dir
= alloca (dirlen
+ 1);
403 memcpy (dst_dir
, dir
, dirlen
);
404 dst_dir
[dirlen
] = '\0';
408 if (stat (dst_dir
, &stats
) != 0)
410 /* A parent of CONST_DIR does not exist.
411 Make all missing intermediate directories. */
415 while (*slash
== '/')
417 while ((slash
= strchr (slash
, '/')))
419 struct dir_attr
*new IF_LINT ( = NULL
);
423 missing_dir
= (stat (dir
, &stats
) != 0);
425 if (missing_dir
|| x
->preserve_ownership
|| x
->preserve_mode
426 || x
->preserve_timestamps
)
428 /* Add this directory to the list of directories whose
429 modes might need fixing later. */
431 int src_errno
= (stat (src
, &src_st
) != 0
433 : S_ISDIR (src_st
.st_mode
)
438 error (0, src_errno
, _("failed to get attributes of %s"),
443 new = xmalloc (sizeof *new);
445 new->slash_offset
= slash
- dir
;
446 new->restore_mode
= false;
447 new->next
= *attr_list
;
454 mode_t omitted_permissions
;
457 /* This component does not exist. We must set
458 *new_dst and new->st.st_mode inside this loop because,
459 for example, in the command 'cp --parents ../a/../b/c e_dir',
460 make_dir_parents_private creates only e_dir/../a if
461 ./b already exists. */
463 src_mode
= new->st
.st_mode
;
465 /* If the ownership or special mode bits might change,
466 omit some permissions at first, so unauthorized users
467 cannot nip in before the file is ready. */
468 omitted_permissions
= (src_mode
469 & (x
->preserve_ownership
475 /* POSIX says mkdir's behavior is implementation-defined when
476 (src_mode & ~S_IRWXUGO) != 0. However, common practice is
477 to ask mkdir to copy all the CHMOD_MODE_BITS, letting mkdir
478 decide what to do with S_ISUID | S_ISGID | S_ISVTX. */
479 mkdir_mode
= src_mode
& CHMOD_MODE_BITS
& ~omitted_permissions
;
480 if (mkdir (dir
, mkdir_mode
) != 0)
482 error (0, errno
, _("cannot make directory %s"),
488 if (verbose_fmt_string
!= NULL
)
489 printf (verbose_fmt_string
, src
, dir
);
492 /* We need search and write permissions to the new directory
493 for writing the directory's contents. Check if these
494 permissions are there. */
496 if (lstat (dir
, &stats
))
498 error (0, errno
, _("failed to get attributes of %s"),
504 if (! x
->preserve_mode
)
506 if (omitted_permissions
& ~stats
.st_mode
)
507 omitted_permissions
&= ~ cached_umask ();
508 if (omitted_permissions
& ~stats
.st_mode
509 || (stats
.st_mode
& S_IRWXU
) != S_IRWXU
)
511 new->st
.st_mode
= stats
.st_mode
| omitted_permissions
;
512 new->restore_mode
= true;
516 if ((stats
.st_mode
& S_IRWXU
) != S_IRWXU
)
518 /* Make the new directory searchable and writable.
519 The original permissions will be restored later. */
521 if (lchmod (dir
, stats
.st_mode
| S_IRWXU
) != 0)
523 error (0, errno
, _("setting permissions for %s"),
529 else if (!S_ISDIR (stats
.st_mode
))
531 error (0, 0, _("%s exists but is not a directory"),
539 /* Avoid unnecessary calls to 'stat' when given
540 file names containing multiple adjacent slashes. */
541 while (*slash
== '/')
546 /* We get here if the parent of DIR already exists. */
548 else if (!S_ISDIR (stats
.st_mode
))
550 error (0, 0, _("%s exists but is not a directory"), quoteaf (dst_dir
));
560 /* FILE is the last operand of this command.
561 Return true if FILE is a directory.
562 But report an error and exit if there is a problem accessing FILE,
563 or if FILE does not exist but would have to refer to an existing
564 directory if it referred to anything at all.
566 If the file exists, store the file's status into *ST.
567 Otherwise, set *NEW_DST. */
570 target_directory_operand (char const *file
, struct stat
*st
, bool *new_dst
)
572 int err
= (stat (file
, st
) == 0 ? 0 : errno
);
573 bool is_a_dir
= !err
&& S_ISDIR (st
->st_mode
);
577 error (EXIT_FAILURE
, err
, _("failed to access %s"), quoteaf (file
));
583 /* Scan the arguments, and copy each by calling copy.
584 Return true if successful. */
587 do_copy (int n_files
, char **file
, const char *target_directory
,
588 bool no_target_directory
, struct cp_options
*x
)
591 bool new_dst
= false;
594 if (n_files
<= !target_directory
)
597 error (0, 0, _("missing file operand"));
599 error (0, 0, _("missing destination file operand after %s"),
601 usage (EXIT_FAILURE
);
604 if (no_target_directory
)
606 if (target_directory
)
607 error (EXIT_FAILURE
, 0,
608 _("cannot combine --target-directory (-t) "
609 "and --no-target-directory (-T)"));
612 error (0, 0, _("extra operand %s"), quoteaf (file
[2]));
613 usage (EXIT_FAILURE
);
615 /* Update NEW_DST and SB, which may be checked below. */
616 ignore_value (target_directory_operand (file
[n_files
-1], &sb
, &new_dst
));
618 else if (!target_directory
)
621 && target_directory_operand (file
[n_files
- 1], &sb
, &new_dst
))
622 target_directory
= file
[--n_files
];
623 else if (2 < n_files
)
624 error (EXIT_FAILURE
, 0, _("target %s is not a directory"),
625 quoteaf (file
[n_files
- 1]));
628 if (target_directory
)
630 /* cp file1...filen edir
631 Copy the files 'file1' through 'filen'
632 to the existing directory 'edir'. */
635 /* Initialize these hash tables only if we'll need them.
636 The problems they're used to detect can arise only if
637 there are two or more files to copy. */
644 for (i
= 0; i
< n_files
; i
++)
647 bool parent_exists
= true; /* True if dir_name (dst_name) exists. */
648 struct dir_attr
*attr_list
;
649 char *arg_in_concat
= NULL
;
652 /* Trailing slashes are meaningful (i.e., maybe worth preserving)
653 only in the source file names. */
654 if (remove_trailing_slashes
)
655 strip_trailing_slashes (arg
);
659 char *arg_no_trailing_slash
;
661 /* Use 'arg' without trailing slashes in constructing destination
662 file names. Otherwise, we can end up trying to create a
663 directory via 'mkdir ("dst/foo/"...', which is not portable.
664 It fails, due to the trailing slash, on at least
665 NetBSD 1.[34] systems. */
666 ASSIGN_STRDUPA (arg_no_trailing_slash
, arg
);
667 strip_trailing_slashes (arg_no_trailing_slash
);
669 /* Append all of 'arg' (minus any trailing slash) to 'dest'. */
670 dst_name
= file_name_concat (target_directory
,
671 arg_no_trailing_slash
,
674 /* For --parents, we have to make sure that the directory
675 dir_name (dst_name) exists. We may have to create a few
676 leading directories. */
678 (make_dir_parents_private
679 (dst_name
, arg_in_concat
- dst_name
,
680 (x
->verbose
? "%s -> %s\n" : NULL
),
681 &attr_list
, &new_dst
, x
));
686 /* Append the last component of 'arg' to 'target_directory'. */
688 ASSIGN_BASENAME_STRDUPA (arg_base
, arg
);
689 /* For 'cp -R source/.. dest', don't copy into 'dest/..'. */
690 dst_name
= (STREQ (arg_base
, "..")
691 ? xstrdup (target_directory
)
692 : file_name_concat (target_directory
, arg_base
,
698 /* make_dir_parents_private failed, so don't even
705 ok
&= copy (arg
, dst_name
, new_dst
, x
, ©_into_self
, NULL
);
708 ok
&= re_protect (dst_name
, arg_in_concat
- dst_name
,
716 struct dir_attr
*p
= attr_list
;
717 attr_list
= attr_list
->next
;
725 else /* !target_directory */
727 char const *new_dest
;
728 char const *source
= file
[0];
729 char const *dest
= file
[1];
735 _("with --parents, the destination must be a directory"));
736 usage (EXIT_FAILURE
);
739 /* When the force and backup options have been specified and
740 the source and destination are the same name for an existing
741 regular file, convert the user's command, e.g.,
742 'cp --force --backup foo foo' to 'cp --force foo fooSUFFIX'
743 where SUFFIX is determined by any version control options used. */
745 if (x
->unlink_dest_after_failed_open
746 && x
->backup_type
!= no_backups
747 && STREQ (source
, dest
)
748 && !new_dst
&& S_ISREG (sb
.st_mode
))
750 static struct cp_options x_tmp
;
752 new_dest
= find_backup_file_name (dest
, x
->backup_type
);
753 /* Set x->backup_type to 'no_backups' so that the normal backup
754 mechanism is not used when performing the actual copy.
755 backup_type must be set to 'no_backups' only *after* the above
756 call to find_backup_file_name -- that function uses
757 backup_type to determine the suffix it applies. */
759 x_tmp
.backup_type
= no_backups
;
767 ok
= copy (source
, new_dest
, 0, x
, &unused
, NULL
);
774 cp_option_init (struct cp_options
*x
)
776 cp_options_default (x
);
777 x
->copy_as_regular
= true;
778 x
->dereference
= DEREF_UNDEFINED
;
779 x
->unlink_dest_before_opening
= false;
780 x
->unlink_dest_after_failed_open
= false;
781 x
->hard_link
= false;
782 x
->interactive
= I_UNSPECIFIED
;
783 x
->move_mode
= false;
784 x
->one_file_system
= false;
785 x
->reflink_mode
= REFLINK_NEVER
;
787 x
->preserve_ownership
= false;
788 x
->preserve_links
= false;
789 x
->preserve_mode
= false;
790 x
->preserve_timestamps
= false;
791 x
->explicit_no_preserve_mode
= false;
792 x
->preserve_security_context
= false; /* -a or --preserve=context. */
793 x
->require_preserve_context
= false; /* --preserve=context. */
794 x
->set_security_context
= false; /* -Z, set sys default context. */
795 x
->preserve_xattr
= false;
796 x
->reduce_diagnostics
= false;
797 x
->require_preserve_xattr
= false;
799 x
->data_copy_required
= true;
800 x
->require_preserve
= false;
801 x
->recursive
= false;
802 x
->sparse_mode
= SPARSE_AUTO
;
803 x
->symbolic_link
= false;
808 x
->stdin_tty
= false;
813 /* By default, refuse to open a dangling destination symlink, because
814 in general one cannot do that safely, give the current semantics of
815 open's O_EXCL flag, (which POSIX doesn't even allow cp to use, btw).
816 But POSIX requires it. */
817 x
->open_dangling_dest_symlink
= getenv ("POSIXLY_CORRECT") != NULL
;
823 /* Given a string, ARG, containing a comma-separated list of arguments
824 to the --preserve option, set the appropriate fields of X to ON_OFF. */
826 decode_preserve_arg (char const *arg
, struct cp_options
*x
, bool on_off
)
838 static enum File_attribute
const preserve_vals
[] =
840 PRESERVE_MODE
, PRESERVE_TIMESTAMPS
,
841 PRESERVE_OWNERSHIP
, PRESERVE_LINK
, PRESERVE_CONTEXT
, PRESERVE_XATTR
,
844 /* Valid arguments to the '--preserve' option. */
845 static char const* const preserve_args
[] =
847 "mode", "timestamps",
848 "ownership", "links", "context", "xattr", "all", NULL
850 ARGMATCH_VERIFY (preserve_args
, preserve_vals
);
852 char *arg_writable
= xstrdup (arg
);
853 char *s
= arg_writable
;
856 /* find next comma */
857 char *comma
= strchr (s
, ',');
858 enum File_attribute val
;
860 /* If we found a comma, put a NUL in its place and advance. */
865 val
= XARGMATCH (on_off
? "--preserve" : "--no-preserve",
866 s
, preserve_args
, preserve_vals
);
870 x
->preserve_mode
= on_off
;
871 x
->explicit_no_preserve_mode
= !on_off
;
874 case PRESERVE_TIMESTAMPS
:
875 x
->preserve_timestamps
= on_off
;
878 case PRESERVE_OWNERSHIP
:
879 x
->preserve_ownership
= on_off
;
883 x
->preserve_links
= on_off
;
886 case PRESERVE_CONTEXT
:
887 x
->require_preserve_context
= on_off
;
888 x
->preserve_security_context
= on_off
;
892 x
->preserve_xattr
= on_off
;
893 x
->require_preserve_xattr
= on_off
;
897 x
->preserve_mode
= on_off
;
898 x
->preserve_timestamps
= on_off
;
899 x
->preserve_ownership
= on_off
;
900 x
->preserve_links
= on_off
;
901 x
->explicit_no_preserve_mode
= !on_off
;
903 x
->preserve_security_context
= on_off
;
904 x
->preserve_xattr
= on_off
;
918 main (int argc
, char **argv
)
922 bool make_backups
= false;
923 char *backup_suffix_string
;
924 char *version_control_string
= NULL
;
926 bool copy_contents
= false;
927 char *target_directory
= NULL
;
928 bool no_target_directory
= false;
929 char const *scontext
= NULL
;
931 initialize_main (&argc
, &argv
);
932 set_program_name (argv
[0]);
933 setlocale (LC_ALL
, "");
934 bindtextdomain (PACKAGE
, LOCALEDIR
);
935 textdomain (PACKAGE
);
937 atexit (close_stdin
);
939 selinux_enabled
= (0 < is_selinux_enabled ());
942 /* FIXME: consider not calling getenv for SIMPLE_BACKUP_SUFFIX unless
943 we'll actually use backup_suffix_string. */
944 backup_suffix_string
= getenv ("SIMPLE_BACKUP_SUFFIX");
946 while ((c
= getopt_long (argc
, argv
, "abdfHilLnprst:uvxPRS:TZ",
953 x
.sparse_mode
= XARGMATCH ("--sparse", optarg
,
954 sparse_type_string
, sparse_type
);
959 x
.reflink_mode
= REFLINK_ALWAYS
;
961 x
.reflink_mode
= XARGMATCH ("--reflink", optarg
,
962 reflink_type_string
, reflink_type
);
966 /* Like -dR --preserve=all with reduced failure diagnostics. */
967 x
.dereference
= DEREF_NEVER
;
968 x
.preserve_links
= true;
969 x
.preserve_ownership
= true;
970 x
.preserve_mode
= true;
971 x
.preserve_timestamps
= true;
972 x
.require_preserve
= true;
974 x
.preserve_security_context
= true;
975 x
.preserve_xattr
= true;
976 x
.reduce_diagnostics
= true;
983 version_control_string
= optarg
;
986 case ATTRIBUTES_ONLY_OPTION
:
987 x
.data_copy_required
= false;
990 case COPY_CONTENTS_OPTION
:
991 copy_contents
= true;
995 x
.preserve_links
= true;
996 x
.dereference
= DEREF_NEVER
;
1000 x
.unlink_dest_after_failed_open
= true;
1004 x
.dereference
= DEREF_COMMAND_LINE_ARGUMENTS
;
1008 x
.interactive
= I_ASK_USER
;
1016 x
.dereference
= DEREF_ALWAYS
;
1020 x
.interactive
= I_ALWAYS_NO
;
1024 x
.dereference
= DEREF_NEVER
;
1027 case NO_PRESERVE_ATTRIBUTES_OPTION
:
1028 decode_preserve_arg (optarg
, &x
, false);
1031 case PRESERVE_ATTRIBUTES_OPTION
:
1034 /* Fall through to the case for 'p' below. */
1038 decode_preserve_arg (optarg
, &x
, true);
1039 x
.require_preserve
= true;
1044 x
.preserve_ownership
= true;
1045 x
.preserve_mode
= true;
1046 x
.preserve_timestamps
= true;
1047 x
.require_preserve
= true;
1050 case PARENTS_OPTION
:
1051 parents_option
= true;
1059 case UNLINK_DEST_BEFORE_OPENING
:
1060 x
.unlink_dest_before_opening
= true;
1063 case STRIP_TRAILING_SLASHES_OPTION
:
1064 remove_trailing_slashes
= true;
1068 x
.symbolic_link
= true;
1072 if (target_directory
)
1073 error (EXIT_FAILURE
, 0,
1074 _("multiple target directories specified"));
1078 if (stat (optarg
, &st
) != 0)
1079 error (EXIT_FAILURE
, errno
, _("failed to access %s"),
1081 if (! S_ISDIR (st
.st_mode
))
1082 error (EXIT_FAILURE
, 0, _("target %s is not a directory"),
1085 target_directory
= optarg
;
1089 no_target_directory
= true;
1101 x
.one_file_system
= true;
1105 /* politely decline if we're not on a selinux-enabled kernel. */
1106 if (selinux_enabled
)
1111 x
.set_security_context
= true;
1116 _("warning: ignoring --context; "
1117 "it requires an SELinux-enabled kernel"));
1122 make_backups
= true;
1123 backup_suffix_string
= optarg
;
1126 case_GETOPT_HELP_CHAR
;
1128 case_GETOPT_VERSION_CHAR (PROGRAM_NAME
, AUTHORS
);
1131 usage (EXIT_FAILURE
);
1135 if (x
.hard_link
&& x
.symbolic_link
)
1137 error (0, 0, _("cannot make both hard and symbolic links"));
1138 usage (EXIT_FAILURE
);
1141 if (make_backups
&& x
.interactive
== I_ALWAYS_NO
)
1144 _("options --backup and --no-clobber are mutually exclusive"));
1145 usage (EXIT_FAILURE
);
1148 if (x
.reflink_mode
== REFLINK_ALWAYS
&& x
.sparse_mode
!= SPARSE_AUTO
)
1150 error (0, 0, _("--reflink can be used only with --sparse=auto"));
1151 usage (EXIT_FAILURE
);
1154 if (backup_suffix_string
)
1155 simple_backup_suffix
= xstrdup (backup_suffix_string
);
1157 x
.backup_type
= (make_backups
1158 ? xget_version (_("backup type"),
1159 version_control_string
)
1162 if (x
.dereference
== DEREF_UNDEFINED
)
1164 if (x
.recursive
&& ! x
.hard_link
)
1165 /* This is compatible with FreeBSD. */
1166 x
.dereference
= DEREF_NEVER
;
1168 x
.dereference
= DEREF_ALWAYS
;
1172 x
.copy_as_regular
= copy_contents
;
1174 /* If --force (-f) was specified and we're in link-creation mode,
1175 first remove any existing destination file. */
1176 if (x
.unlink_dest_after_failed_open
&& (x
.hard_link
|| x
.symbolic_link
))
1177 x
.unlink_dest_before_opening
= true;
1179 /* Ensure -Z overrides -a. */
1180 if ((x
.set_security_context
|| scontext
)
1181 && ! x
.require_preserve_context
)
1182 x
.preserve_security_context
= false;
1184 if (x
.preserve_security_context
&& (x
.set_security_context
|| scontext
))
1185 error (EXIT_FAILURE
, 0,
1186 _("cannot set target context and preserve it"));
1188 if (x
.require_preserve_context
&& ! selinux_enabled
)
1189 error (EXIT_FAILURE
, 0,
1190 _("cannot preserve security context "
1191 "without an SELinux-enabled kernel"));
1193 /* FIXME: This handles new files. But what about existing files?
1194 I.e., if updating a tree, new files would have the specified context,
1195 but shouldn't existing files be updated for consistency like this?
1197 restorecon (dst_path, 0, true);
1199 if (scontext
&& setfscreatecon (se_const (scontext
)) < 0)
1200 error (EXIT_FAILURE
, errno
,
1201 _("failed to set default file creation context to %s"),
1205 if (x
.require_preserve_xattr
)
1206 error (EXIT_FAILURE
, 0, _("cannot preserve extended attributes, cp is "
1207 "built without xattr support"));
1210 /* Allocate space for remembering copied and created files. */
1214 ok
= do_copy (argc
- optind
, argv
+ optind
,
1215 target_directory
, no_target_directory
, &x
);
1221 return ok
? EXIT_SUCCESS
: EXIT_FAILURE
;