1 /* Copyright 2008 Rob Landley <rob@landley.net>
3 * See http://opengroup.org/onlinepubs/9699919799/utilities/cp.html
4 * And http://opengroup.org/onlinepubs/9699919799/utilities/mv.html
5 * And http://refspecs.linuxfoundation.org/LSB_5.0.0/LSB-Core-generic/LSB-Core-generic.html#INSTALL
7 * Posix says "cp -Rf dir file" shouldn't delete file, but our -f does.
9 * Deviations from posix: -adlnrsvF, --preserve... about half the
10 * functionality in this cp isn't in posix. Posix is stuck in the 1970's.
12 * TODO: --preserve=links
13 * TODO: what's this _CP_mode system.posix_acl_ business? We chmod()?
15 // options shared between mv/cp must be in same order (right to left)
16 // for FLAG macros to work out right in shared infrastructure.
18 USE_CP(NEWTOY(cp, "<2"USE_CP_PRESERVE("(preserve):;")"RHLPprdaslvnF(remove-destination)fi[-HLPd][-ni]", TOYFLAG_BIN))
19 USE_MV(NEWTOY(mv, "<2vnF(remove-destination)fi[-ni]", TOYFLAG_BIN))
20 USE_INSTALL(NEWTOY(install, "<1cdDpsvm:o:g:", TOYFLAG_USR|TOYFLAG_BIN))
26 usage: cp [-adlnrsvfipRHLP] SOURCE... DEST
28 Copy files from SOURCE to DEST. If more than one SOURCE, DEST must
31 -f delete destination files we can't write to
32 -F delete any existing destination file first (--remove-destination)
33 -i interactive, prompt before overwriting existing DEST
34 -p preserve timestamps, ownership, and mode
35 -R recurse into subdirectories (DEST must be a directory)
36 -H Follow symlinks listed on command line
37 -L Follow all symlinks
38 -P Do not follow symlinks [default]
40 -d don't dereference symlinks
41 -l hard link instead of copy
42 -n no clobber (don't overwrite DEST)
44 -s symlink instead of copy
48 bool "cp --preserve support"
52 usage: cp [--preserve=motcxa]
54 --preserve takes either a comma separated list of attributes, or the first
57 mode - permissions (ignore umask for rwx, copy suid and sticky bit)
58 ownership - user and group
59 timestamps - file creation, modification, and access times.
60 context - security context
61 xattr - extended attributes
62 all - all of the above
68 usage: mv [-fivn] SOURCE... DEST"
70 -f force copy by deleting destination file
71 -i interactive, prompt before overwriting existing DEST
73 -n no clobber (don't overwrite DEST)
79 usage: install [-dDpsv] [-o USER] [-g GROUP] [-m MODE] [SOURCE...] DEST
81 Copy files and set attributes.
84 -D Create leading directories for DEST
85 -g Make copy belong to GROUP
86 -m Set permissions to MODE
87 -o Make copy belong to USER
88 -p Preserve timestamps
112 int (*callback)(struct dirtree *try);
120 } static const cp_preserve[] = TAGGED_ARRAY(CP,
121 {"mode"}, {"ownership"}, {"timestamps"}, {"context"}, {"xattr"},
124 // Callback from dirtree_read() for each file/directory under a source dir.
126 int cp_node(struct dirtree *try)
128 int fdout = -1, cfd = try->parent ? try->parent->extra : AT_FDCWD,
129 tfd = dirtree_parentfd(try);
130 unsigned flags = toys.optflags;
131 char *catch = try->parent ? try->name : TT.destname, *err = "%s";
134 if (!dirtree_notdotdot(try)) return 0;
136 // If returning from COMEAGAIN, jump straight to -p logic at end.
137 if (S_ISDIR(try->st.st_mode) && try->again) {
142 // -d is only the same as -r for symlinks, not for directories
143 if (S_ISLNK(try->st.st_mode) && (flags & FLAG_d)) flags |= FLAG_r;
145 // Detect recursive copies via repeated top node (cp -R .. .) or
146 // identical source/target (fun with hardlinks).
147 if ((TT.top.st_dev == try->st.st_dev && TT.top.st_ino == try->st.st_ino
148 && (catch = TT.destname))
149 || (!fstatat(cfd, catch, &cst, 0) && cst.st_dev == try->st.st_dev
150 && cst.st_ino == try->st.st_ino))
152 error_msg("'%s' is '%s'", catch, err = dirtree_path(try, 0));
160 if (!faccessat(cfd, catch, F_OK, 0) && !S_ISDIR(cst.st_mode)) {
163 if (S_ISDIR(try->st.st_mode)) {
164 error_msg("dir at '%s'", s = dirtree_path(try, 0));
167 } else if ((flags & FLAG_F) && unlinkat(cfd, catch, 0)) {
168 error_msg("unlink '%s'", catch);
170 } else if (flags & FLAG_n) return 0;
171 else if (flags & FLAG_i) {
172 fprintf(stderr, "%s: overwrite '%s'", toys.which->name,
173 s = dirtree_path(try, 0));
175 if (!yesno(1)) return 0;
179 if (flags & FLAG_v) {
180 char *s = dirtree_path(try, 0);
181 printf("%s '%s'\n", toys.which->name, s);
185 // Loop for -f retry after unlink
188 // directory, hardlink, symlink, mknod (char, block, fifo, socket), file
192 if (S_ISDIR(try->st.st_mode)) {
195 if (!(flags & (FLAG_a|FLAG_r|FLAG_R))) {
196 err = "Skipped dir '%s'";
201 // Always make directory writeable to us, so we can create files in it.
203 // Yes, there's a race window between mkdir() and open() so it's
204 // possible that -p can be made to chown a directory other than the one
205 // we created. The closest we can do to closing this is make sure
206 // that what we open _is_ a directory rather than something else.
208 if (!mkdirat(cfd, catch, try->st.st_mode | 0200) || errno == EEXIST)
209 if (-1 != (try->extra = openat(cfd, catch, O_NOFOLLOW)))
210 if (!fstat(try->extra, &st2) && S_ISDIR(st2.st_mode))
211 return DIRTREE_COMEAGAIN
212 | (DIRTREE_SYMFOLLOW*!!(toys.optflags&FLAG_L));
216 } else if (flags & FLAG_l) {
217 if (!linkat(tfd, try->name, cfd, catch, 0)) err = 0;
219 // Copy tree as symlinks. For non-absolute paths this involves
220 // appending the right number of .. entries as you go down the tree.
222 } else if (flags & FLAG_s) {
227 s = dirtree_path(try, 0);
228 for (or = try; or->parent; or = or->parent) dotdots++;
230 if (*or->name == '/') dotdots = 0;
232 char *s2 = xmprintf("%*c%s", 3*dotdots, ' ', s);
236 memcpy(s2, "../", 3);
240 if (!symlinkat(s, cfd, catch)) {
246 // Do something _other_ than copy contents of a file?
247 } else if (!S_ISREG(try->st.st_mode)
248 && (try->parent || (flags & (FLAG_a|FLAG_r))))
252 // make symlink, or make block/char/fifo/socket
253 if (S_ISLNK(try->st.st_mode)
254 ? (0 < (i = readlinkat(tfd, try->name, toybuf, sizeof(toybuf))) &&
255 sizeof(toybuf) > i && !symlinkat(toybuf, cfd, catch))
256 : !mknodat(cfd, catch, try->st.st_mode, try->st.st_rdev))
262 // Copy contents of file.
266 fdin = openat(tfd, try->name, O_RDONLY);
271 fdout = openat(cfd, catch, O_RDWR|O_CREAT|O_TRUNC, try->st.st_mode);
273 xsendfile(fdin, fdout);
277 // We only copy xattrs for files because there's no flistxattrat()
278 if (TT.pflags&(_CP_xattr|_CP_context)) {
279 ssize_t listlen = flistxattr(fdin, 0, 0), len;
280 char *name, *value, *list;
283 list = xmalloc(listlen);
284 flistxattr(fdin, list, listlen);
285 list[listlen-1] = 0; // I do not trust this API.
286 for (name = list; name-list < listlen; name += strlen(name)+1) {
287 if (!(TT.pflags&_CP_xattr) && strncmp(name, "security.", 9))
289 if ((len = fgetxattr(fdin, name, 0, 0))>0) {
290 value = xmalloc(len);
291 if (len == fgetxattr(fdin, name, value, len))
292 if (fsetxattr(fdout, name, value, len, 0))
293 perror_msg("%s setxattr(%s=%s)", catch, name, value);
303 } while (err && (flags & (FLAG_f|FLAG_n)) && !unlinkat(cfd, catch, 0));
306 // Did we make a thing?
310 // Inability to set --preserve isn't fatal, some require root access.
313 if (TT.pflags & _CP_ownership) {
315 // permission bits already correct for mknod and don't apply to symlink
316 // If we can't get a filehandle to the actual object, use racy functions
317 if (fdout == AT_FDCWD)
318 rc = fchownat(cfd, catch, try->st.st_uid, try->st.st_gid,
319 AT_SYMLINK_NOFOLLOW);
320 else rc = fchown(fdout, try->st.st_uid, try->st.st_gid);
324 perror_msg("chown '%s'", pp = dirtree_path(try, 0));
330 if (TT.pflags & _CP_timestamps) {
331 struct timespec times[] = {try->st.st_atim, try->st.st_mtim};
333 if (fdout == AT_FDCWD) utimensat(cfd, catch, times, AT_SYMLINK_NOFOLLOW);
334 else futimens(fdout, times);
337 // mode comes last because other syscalls can strip suid bit
338 if (fdout != AT_FDCWD) {
339 if (TT.pflags & _CP_mode) fchmod(fdout, try->st.st_mode);
343 if (CFG_MV && toys.which->name[0] == 'm')
344 if (unlinkat(tfd, try->name, S_ISDIR(try->st.st_mode) ? AT_REMOVEDIR :0))
348 if (err) perror_msg(err, catch);
354 char *destname = toys.optargs[--toys.optc];
355 int i, destdir = !stat(destname, &TT.top) && S_ISDIR(TT.top.st_mode);
357 if (toys.optc>1 && !destdir) error_exit("'%s' not directory", destname);
359 if (toys.optflags & (FLAG_a|FLAG_p)) {
360 TT.pflags = CP_mode|CP_ownership|CP_timestamps;
363 // Not using comma_args() (yet?) because interpeting as letters.
364 if (CFG_CP_PRESERVE && (toys.optflags & FLAG_preserve)) {
365 char *pre = xstrdup(TT.c.preserve), *s;
367 if (comma_scan(pre, "all", 1)) TT.pflags = ~0;
368 for (i=0; i<ARRAY_LEN(cp_preserve); i++)
369 if (comma_scan(pre, cp_preserve[i].name, 1)) TT.pflags |= 1<<i;
372 // Try to interpret as letters, commas won't set anything this doesn't.
373 for (s = TT.c.preserve; *s; s++) {
374 for (i=0; i<ARRAY_LEN(cp_preserve); i++)
375 if (*s == *cp_preserve[i].name) break;
376 if (i == ARRAY_LEN(cp_preserve)) {
377 if (*s == 'a') TT.pflags = ~0;
379 } else TT.pflags |= 1<<i;
382 if (*s) error_exit("bad --preserve=%s", pre);
386 if (!TT.callback) TT.callback = cp_node;
388 // Loop through sources
389 for (i=0; i<toys.optc; i++) {
390 char *src = toys.optargs[i];
393 if (destdir) TT.destname = xmprintf("%s/%s", destname, basename(src));
394 else TT.destname = destname;
397 if (CFG_MV && toys.which->name[0] == 'm') {
398 if (!(toys.optflags & FLAG_f)) {
401 // Technically "is writeable" is more complicated (022 is not writeable
402 // by the owner, just everybody _else_) but I don't care.
403 if (!stat(TT.destname, &st)
404 && ((toys.optflags & FLAG_i) || !(st.st_mode & 0222)))
406 fprintf(stderr, "%s: overwrite '%s'", toys.which->name, TT.destname);
407 if (!yesno(1)) rc = 0;
408 else unlink(TT.destname);
412 if (rc) rc = rename(src, TT.destname);
415 // Copy if we didn't mv, skipping nonexistent sources
417 if (errno!=EXDEV || dirtree_flagread(src, DIRTREE_SHUTUP+
418 DIRTREE_SYMFOLLOW*!!(toys.optflags&(FLAG_H|FLAG_L)), TT.callback))
419 perror_msg("bad '%s'", src);
421 if (destdir) free(TT.destname);
427 toys.optflags |= FLAG_d|FLAG_p|FLAG_R;
432 // Export cp flags into install's flag context.
434 static inline int cp_flag_F(void) { return FLAG_F; };
435 static inline int cp_flag_p(void) { return FLAG_p; };
436 static inline int cp_flag_v(void) { return FLAG_v; };
438 // Switch to install's flag context
441 #include <generated/flags.h>
443 static int install_node(struct dirtree *try)
445 try->st.st_mode = (TT.i.mode)
446 ? string_to_mode(TT.i.mode, try->st.st_mode) : 0755;
447 if (TT.i.group) try->st.st_gid = TT.gid;
448 if (TT.i.user) try->st.st_uid = TT.uid;
450 // Always returns 0 because no -r
453 // No -r so always one level deep, so destname as set by cp_node() is correct
454 if (toys.optflags & FLAG_s)
455 if (xrun((char *[]){"strip", "-p", TT.destname, 0})) toys.exitval = 1;
460 void install_main(void)
463 int flags = toys.optflags;
465 if (flags & FLAG_d) {
466 for (ss = toys.optargs; *ss; ss++) {
467 if (mkpathat(AT_FDCWD, *ss, 0777, 3)) perror_msg_raw(*ss);
468 if (flags & FLAG_v) printf("%s\n", *ss);
474 if (toys.optflags & FLAG_D) {
475 TT.destname = toys.optargs[toys.optc-1];
476 if (mkpathat(AT_FDCWD, TT.destname, 0, 2))
477 perror_exit("-D '%s'", TT.destname);
478 if (toys.optc == 1) return;
480 if (toys.optc < 2) error_exit("needs 2 args");
482 // Translate flags from install to cp
483 toys.optflags = cp_flag_F();
484 if (flags & FLAG_v) toys.optflags |= cp_flag_v();
485 if (flags & (FLAG_p|FLAG_o|FLAG_g)) toys.optflags |= cp_flag_p();
487 if (TT.i.user) TT.uid = xgetpwnamid(TT.i.user)->pw_uid;
488 if (TT.i.group) TT.gid = xgetgrnamid(TT.i.group)->gr_gid;
490 TT.callback = install_node;