1 /* vi: set sw=4 ts=4: */
3 * Mini find implementation for busybox
5 * Copyright (C) 1999-2004 by Erik Andersen <andersen@codepoet.org>
7 * Reworked by David Douthitt <n9ubh@callsign.net> and
8 * Matt Kraai <kraai@alumni.carnegiemellon.edu>.
10 * Licensed under GPLv2, see file LICENSE in this source tree.
14 * # find file.txt -exec 'echo {}' '{} {}' ';'
15 * find: echo file.txt: No such file or directory
16 * # find file.txt -exec 'echo' '{} {}' '; '
17 * find: missing argument to '-exec'
18 * # find file.txt -exec 'echo {}' '{} {}' ';' junk
19 * find: paths must precede expression
20 * # find file.txt -exec 'echo {}' '{} {}' ';' junk ';'
21 * find: paths must precede expression
22 * # find file.txt -exec 'echo' '{} {}' ';'
24 * (strace: execve("/bin/echo", ["echo", "file.txt file.txt"], [ 30 vars ]))
25 * # find file.txt -exec 'echo' '{} {}' ';' -print -exec pwd ';'
29 * # find -name '*.c' -o -name '*.h'
30 * [shows files, *.c and *.h intermixed]
31 * # find file.txt -name '*f*' -o -name '*t*'
33 * # find file.txt -name '*z*' -o -name '*t*'
35 * # find file.txt -name '*f*' -o -name '*z*'
38 * # find t z -name '*t*' -print -o -name '*z*'
40 * # find t z t z -name '*t*' -o -name '*z*' -print
43 * # find t z t z '(' -name '*t*' -o -name '*z*' ')' -o -print
47 * ./busybox find "$@" | tee /tmp/bb_find
48 * echo ==================
49 * /path/to/gnu/find "$@" | tee /tmp/std_find
50 * echo ==================
51 * diff -u /tmp/std_find /tmp/bb_find && echo Identical
54 //config: bool "find (14 kb)"
57 //config: find is used to search your system to find specified files.
59 //config:config FEATURE_FIND_PRINT0
60 //config: bool "Enable -print0: NUL-terminated output"
62 //config: depends on FIND
64 //config: Causes output names to be separated by a NUL character
65 //config: rather than a newline. This allows names that contain
66 //config: newlines and other whitespace to be more easily
67 //config: interpreted by other programs.
69 //config:config FEATURE_FIND_MTIME
70 //config: bool "Enable -mtime: modified time matching"
72 //config: depends on FIND
74 //config: Allow searching based on the modification time of
75 //config: files, in days.
77 //config:config FEATURE_FIND_MMIN
78 //config: bool "Enable -mmin: modified time matching by minutes"
80 //config: depends on FIND
82 //config: Allow searching based on the modification time of
83 //config: files, in minutes.
85 //config:config FEATURE_FIND_PERM
86 //config: bool "Enable -perm: permissions matching"
88 //config: depends on FIND
90 //config:config FEATURE_FIND_TYPE
91 //config: bool "Enable -type: file type matching (file/dir/link/...)"
93 //config: depends on FIND
95 //config: Enable searching based on file type (file,
96 //config: directory, socket, device, etc.).
98 //config:config FEATURE_FIND_XDEV
99 //config: bool "Enable -xdev: 'stay in filesystem'"
101 //config: depends on FIND
103 //config:config FEATURE_FIND_MAXDEPTH
104 //config: bool "Enable -mindepth N and -maxdepth N"
106 //config: depends on FIND
108 //config:config FEATURE_FIND_NEWER
109 //config: bool "Enable -newer: compare file modification times"
111 //config: depends on FIND
113 //config: Support the 'find -newer' option for finding any files which have
114 //config: modification time that is more recent than the specified FILE.
116 //config:config FEATURE_FIND_INUM
117 //config: bool "Enable -inum: inode number matching"
119 //config: depends on FIND
121 //config:config FEATURE_FIND_EXEC
122 //config: bool "Enable -exec: execute commands"
124 //config: depends on FIND
126 //config: Support the 'find -exec' option for executing commands based upon
127 //config: the files matched.
129 //config:config FEATURE_FIND_EXEC_PLUS
130 //config: bool "Enable -exec ... {} +"
132 //config: depends on FEATURE_FIND_EXEC
134 //config: Support the 'find -exec ... {} +' option for executing commands
135 //config: for all matched files at once.
136 //config: Without this option, -exec + is a synonym for -exec ;
137 //config: (IOW: it works correctly, but without expected speedup)
139 //config:config FEATURE_FIND_USER
140 //config: bool "Enable -user: username/uid matching"
142 //config: depends on FIND
144 //config:config FEATURE_FIND_GROUP
145 //config: bool "Enable -group: group/gid matching"
147 //config: depends on FIND
149 //config:config FEATURE_FIND_NOT
150 //config: bool "Enable the 'not' (!) operator"
152 //config: depends on FIND
154 //config: Support the '!' operator to invert the test results.
155 //config: If 'Enable full-blown desktop' is enabled, then will also support
156 //config: the non-POSIX notation '-not'.
158 //config:config FEATURE_FIND_DEPTH
159 //config: bool "Enable -depth"
161 //config: depends on FIND
163 //config: Process each directory's contents before the directory itself.
165 //config:config FEATURE_FIND_PAREN
166 //config: bool "Enable parens in options"
168 //config: depends on FIND
170 //config: Enable usage of parens '(' to specify logical order of arguments.
172 //config:config FEATURE_FIND_SIZE
173 //config: bool "Enable -size: file size matching"
175 //config: depends on FIND
177 //config:config FEATURE_FIND_PRUNE
178 //config: bool "Enable -prune: exclude subdirectories"
180 //config: depends on FIND
182 //config: If the file is a directory, don't descend into it. Useful for
183 //config: exclusion .svn and CVS directories.
185 //config:config FEATURE_FIND_QUIT
186 //config: bool "Enable -quit: exit"
188 //config: depends on FIND
190 //config: If this action is reached, 'find' exits.
192 //config:config FEATURE_FIND_DELETE
193 //config: bool "Enable -delete: delete files/dirs"
195 //config: depends on FIND && FEATURE_FIND_DEPTH
197 //config: Support the 'find -delete' option for deleting files and directories.
198 //config: WARNING: This option can do much harm if used wrong. Busybox will not
199 //config: try to protect the user from doing stupid things. Use with care.
201 //config:config FEATURE_FIND_PATH
202 //config: bool "Enable -path: match pathname with shell pattern"
204 //config: depends on FIND
206 //config: The -path option matches whole pathname instead of just filename.
208 //config:config FEATURE_FIND_REGEX
209 //config: bool "Enable -regex: match pathname with regex"
211 //config: depends on FIND
213 //config: The -regex option matches whole pathname against regular expression.
215 //config:config FEATURE_FIND_CONTEXT
216 //config: bool "Enable -context: security context matching"
218 //config: depends on FIND && SELINUX
220 //config: Support the 'find -context' option for matching security context.
222 //config:config FEATURE_FIND_LINKS
223 //config: bool "Enable -links: link count matching"
225 //config: depends on FIND
227 //config: Support the 'find -links' option for matching number of links.
229 //applet:IF_FIND(APPLET_NOEXEC(find, find, BB_DIR_USR_BIN, BB_SUID_DROP, find))
231 //kbuild:lib-$(CONFIG_FIND) += find.o
233 //usage:#define find_trivial_usage
234 //usage: "[-HL] [PATH]... [OPTIONS] [ACTIONS]"
235 //usage:#define find_full_usage "\n\n"
236 //usage: "Search for files and perform actions on them.\n"
237 //usage: "First failed action stops processing of current file.\n"
238 //usage: "Defaults: PATH is current directory, action is '-print'\n"
239 //usage: "\n -L,-follow Follow symlinks"
240 //usage: "\n -H ...on command line only"
241 //usage: IF_FEATURE_FIND_XDEV(
242 //usage: "\n -xdev Don't descend directories on other filesystems"
244 //usage: IF_FEATURE_FIND_MAXDEPTH(
245 //usage: "\n -maxdepth N Descend at most N levels. -maxdepth 0 applies"
246 //usage: "\n actions to command line arguments only"
247 //usage: "\n -mindepth N Don't act on first N levels"
249 //usage: IF_FEATURE_FIND_DEPTH(
250 //usage: "\n -depth Act on directory *after* traversing it"
253 //usage: "\nActions:"
254 //usage: IF_FEATURE_FIND_PAREN(
255 //usage: "\n ( ACTIONS ) Group actions for -o / -a"
257 //usage: IF_FEATURE_FIND_NOT(
258 //usage: "\n ! ACT Invert ACT's success/failure"
260 //usage: "\n ACT1 [-a] ACT2 If ACT1 fails, stop, else do ACT2"
261 //usage: "\n ACT1 -o ACT2 If ACT1 succeeds, stop, else do ACT2"
262 //usage: "\n Note: -a has higher priority than -o"
263 //usage: "\n -name PATTERN Match file name (w/o directory name) to PATTERN"
264 //usage: "\n -iname PATTERN Case insensitive -name"
265 //usage: IF_FEATURE_FIND_PATH(
266 //usage: "\n -path PATTERN Match path to PATTERN"
267 //usage: "\n -ipath PATTERN Case insensitive -path"
269 //usage: IF_FEATURE_FIND_REGEX(
270 //usage: "\n -regex PATTERN Match path to regex PATTERN"
272 //usage: IF_FEATURE_FIND_TYPE(
273 //usage: "\n -type X File type is X (one of: f,d,l,b,c,s,p)"
275 //usage: IF_FEATURE_FIND_PERM(
276 //usage: "\n -perm MASK At least one mask bit (+MASK), all bits (-MASK),"
277 //usage: "\n or exactly MASK bits are set in file's mode"
279 //usage: IF_FEATURE_FIND_MTIME(
280 //usage: "\n -mtime DAYS mtime is greater than (+N), less than (-N),"
281 //usage: "\n or exactly N days in the past"
283 //usage: IF_FEATURE_FIND_MMIN(
284 //usage: "\n -mmin MINS mtime is greater than (+N), less than (-N),"
285 //usage: "\n or exactly N minutes in the past"
287 //usage: IF_FEATURE_FIND_NEWER(
288 //usage: "\n -newer FILE mtime is more recent than FILE's"
290 //usage: IF_FEATURE_FIND_INUM(
291 //usage: "\n -inum N File has inode number N"
293 //usage: IF_FEATURE_FIND_USER(
294 //usage: "\n -user NAME/ID File is owned by given user"
296 //usage: IF_FEATURE_FIND_GROUP(
297 //usage: "\n -group NAME/ID File is owned by given group"
299 //usage: IF_FEATURE_FIND_SIZE(
300 //usage: "\n -size N[bck] File size is N (c:bytes,k:kbytes,b:512 bytes(def.))"
301 //usage: "\n +/-N: file size is bigger/smaller than N"
303 //usage: IF_FEATURE_FIND_LINKS(
304 //usage: "\n -links N Number of links is greater than (+N), less than (-N),"
305 //usage: "\n or exactly N"
307 //usage: IF_FEATURE_FIND_CONTEXT(
308 //usage: "\n -context CTX File has specified security context"
310 //usage: IF_FEATURE_FIND_PRUNE(
311 //usage: "\n -prune If current file is directory, don't descend into it"
313 //usage: "\nIf none of the following actions is specified, -print is assumed"
314 //usage: "\n -print Print file name"
315 //usage: IF_FEATURE_FIND_PRINT0(
316 //usage: "\n -print0 Print file name, NUL terminated"
318 //usage: IF_FEATURE_FIND_EXEC(
319 //usage: "\n -exec CMD ARG ; Run CMD with all instances of {} replaced by"
320 //usage: "\n file name. Fails if CMD exits with nonzero"
322 //usage: IF_FEATURE_FIND_EXEC_PLUS(
323 //usage: "\n -exec CMD ARG + Run CMD with {} replaced by list of file names"
325 //usage: IF_FEATURE_FIND_DELETE(
326 //usage: "\n -delete Delete current file/directory. Turns on -depth option"
328 //usage: IF_FEATURE_FIND_QUIT(
329 //usage: "\n -quit Exit"
332 //usage:#define find_example_usage
333 //usage: "$ find / -name passwd\n"
334 //usage: "/etc/passwd\n"
338 #include "common_bufsiz.h"
339 #if ENABLE_FEATURE_FIND_REGEX
344 # define FNM_CASEFOLD 0
348 # define dbg(...) ((void)0)
350 # define dbg(...) bb_error_msg(__VA_ARGS__)
354 /* This is a NOEXEC applet. Be very careful! */
357 typedef int (*action_fp)(const char *fileName, const struct stat *statbuf, void *) FAST_FUNC;
361 #if ENABLE_FEATURE_FIND_NOT
366 #define ACTS(name, ...) typedef struct { action a; __VA_ARGS__ } action_##name;
368 static int FAST_FUNC func_##name(const char *fileName UNUSED_PARAM, \
369 const struct stat *statbuf UNUSED_PARAM, \
370 action_##name* ap UNUSED_PARAM)
373 ACTS(name, const char *pattern; bool iname;)
374 IF_FEATURE_FIND_PATH( ACTS(path, const char *pattern; bool ipath;))
375 IF_FEATURE_FIND_REGEX( ACTS(regex, regex_t compiled_pattern;))
376 IF_FEATURE_FIND_PRINT0( ACTS(print0))
377 IF_FEATURE_FIND_TYPE( ACTS(type, int type_mask;))
378 IF_FEATURE_FIND_PERM( ACTS(perm, char perm_char; mode_t perm_mask;))
379 IF_FEATURE_FIND_MTIME( ACTS(mtime, char mtime_char; unsigned mtime_days;))
380 IF_FEATURE_FIND_MMIN( ACTS(mmin, char mmin_char; unsigned mmin_mins;))
381 IF_FEATURE_FIND_NEWER( ACTS(newer, time_t newer_mtime;))
382 IF_FEATURE_FIND_INUM( ACTS(inum, ino_t inode_num;))
383 IF_FEATURE_FIND_USER( ACTS(user, uid_t uid;))
384 IF_FEATURE_FIND_SIZE( ACTS(size, char size_char; off_t size;))
385 IF_FEATURE_FIND_CONTEXT(ACTS(context, security_context_t context;))
386 IF_FEATURE_FIND_PAREN( ACTS(paren, action ***subexpr;))
387 IF_FEATURE_FIND_PRUNE( ACTS(prune))
388 IF_FEATURE_FIND_QUIT( ACTS(quit))
389 IF_FEATURE_FIND_DELETE( ACTS(delete))
390 IF_FEATURE_FIND_EXEC( ACTS(exec,
391 char **exec_argv; /* -exec ARGS */
392 unsigned *subst_count;
393 int exec_argc; /* count of ARGS */
394 IF_FEATURE_FIND_EXEC_PLUS(
396 * filelist is NULL if "exec ;"
397 * non-NULL if "exec +"
404 IF_FEATURE_FIND_GROUP( ACTS(group, gid_t gid;))
405 IF_FEATURE_FIND_LINKS( ACTS(links, char links_char; int links_count;))
408 IF_FEATURE_FIND_XDEV(dev_t *xdev_dev;)
409 IF_FEATURE_FIND_XDEV(int xdev_count;)
410 #if ENABLE_FEATURE_FIND_MAXDEPTH
416 smalluint exitstatus;
417 recurse_flags_t recurse_flags;
418 IF_FEATURE_FIND_EXEC_PLUS(unsigned max_argv_len;)
420 #define G (*(struct globals*)bb_common_bufsiz1)
421 #define INIT_G() do { \
422 setup_common_bufsiz(); \
423 BUILD_BUG_ON(sizeof(G) > COMMON_BUFSIZE); \
424 /* we have to zero it out because of NOEXEC */ \
425 memset(&G, 0, sizeof(G)); \
426 IF_FEATURE_FIND_MAXDEPTH(G.minmaxdepth[1] = INT_MAX;) \
427 IF_FEATURE_FIND_EXEC_PLUS(G.max_argv_len = bb_arg_max() - 2048;) \
429 G.recurse_flags = ACTION_RECURSE; \
432 /* Return values of ACTFs ('action functions') are a bit mask:
433 * bit 1=1: prune (use SKIP constant for setting it)
434 * bit 0=1: matched successfully (TRUE)
437 static int exec_actions(action ***appp, const char *fileName, const struct stat *statbuf)
444 /* "action group" is a set of actions ANDed together.
445 * groups are ORed together.
446 * We simply evaluate each group until we find one in which all actions
449 /* -prune is special: if it is encountered, then we won't
450 * descend into current directory. It doesn't matter whether
451 * action group (in which -prune sits) will succeed or not:
452 * find * -prune -name 'f*' -o -name 'm*' -- prunes every dir
453 * find * -name 'f*' -o -prune -name 'm*' -- prunes all dirs
454 * not starting with 'f' */
456 /* We invert TRUE bit (bit 0). Now 1 there means 'failure'.
457 * and bitwise OR in "rc |= TRUE ^ ap->f()" will:
458 * (1) make SKIP (-prune) bit stick; and (2) detect 'failure'.
459 * On return, bit is restored. */
462 while ((app = appp[++cur_group]) != NULL) {
463 rc &= ~TRUE; /* 'success' so far, clear TRUE bit */
466 ap = app[++cur_action];
467 if (!ap) /* all actions in group were successful */
468 return rc ^ TRUE; /* restore TRUE bit */
469 rc |= TRUE ^ ap->f(fileName, statbuf, ap);
470 #if ENABLE_FEATURE_FIND_NOT
471 if (ap->invert) rc ^= TRUE;
473 dbg("grp %d action %d rc:0x%x", cur_group, cur_action, rc);
474 if (rc & TRUE) /* current group failed, try next */
478 dbg("returning:0x%x", rc ^ TRUE);
479 return rc ^ TRUE; /* restore TRUE bit */
483 static char *strcpy_upcase(char *dst, const char *src)
487 unsigned char ch = *src++;
488 if (ch >= 'a' && ch <= 'z')
501 const char *tmp = bb_basename(fileName);
502 /* GNU findutils: find DIR/ -name DIR
503 * prints "DIR/" (DIR// prints "DIR//" etc).
504 * Need to strip trailing "/".
505 * Such names can come only from top-level names, but
506 * we can't do this before recursive_action() call,
507 * since then "find FILE/ -name FILE"
508 * would also work (on non-directories), which is wrong.
510 char *trunc_slash = NULL;
513 /* "foo/bar/[//...]" */
514 while (tmp != fileName && tmp[-1] == '/')
516 if (tmp == fileName) { /* entire fileName is "//.."? */
517 /* yes, convert "//..." to "/"
519 * find / -maxdepth 1 -name /: prints /
520 * find // -maxdepth 1 -name /: prints //
521 * find / -maxdepth 1 -name //: prints nothing
522 * find // -maxdepth 1 -name //: prints nothing
525 trunc_slash = (char*)tmp + 1;
527 /* no, it's "foo/bar/[//...]", go back to 'b' */
528 trunc_slash = (char*)tmp;
529 while (tmp != fileName && tmp[-1] != '/')
534 /* Was using FNM_PERIOD flag too,
535 * but somewhere between 4.1.20 and 4.4.0 GNU find stopped using it.
536 * find -name '*foo' should match .foo too:
538 if (trunc_slash) *trunc_slash = '\0';
540 r = fnmatch(ap->pattern, tmp, (ap->iname ? FNM_CASEFOLD : 0));
543 tmp = strcpy_upcase(alloca(strlen(tmp) + 1), tmp);
544 r = fnmatch(ap->pattern, tmp, 0);
546 if (trunc_slash) *trunc_slash = '/';
550 #if ENABLE_FEATURE_FIND_PATH
554 return fnmatch(ap->pattern, fileName, (ap->ipath ? FNM_CASEFOLD : 0)) == 0;
557 fileName = strcpy_upcase(alloca(strlen(fileName) + 1), fileName);
558 return fnmatch(ap->pattern, fileName, 0) == 0;
562 #if ENABLE_FEATURE_FIND_REGEX
566 if (regexec(&ap->compiled_pattern, fileName, 1, &match, 0 /*eflags*/))
567 return 0; /* no match */
569 return 0; /* match doesn't start at pos 0 */
570 if (fileName[match.rm_eo])
571 return 0; /* match doesn't end exactly at end of pathname */
575 #if ENABLE_FEATURE_FIND_TYPE
578 return ((statbuf->st_mode & S_IFMT) == ap->type_mask);
581 #if ENABLE_FEATURE_FIND_PERM
584 /* -perm [+/]mode: at least one of perm_mask bits are set */
585 if (ap->perm_char == '+' || ap->perm_char == '/')
586 return (statbuf->st_mode & ap->perm_mask) != 0;
587 /* -perm -mode: all of perm_mask are set */
588 if (ap->perm_char == '-')
589 return (statbuf->st_mode & ap->perm_mask) == ap->perm_mask;
590 /* -perm mode: file mode must match perm_mask */
591 return (statbuf->st_mode & 07777) == ap->perm_mask;
594 #if ENABLE_FEATURE_FIND_MTIME
597 time_t file_age = time(NULL) - statbuf->st_mtime;
598 time_t mtime_secs = ap->mtime_days * 24*60*60;
599 if (ap->mtime_char == '+')
600 return file_age >= mtime_secs + 24*60*60;
601 if (ap->mtime_char == '-')
602 return file_age < mtime_secs;
603 /* just numeric mtime */
604 return file_age >= mtime_secs && file_age < (mtime_secs + 24*60*60);
607 #if ENABLE_FEATURE_FIND_MMIN
610 time_t file_age = time(NULL) - statbuf->st_mtime;
611 time_t mmin_secs = ap->mmin_mins * 60;
612 if (ap->mmin_char == '+')
613 return file_age >= mmin_secs + 60;
614 if (ap->mmin_char == '-')
615 return file_age < mmin_secs;
616 /* just numeric mmin */
617 return file_age >= mmin_secs && file_age < (mmin_secs + 60);
620 #if ENABLE_FEATURE_FIND_NEWER
623 return (ap->newer_mtime < statbuf->st_mtime);
626 #if ENABLE_FEATURE_FIND_INUM
629 return (statbuf->st_ino == ap->inode_num);
632 #if ENABLE_FEATURE_FIND_EXEC
633 static int do_exec(action_exec *ap, const char *fileName)
636 # if ENABLE_FEATURE_FIND_EXEC_PLUS
637 int size = ap->exec_argc + ap->filelist_idx + 1;
639 int size = ap->exec_argc + 1;
641 # if ENABLE_USE_PORTABLE_CODE
642 char **argv = alloca(sizeof(char*) * size);
643 # else /* gcc 4.3.1 generates smaller code: */
648 for (i = 0; i < ap->exec_argc; i++) {
649 const char *arg = ap->exec_argv[i];
651 # if ENABLE_FEATURE_FIND_EXEC_PLUS
653 /* Handling "-exec +"
654 * Only one exec_argv[i] has substitution in it.
655 * Expand that one exec_argv[i] into file list.
657 if (ap->subst_count[i] == 0) {
658 *pp++ = xstrdup(arg);
661 while (ap->filelist[j]) {
662 /* 2nd arg here should be ap->subst_count[i], but it is always 1: */
663 *pp++ = xmalloc_substitute_string(arg, 1, "{}", ap->filelist[j]);
664 free(ap->filelist[j]);
671 /* Handling "-exec ;" */
672 *pp++ = xmalloc_substitute_string(arg, ap->subst_count[i], "{}", fileName);
675 *pp = NULL; /* terminate the list */
677 # if ENABLE_FEATURE_FIND_EXEC_PLUS
679 ap->filelist[0] = NULL;
680 ap->filelist_idx = 0;
685 rc = spawn_and_wait(argv);
687 bb_simple_perror_msg(argv[0]);
692 return rc == 0; /* return 1 if exitcode 0 */
696 # if ENABLE_FEATURE_FIND_EXEC_PLUS
700 ap->filelist = xrealloc_vector(ap->filelist, 8, ap->filelist_idx);
701 ap->filelist[ap->filelist_idx++] = xstrdup(fileName);
702 ap->file_len += strlen(fileName) + sizeof(char*) + 1;
703 /* If we have lots of files already, exec the command */
705 if (ap->file_len >= G.max_argv_len)
706 rc = do_exec(ap, NULL);
710 return do_exec(ap, fileName);
712 # if ENABLE_FEATURE_FIND_EXEC_PLUS
713 static int flush_exec_plus(void)
717 action ***appp = G.actions;
718 while ((app = *appp++) != NULL) {
719 while ((ap = *app++) != NULL) {
720 if (ap->f == (action_fp)func_exec) {
721 action_exec *ae = (void*)ap;
722 if (ae->filelist_idx != 0) {
723 int rc = do_exec(ae, NULL);
724 # if ENABLE_FEATURE_FIND_NOT
725 if (ap->invert) rc = !rc;
737 #if ENABLE_FEATURE_FIND_USER
740 return (statbuf->st_uid == ap->uid);
743 #if ENABLE_FEATURE_FIND_GROUP
746 return (statbuf->st_gid == ap->gid);
749 #if ENABLE_FEATURE_FIND_PRINT0
752 printf("%s%c", fileName, '\0');
761 #if ENABLE_FEATURE_FIND_PAREN
764 return exec_actions(ap->subexpr, fileName, statbuf);
767 #if ENABLE_FEATURE_FIND_SIZE
770 if (ap->size_char == '+')
771 return statbuf->st_size > ap->size;
772 if (ap->size_char == '-')
773 return statbuf->st_size < ap->size;
774 return statbuf->st_size == ap->size;
777 #if ENABLE_FEATURE_FIND_PRUNE
779 * -prune: if -depth is not given, return true and do not descend
780 * current dir; if -depth is given, return false with no effect.
782 * find dir -name 'asm-*' -prune -o -name '*.[chS]' -print
789 #if ENABLE_FEATURE_FIND_QUIT
795 #if ENABLE_FEATURE_FIND_DELETE
799 if (S_ISDIR(statbuf->st_mode)) {
800 /* "find . -delete" skips rmdir(".") */
802 if (NOT_LONE_CHAR(fileName, '.'))
803 rc = rmdir(fileName);
805 rc = unlink(fileName);
808 bb_simple_perror_msg(fileName);
812 #if ENABLE_FEATURE_FIND_CONTEXT
815 security_context_t con;
818 if (G.recurse_flags & ACTION_FOLLOWLINKS) {
819 rc = getfilecon(fileName, &con);
821 rc = lgetfilecon(fileName, &con);
825 rc = strcmp(ap->context, con);
830 #if ENABLE_FEATURE_FIND_LINKS
833 switch(ap->links_char) {
834 case '-' : return (statbuf->st_nlink < ap->links_count);
835 case '+' : return (statbuf->st_nlink > ap->links_count);
836 default: return (statbuf->st_nlink == ap->links_count);
841 static int FAST_FUNC fileAction(const char *fileName,
842 struct stat *statbuf,
843 void *userData UNUSED_PARAM,
844 int depth IF_NOT_FEATURE_FIND_MAXDEPTH(UNUSED_PARAM))
849 #if ENABLE_FEATURE_FIND_XDEV
850 if (S_ISDIR(statbuf->st_mode) && G.xdev_count) {
852 for (i = 0; i < G.xdev_count; i++) {
853 if (G.xdev_dev[i] == statbuf->st_dev)
856 //bb_error_msg("'%s': not same fs", fileName);
862 #if ENABLE_FEATURE_FIND_MAXDEPTH
863 if (depth < G.minmaxdepth[0]) {
865 return TRUE; /* skip this, continue recursing */
866 return SKIP; /* stop recursing */
868 if (depth > G.minmaxdepth[1])
869 return SKIP; /* stop recursing */
872 r = exec_actions(G.actions, fileName, statbuf);
873 /* Had no explicit -print[0] or -exec? then print */
874 if ((r & TRUE) && G.need_print)
877 #if ENABLE_FEATURE_FIND_MAXDEPTH
878 if (S_ISDIR(statbuf->st_mode)) {
879 if (depth == G.minmaxdepth[1])
883 /* -xdev stops on mountpoints, but AFTER mountpoit itself
884 * is processed as usual */
889 /* Cannot return 0: our caller, recursive_action(),
890 * will perror() and skip dirs (if called on dir) */
891 return (r & SKIP) ? SKIP : TRUE;
895 #if ENABLE_FEATURE_FIND_TYPE
896 static int find_type(const char *type)
902 else if (*type == 'c')
904 else if (*type == 'd')
906 else if (*type == 'p')
908 else if (*type == 'f')
910 else if (*type == 'l')
912 else if (*type == 's')
915 if (mask == 0 || type[1] != '\0')
916 bb_error_msg_and_die(bb_msg_invalid_arg_to, type, "-type");
922 #if ENABLE_FEATURE_FIND_PERM \
923 || ENABLE_FEATURE_FIND_MTIME || ENABLE_FEATURE_FIND_MMIN \
924 || ENABLE_FEATURE_FIND_SIZE || ENABLE_FEATURE_FIND_LINKS
925 static const char* plus_minus_num(const char* str)
927 if (*str == '-' || *str == '+')
933 /* Say no to GCCism */
934 #define USE_NESTED_FUNCTION 0
936 #if !USE_NESTED_FUNCTION
941 IF_FEATURE_FIND_NOT( bool invert_flag; )
943 static action* alloc_action(struct pp_locals *ppl, int sizeof_struct, action_fp f)
945 action *ap = xzalloc(sizeof_struct);
947 action ***group = &ppl->appp[ppl->cur_group];
948 *group = app = xrealloc(*group, (ppl->cur_action+2) * sizeof(ppl->appp[0][0]));
949 app[ppl->cur_action++] = ap;
950 app[ppl->cur_action] = NULL;
952 IF_FEATURE_FIND_NOT( ap->invert = ppl->invert_flag; )
953 IF_FEATURE_FIND_NOT( ppl->invert_flag = 0; )
958 static action*** parse_params(char **argv)
962 IF_FEATURE_FIND_XDEV( OPT_XDEV ,)
963 IF_FEATURE_FIND_DEPTH( OPT_DEPTH ,)
966 IF_FEATURE_FIND_NOT( PARM_char_not ,)
970 IF_FEATURE_FIND_NOT( PARM_not ,)
973 IF_FEATURE_FIND_PRINT0( PARM_print0 ,)
974 IF_FEATURE_FIND_PRUNE( PARM_prune ,)
975 IF_FEATURE_FIND_QUIT( PARM_quit ,)
976 IF_FEATURE_FIND_DELETE( PARM_delete ,)
977 IF_FEATURE_FIND_EXEC( PARM_exec ,)
978 IF_FEATURE_FIND_PAREN( PARM_char_brace,)
979 /* All options/actions starting from here require argument */
982 IF_FEATURE_FIND_PATH( PARM_path ,)
984 /* -wholename is a synonym for -path */
985 /* We support it because Linux kernel's "make tags" uses it */
986 IF_FEATURE_FIND_PATH( PARM_wholename ,)
988 IF_FEATURE_FIND_PATH( PARM_ipath ,)
989 IF_FEATURE_FIND_REGEX( PARM_regex ,)
990 IF_FEATURE_FIND_TYPE( PARM_type ,)
991 IF_FEATURE_FIND_PERM( PARM_perm ,)
992 IF_FEATURE_FIND_MTIME( PARM_mtime ,)
993 IF_FEATURE_FIND_MMIN( PARM_mmin ,)
994 IF_FEATURE_FIND_NEWER( PARM_newer ,)
995 IF_FEATURE_FIND_INUM( PARM_inum ,)
996 IF_FEATURE_FIND_USER( PARM_user ,)
997 IF_FEATURE_FIND_GROUP( PARM_group ,)
998 IF_FEATURE_FIND_SIZE( PARM_size ,)
999 IF_FEATURE_FIND_CONTEXT(PARM_context ,)
1000 IF_FEATURE_FIND_LINKS( PARM_links ,)
1001 IF_FEATURE_FIND_MAXDEPTH(OPT_MINDEPTH,OPT_MAXDEPTH,)
1004 static const char params[] ALIGN1 =
1006 IF_FEATURE_FIND_XDEV( "-xdev\0" )
1007 IF_FEATURE_FIND_DEPTH( "-depth\0" )
1010 IF_FEATURE_FIND_NOT( "!\0" )
1014 IF_FEATURE_FIND_NOT( "-not\0" )
1017 IF_FEATURE_FIND_PRINT0( "-print0\0" )
1018 IF_FEATURE_FIND_PRUNE( "-prune\0" )
1019 IF_FEATURE_FIND_QUIT( "-quit\0" )
1020 IF_FEATURE_FIND_DELETE( "-delete\0" )
1021 IF_FEATURE_FIND_EXEC( "-exec\0" )
1022 IF_FEATURE_FIND_PAREN( "(\0" )
1023 /* All options/actions starting from here require argument */
1026 IF_FEATURE_FIND_PATH( "-path\0" )
1028 IF_FEATURE_FIND_PATH( "-wholename\0")
1030 IF_FEATURE_FIND_PATH( "-ipath\0" )
1031 IF_FEATURE_FIND_REGEX( "-regex\0" )
1032 IF_FEATURE_FIND_TYPE( "-type\0" )
1033 IF_FEATURE_FIND_PERM( "-perm\0" )
1034 IF_FEATURE_FIND_MTIME( "-mtime\0" )
1035 IF_FEATURE_FIND_MMIN( "-mmin\0" )
1036 IF_FEATURE_FIND_NEWER( "-newer\0" )
1037 IF_FEATURE_FIND_INUM( "-inum\0" )
1038 IF_FEATURE_FIND_USER( "-user\0" )
1039 IF_FEATURE_FIND_GROUP( "-group\0" )
1040 IF_FEATURE_FIND_SIZE( "-size\0" )
1041 IF_FEATURE_FIND_CONTEXT("-context\0")
1042 IF_FEATURE_FIND_LINKS( "-links\0" )
1043 IF_FEATURE_FIND_MAXDEPTH("-mindepth\0""-maxdepth\0")
1046 #if !USE_NESTED_FUNCTION
1047 struct pp_locals ppl;
1048 #define appp (ppl.appp )
1049 #define cur_group (ppl.cur_group )
1050 #define cur_action (ppl.cur_action )
1051 #define invert_flag (ppl.invert_flag)
1052 #define ALLOC_ACTION(name) (action_##name*)alloc_action(&ppl, sizeof(action_##name), (action_fp) func_##name)
1056 unsigned cur_action;
1057 IF_FEATURE_FIND_NOT( bool invert_flag; )
1059 /* This is the only place in busybox where we use nested function.
1060 * So far more standard alternatives were bigger. */
1061 /* Auto decl suppresses "func without a prototype" warning: */
1062 auto action* alloc_action(int sizeof_struct, action_fp f);
1063 action* alloc_action(int sizeof_struct, action_fp f)
1066 appp[cur_group] = xrealloc(appp[cur_group], (cur_action+2) * sizeof(appp[0][0]));
1067 appp[cur_group][cur_action++] = ap = xzalloc(sizeof_struct);
1068 appp[cur_group][cur_action] = NULL;
1070 IF_FEATURE_FIND_NOT( ap->invert = invert_flag; )
1071 IF_FEATURE_FIND_NOT( invert_flag = 0; )
1074 #define ALLOC_ACTION(name) (action_##name*)alloc_action(sizeof(action_##name), (action_fp) func_##name)
1079 IF_FEATURE_FIND_NOT( invert_flag = 0; )
1080 appp = xzalloc(2 * sizeof(appp[0])); /* appp[0],[1] == NULL */
1083 const char *arg = argv[0];
1084 int parm = index_in_strings(params, arg);
1085 const char *arg1 = argv[1];
1087 dbg("arg:'%s' arg1:'%s' parm:%d PARM_type:%d", arg, arg1, parm, PARM_type);
1089 if (parm >= PARM_name) {
1090 /* All options/actions starting from -name require argument */
1092 bb_error_msg_and_die(bb_msg_requires_arg, arg);
1096 /* We can use big switch() here, but on i386
1097 * it doesn't give smaller code. Other arches? */
1099 /* Options always return true. They always take effect
1100 * rather than being processed only when their place in the
1101 * expression is reached.
1104 if (parm == OPT_FOLLOW) {
1105 dbg("follow enabled: %d", __LINE__);
1106 G.recurse_flags |= ACTION_FOLLOWLINKS | ACTION_DANGLING_OK;
1108 #if ENABLE_FEATURE_FIND_XDEV
1109 else if (parm == OPT_XDEV) {
1110 dbg("%d", __LINE__);
1114 #if ENABLE_FEATURE_FIND_MAXDEPTH
1115 else if (parm == OPT_MINDEPTH || parm == OPT_MINDEPTH + 1) {
1116 dbg("%d", __LINE__);
1117 G.minmaxdepth[parm - OPT_MINDEPTH] = xatoi_positive(arg1);
1120 #if ENABLE_FEATURE_FIND_DEPTH
1121 else if (parm == OPT_DEPTH) {
1122 dbg("%d", __LINE__);
1123 G.recurse_flags |= ACTION_DEPTHFIRST;
1126 /* Actions are grouped by operators
1127 * ( expr ) Force precedence
1128 * ! expr True if expr is false
1129 * -not expr Same as ! expr
1130 * expr1 [-a[nd]] expr2 And; expr2 is not evaluated if expr1 is false
1131 * expr1 -o[r] expr2 Or; expr2 is not evaluated if expr1 is true
1132 * expr1 , expr2 List; both expr1 and expr2 are always evaluated
1133 * We implement: (), -a, -o
1136 else if (parm == PARM_a IF_DESKTOP(|| parm == PARM_and)) {
1137 dbg("%d", __LINE__);
1138 /* no further special handling required */
1140 else if (parm == PARM_o IF_DESKTOP(|| parm == PARM_or)) {
1141 dbg("%d", __LINE__);
1142 /* start new OR group */
1144 appp = xrealloc(appp, (cur_group+2) * sizeof(appp[0]));
1145 /*appp[cur_group] = NULL; - already NULL */
1146 appp[cur_group+1] = NULL;
1149 #if ENABLE_FEATURE_FIND_NOT
1150 else if (parm == PARM_char_not IF_DESKTOP(|| parm == PARM_not)) {
1151 /* also handles "find ! ! -name 'foo*'" */
1153 dbg("invert_flag:%d", invert_flag);
1157 else if (parm == PARM_print) {
1158 dbg("%d", __LINE__);
1160 (void) ALLOC_ACTION(print);
1162 #if ENABLE_FEATURE_FIND_PRINT0
1163 else if (parm == PARM_print0) {
1164 dbg("%d", __LINE__);
1166 (void) ALLOC_ACTION(print0);
1169 #if ENABLE_FEATURE_FIND_PRUNE
1170 else if (parm == PARM_prune) {
1171 dbg("%d", __LINE__);
1172 (void) ALLOC_ACTION(prune);
1175 #if ENABLE_FEATURE_FIND_QUIT
1176 else if (parm == PARM_quit) {
1177 dbg("%d", __LINE__);
1178 (void) ALLOC_ACTION(quit);
1181 #if ENABLE_FEATURE_FIND_DELETE
1182 else if (parm == PARM_delete) {
1183 dbg("%d", __LINE__);
1185 G.recurse_flags |= ACTION_DEPTHFIRST;
1186 (void) ALLOC_ACTION(delete);
1189 #if ENABLE_FEATURE_FIND_EXEC
1190 else if (parm == PARM_exec) {
1193 IF_FEATURE_FIND_EXEC_PLUS(int all_subst = 0;)
1194 dbg("%d", __LINE__);
1196 ap = ALLOC_ACTION(exec);
1197 ap->exec_argv = ++argv; /* first arg after -exec */
1198 /*ap->exec_argc = 0; - ALLOC_ACTION did it */
1200 if (!*argv) /* did not see ';' or '+' until end */
1201 bb_error_msg_and_die(bb_msg_requires_arg, "-exec");
1202 // find -exec echo Foo ">{}<" ";"
1203 // executes "echo Foo >FILENAME<",
1204 // find -exec echo Foo ">{}<" "+"
1205 // executes "echo Foo FILENAME1 FILENAME2 FILENAME3...".
1206 if ((argv[0][0] == ';' || argv[0][0] == '+')
1207 && argv[0][1] == '\0'
1209 # if ENABLE_FEATURE_FIND_EXEC_PLUS
1210 if (argv[0][0] == '+')
1211 ap->filelist = xzalloc(sizeof(ap->filelist[0]));
1218 if (ap->exec_argc == 0)
1219 bb_error_msg_and_die(bb_msg_requires_arg, arg);
1220 ap->subst_count = xmalloc(ap->exec_argc * sizeof(int));
1223 ap->subst_count[i] = count_strstr(ap->exec_argv[i], "{}");
1224 IF_FEATURE_FIND_EXEC_PLUS(all_subst += ap->subst_count[i];)
1226 # if ENABLE_FEATURE_FIND_EXEC_PLUS
1228 * coreutils expects {} to appear only once in "-exec +"
1230 if (all_subst != 1 && ap->filelist)
1231 bb_error_msg_and_die("only one '{}' allowed for -exec +");
1235 #if ENABLE_FEATURE_FIND_PAREN
1236 else if (parm == PARM_char_brace) {
1239 unsigned nested = 1;
1241 dbg("%d", __LINE__);
1245 bb_error_msg_and_die("unpaired '('");
1246 if (LONE_CHAR(*endarg, '('))
1248 else if (LONE_CHAR(*endarg, ')') && !--nested) {
1253 ap = ALLOC_ACTION(paren);
1254 ap->subexpr = parse_params(argv + 1);
1255 *endarg = (char*) ")"; /* restore NULLed parameter */
1259 else if (parm == PARM_name || parm == PARM_iname) {
1261 dbg("%d", __LINE__);
1262 ap = ALLOC_ACTION(name);
1264 ap->iname = (parm == PARM_iname);
1266 #if ENABLE_FEATURE_FIND_PATH
1267 else if (parm == PARM_path IF_DESKTOP(|| parm == PARM_wholename) || parm == PARM_ipath) {
1269 dbg("%d", __LINE__);
1270 ap = ALLOC_ACTION(path);
1272 ap->ipath = (parm == PARM_ipath);
1275 #if ENABLE_FEATURE_FIND_REGEX
1276 else if (parm == PARM_regex) {
1278 dbg("%d", __LINE__);
1279 ap = ALLOC_ACTION(regex);
1280 xregcomp(&ap->compiled_pattern, arg1, 0 /*cflags*/);
1283 #if ENABLE_FEATURE_FIND_TYPE
1284 else if (parm == PARM_type) {
1286 ap = ALLOC_ACTION(type);
1287 ap->type_mask = find_type(arg1);
1288 dbg("created:type mask:%x", ap->type_mask);
1291 #if ENABLE_FEATURE_FIND_PERM
1292 /* -perm BITS File's mode bits are exactly BITS (octal or symbolic).
1293 * Symbolic modes use mode 0 as a point of departure.
1294 * -perm -BITS All of the BITS are set in file's mode.
1295 * -perm [+/]BITS At least one of the BITS is set in file's mode.
1297 else if (parm == PARM_perm) {
1299 dbg("%d", __LINE__);
1300 ap = ALLOC_ACTION(perm);
1301 ap->perm_char = arg1[0];
1302 arg1 = (arg1[0] == '/' ? arg1+1 : plus_minus_num(arg1));
1303 /*ap->perm_mask = 0; - ALLOC_ACTION did it */
1304 ap->perm_mask = bb_parse_mode(arg1, ap->perm_mask);
1305 if (ap->perm_mask == (mode_t)-1)
1306 bb_error_msg_and_die("invalid mode '%s'", arg1);
1309 #if ENABLE_FEATURE_FIND_MTIME
1310 else if (parm == PARM_mtime) {
1312 dbg("%d", __LINE__);
1313 ap = ALLOC_ACTION(mtime);
1314 ap->mtime_char = arg1[0];
1315 ap->mtime_days = xatoul(plus_minus_num(arg1));
1318 #if ENABLE_FEATURE_FIND_MMIN
1319 else if (parm == PARM_mmin) {
1321 dbg("%d", __LINE__);
1322 ap = ALLOC_ACTION(mmin);
1323 ap->mmin_char = arg1[0];
1324 ap->mmin_mins = xatoul(plus_minus_num(arg1));
1327 #if ENABLE_FEATURE_FIND_NEWER
1328 else if (parm == PARM_newer) {
1329 struct stat stat_newer;
1331 dbg("%d", __LINE__);
1332 ap = ALLOC_ACTION(newer);
1333 xstat(arg1, &stat_newer);
1334 ap->newer_mtime = stat_newer.st_mtime;
1337 #if ENABLE_FEATURE_FIND_INUM
1338 else if (parm == PARM_inum) {
1340 dbg("%d", __LINE__);
1341 ap = ALLOC_ACTION(inum);
1342 ap->inode_num = xatoul(arg1);
1345 #if ENABLE_FEATURE_FIND_USER
1346 else if (parm == PARM_user) {
1348 dbg("%d", __LINE__);
1349 ap = ALLOC_ACTION(user);
1350 ap->uid = bb_strtou(arg1, NULL, 10);
1352 ap->uid = xuname2uid(arg1);
1355 #if ENABLE_FEATURE_FIND_GROUP
1356 else if (parm == PARM_group) {
1358 dbg("%d", __LINE__);
1359 ap = ALLOC_ACTION(group);
1360 ap->gid = bb_strtou(arg1, NULL, 10);
1362 ap->gid = xgroup2gid(arg1);
1365 #if ENABLE_FEATURE_FIND_SIZE
1366 else if (parm == PARM_size) {
1367 /* -size n[bckw]: file uses n units of space
1368 * b (default): units are 512-byte blocks
1374 #define XATOU_SFX xatoull_sfx
1376 #define XATOU_SFX xatoul_sfx
1378 static const struct suffix_mult find_suffixes[] = {
1387 dbg("%d", __LINE__);
1388 ap = ALLOC_ACTION(size);
1389 ap->size_char = arg1[0];
1390 ap->size = XATOU_SFX(plus_minus_num(arg1), find_suffixes);
1393 #if ENABLE_FEATURE_FIND_CONTEXT
1394 else if (parm == PARM_context) {
1396 dbg("%d", __LINE__);
1397 ap = ALLOC_ACTION(context);
1398 /*ap->context = NULL; - ALLOC_ACTION did it */
1399 /* SELinux headers erroneously declare non-const parameter */
1400 if (selinux_raw_to_trans_context((char*)arg1, &ap->context))
1401 bb_simple_perror_msg(arg1);
1404 #if ENABLE_FEATURE_FIND_LINKS
1405 else if (parm == PARM_links) {
1407 dbg("%d", __LINE__);
1408 ap = ALLOC_ACTION(links);
1409 ap->links_char = arg1[0];
1410 ap->links_count = xatoul(plus_minus_num(arg1));
1414 bb_error_msg("unrecognized: %s", arg);
1419 dbg("exiting %s", __func__);
1427 int find_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
1428 int find_main(int argc UNUSED_PARAM, char **argv)
1431 char **past_HLP, *saved;
1435 /* "find -type f" + getopt("+HLP") => disaster.
1436 * Need to avoid getopt running into a non-HLP option.
1437 * Do this by temporarily storing NULL there:
1441 saved = *++past_HLP;
1444 if (saved[0] != '-')
1447 break; /* it is "-" */
1448 if ((saved+1)[strspn(saved+1, "HLP")] != '\0')
1452 /* "+": stop on first non-option */
1453 i = getopt32(argv, "+HLP");
1455 G.recurse_flags |= ACTION_FOLLOWLINKS_L0 | ACTION_DANGLING_OK;
1457 G.recurse_flags |= ACTION_FOLLOWLINKS | ACTION_DANGLING_OK;
1458 /* -P is default and is ignored */
1459 argv = past_HLP; /* same result as "argv += optind;" */
1462 for (firstopt = 0; argv[firstopt]; firstopt++) {
1463 if (argv[firstopt][0] == '-')
1465 if (ENABLE_FEATURE_FIND_NOT && LONE_CHAR(argv[firstopt], '!'))
1467 if (ENABLE_FEATURE_FIND_PAREN && LONE_CHAR(argv[firstopt], '('))
1470 if (firstopt == 0) {
1471 *--argv = (char*)".";
1475 G.actions = parse_params(&argv[firstopt]);
1476 argv[firstopt] = NULL;
1478 #if ENABLE_FEATURE_FIND_XDEV
1482 G.xdev_count = firstopt;
1483 G.xdev_dev = xzalloc(G.xdev_count * sizeof(G.xdev_dev[0]));
1484 for (i = 0; argv[i]; i++) {
1485 /* not xstat(): shouldn't bomb out on
1486 * "find not_exist exist -xdev" */
1487 if (stat(argv[i], &stbuf) == 0)
1488 G.xdev_dev[i] = stbuf.st_dev;
1489 /* else G.xdev_dev[i] stays 0 and
1490 * won't match any real device dev_t
1496 for (i = 0; argv[i]; i++) {
1497 if (!recursive_action(argv[i],
1498 G.recurse_flags,/* flags */
1499 fileAction, /* file action */
1500 fileAction, /* dir action */
1501 NULL, /* user data */
1504 G.exitstatus |= EXIT_FAILURE;
1508 IF_FEATURE_FIND_EXEC_PLUS(G.exitstatus |= flush_exec_plus();)
1509 return G.exitstatus;