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.
15 * # find file.txt -exec 'echo {}' '{} {}' ';'
16 * find: echo file.txt: No such file or directory
17 * # find file.txt -exec 'echo' '{} {}' '; '
18 * find: missing argument to `-exec'
19 * # find file.txt -exec 'echo {}' '{} {}' ';' junk
20 * find: paths must precede expression
21 * # find file.txt -exec 'echo {}' '{} {}' ';' junk ';'
22 * find: paths must precede expression
23 * # find file.txt -exec 'echo' '{} {}' ';'
25 * (strace: execve("/bin/echo", ["echo", "file.txt file.txt"], [ 30 vars ]))
26 * # find file.txt -exec 'echo' '{} {}' ';' -print -exec pwd ';'
30 * # find -name '*.c' -o -name '*.h'
31 * [shows files, *.c and *.h intermixed]
32 * # find file.txt -name '*f*' -o -name '*t*'
34 * # find file.txt -name '*z*' -o -name '*t*'
36 * # find file.txt -name '*f*' -o -name '*z*'
39 * # find t z -name '*t*' -print -o -name '*z*'
41 * # find t z t z -name '*t*' -o -name '*z*' -print
44 * # find t z t z '(' -name '*t*' -o -name '*z*' ')' -o -print
49 * ./busybox find "$@" | tee /tmp/bb_find
50 * echo ==================
51 * /path/to/gnu/find "$@" | tee /tmp/std_find
52 * echo ==================
53 * diff -u /tmp/std_find /tmp/bb_find && echo Identical
60 //config: find is used to search your system to find specified files.
62 //config:config FEATURE_FIND_PRINT0
63 //config: bool "Enable -print0: NUL-terminated output"
65 //config: depends on FIND
67 //config: Causes output names to be separated by a NUL character
68 //config: rather than a newline. This allows names that contain
69 //config: newlines and other whitespace to be more easily
70 //config: interpreted by other programs.
72 //config:config FEATURE_FIND_MTIME
73 //config: bool "Enable -mtime: modified time matching"
75 //config: depends on FIND
77 //config: Allow searching based on the modification time of
78 //config: files, in days.
80 //config:config FEATURE_FIND_MMIN
81 //config: bool "Enable -mmin: modified time matching by minutes"
83 //config: depends on FIND
85 //config: Allow searching based on the modification time of
86 //config: files, in minutes.
88 //config:config FEATURE_FIND_PERM
89 //config: bool "Enable -perm: permissions matching"
91 //config: depends on FIND
93 //config: Enable searching based on file permissions.
95 //config:config FEATURE_FIND_TYPE
96 //config: bool "Enable -type: file type matching (file/dir/link/...)"
98 //config: depends on FIND
100 //config: Enable searching based on file type (file,
101 //config: directory, socket, device, etc.).
103 //config:config FEATURE_FIND_XDEV
104 //config: bool "Enable -xdev: 'stay in filesystem'"
106 //config: depends on FIND
108 //config: This option allows find to restrict searches to a single filesystem.
110 //config:config FEATURE_FIND_MAXDEPTH
111 //config: bool "Enable -mindepth N and -maxdepth N"
113 //config: depends on FIND
115 //config: This option enables -mindepth N and -maxdepth N option.
117 //config:config FEATURE_FIND_NEWER
118 //config: bool "Enable -newer: compare file modification times"
120 //config: depends on FIND
122 //config: Support the 'find -newer' option for finding any files which have
123 //config: modification time that is more recent than the specified FILE.
125 //config:config FEATURE_FIND_INUM
126 //config: bool "Enable -inum: inode number matching"
128 //config: depends on FIND
130 //config: Support the 'find -inum' option for searching by inode number.
132 //config:config FEATURE_FIND_EXEC
133 //config: bool "Enable -exec: execute commands"
135 //config: depends on FIND
137 //config: Support the 'find -exec' option for executing commands based upon
138 //config: the files matched.
140 //config:config FEATURE_FIND_EXEC_PLUS
141 //config: bool "Enable -exec ... {} +"
143 //config: depends on FEATURE_FIND_EXEC
145 //config: Support the 'find -exec ... {} +' option for executing commands
146 //config: for all matched files at once.
147 //config: Without this option, -exec + is a synonym for -exec ;
148 //config: (IOW: it works correctly, but without expected speedup)
150 //config:config FEATURE_FIND_USER
151 //config: bool "Enable -user: username/uid matching"
153 //config: depends on FIND
155 //config: Support the 'find -user' option for searching by username or uid.
157 //config:config FEATURE_FIND_GROUP
158 //config: bool "Enable -group: group/gid matching"
160 //config: depends on FIND
162 //config: Support the 'find -group' option for searching by group name or gid.
164 //config:config FEATURE_FIND_NOT
165 //config: bool "Enable the 'not' (!) operator"
167 //config: depends on FIND
169 //config: Support the '!' operator to invert the test results.
170 //config: If 'Enable full-blown desktop' is enabled, then will also support
171 //config: the non-POSIX notation '-not'.
173 //config:config FEATURE_FIND_DEPTH
174 //config: bool "Enable -depth"
176 //config: depends on FIND
178 //config: Process each directory's contents before the directory itself.
180 //config:config FEATURE_FIND_PAREN
181 //config: bool "Enable parens in options"
183 //config: depends on FIND
185 //config: Enable usage of parens '(' to specify logical order of arguments.
187 //config:config FEATURE_FIND_SIZE
188 //config: bool "Enable -size: file size matching"
190 //config: depends on FIND
192 //config: Support the 'find -size' option for searching by file size.
194 //config:config FEATURE_FIND_PRUNE
195 //config: bool "Enable -prune: exclude subdirectories"
197 //config: depends on FIND
199 //config: If the file is a directory, dont descend into it. Useful for
200 //config: exclusion .svn and CVS directories.
202 //config:config FEATURE_FIND_DELETE
203 //config: bool "Enable -delete: delete files/dirs"
205 //config: depends on FIND && FEATURE_FIND_DEPTH
207 //config: Support the 'find -delete' option for deleting files and directories.
208 //config: WARNING: This option can do much harm if used wrong. Busybox will not
209 //config: try to protect the user from doing stupid things. Use with care.
211 //config:config FEATURE_FIND_PATH
212 //config: bool "Enable -path: match pathname with shell pattern"
214 //config: depends on FIND
216 //config: The -path option matches whole pathname instead of just filename.
218 //config:config FEATURE_FIND_REGEX
219 //config: bool "Enable -regex: match pathname with regex"
221 //config: depends on FIND
223 //config: The -regex option matches whole pathname against regular expression.
225 //config:config FEATURE_FIND_CONTEXT
226 //config: bool "Enable -context: security context matching"
228 //config: depends on FIND && SELINUX
230 //config: Support the 'find -context' option for matching security context.
232 //config:config FEATURE_FIND_LINKS
233 //config: bool "Enable -links: link count matching"
235 //config: depends on FIND
237 //config: Support the 'find -links' option for matching number of links.
239 //applet:IF_FIND(APPLET_NOEXEC(find, find, BB_DIR_USR_BIN, BB_SUID_DROP, find))
241 //kbuild:lib-$(CONFIG_FIND) += find.o
243 //usage:#define find_trivial_usage
244 //usage: "[-HL] [PATH]... [OPTIONS] [ACTIONS]"
245 //usage:#define find_full_usage "\n\n"
246 //usage: "Search for files and perform actions on them.\n"
247 //usage: "First failed action stops processing of current file.\n"
248 //usage: "Defaults: PATH is current directory, action is '-print'\n"
249 //usage: "\n -L,-follow Follow symlinks"
250 //usage: "\n -H ...on command line only"
251 //usage: IF_FEATURE_FIND_XDEV(
252 //usage: "\n -xdev Don't descend directories on other filesystems"
254 //usage: IF_FEATURE_FIND_MAXDEPTH(
255 //usage: "\n -maxdepth N Descend at most N levels. -maxdepth 0 applies"
256 //usage: "\n actions to command line arguments only"
257 //usage: "\n -mindepth N Don't act on first N levels"
259 //usage: IF_FEATURE_FIND_DEPTH(
260 //usage: "\n -depth Act on directory *after* traversing it"
263 //usage: "\nActions:"
264 //usage: IF_FEATURE_FIND_PAREN(
265 //usage: "\n ( ACTIONS ) Group actions for -o / -a"
267 //usage: IF_FEATURE_FIND_NOT(
268 //usage: "\n ! ACT Invert ACT's success/failure"
270 //usage: "\n ACT1 [-a] ACT2 If ACT1 fails, stop, else do ACT2"
271 //usage: "\n ACT1 -o ACT2 If ACT1 succeeds, stop, else do ACT2"
272 //usage: "\n Note: -a has higher priority than -o"
273 //usage: "\n -name PATTERN Match file name (w/o directory name) to PATTERN"
274 //usage: "\n -iname PATTERN Case insensitive -name"
275 //usage: IF_FEATURE_FIND_PATH(
276 //usage: "\n -path PATTERN Match path to PATTERN"
277 //usage: "\n -ipath PATTERN Case insensitive -path"
279 //usage: IF_FEATURE_FIND_REGEX(
280 //usage: "\n -regex PATTERN Match path to regex PATTERN"
282 //usage: IF_FEATURE_FIND_TYPE(
283 //usage: "\n -type X File type is X (one of: f,d,l,b,c,...)"
285 //usage: IF_FEATURE_FIND_PERM(
286 //usage: "\n -perm MASK At least one mask bit (+MASK), all bits (-MASK),"
287 //usage: "\n or exactly MASK bits are set in file's mode"
289 //usage: IF_FEATURE_FIND_MTIME(
290 //usage: "\n -mtime DAYS mtime is greater than (+N), less than (-N),"
291 //usage: "\n or exactly N days in the past"
293 //usage: IF_FEATURE_FIND_MMIN(
294 //usage: "\n -mmin MINS mtime is greater than (+N), less than (-N),"
295 //usage: "\n or exactly N minutes in the past"
297 //usage: IF_FEATURE_FIND_NEWER(
298 //usage: "\n -newer FILE mtime is more recent than FILE's"
300 //usage: IF_FEATURE_FIND_INUM(
301 //usage: "\n -inum N File has inode number N"
303 //usage: IF_FEATURE_FIND_USER(
304 //usage: "\n -user NAME/ID File is owned by given user"
306 //usage: IF_FEATURE_FIND_GROUP(
307 //usage: "\n -group NAME/ID File is owned by given group"
309 //usage: IF_FEATURE_FIND_SIZE(
310 //usage: "\n -size N[bck] File size is N (c:bytes,k:kbytes,b:512 bytes(def.))"
311 //usage: "\n +/-N: file size is bigger/smaller than N"
313 //usage: IF_FEATURE_FIND_LINKS(
314 //usage: "\n -links N Number of links is greater than (+N), less than (-N),"
315 //usage: "\n or exactly N"
317 //usage: IF_FEATURE_FIND_CONTEXT(
318 //usage: "\n -context CTX File has specified security context"
320 //usage: IF_FEATURE_FIND_PRUNE(
321 //usage: "\n -prune If current file is directory, don't descend into it"
323 //usage: "\nIf none of the following actions is specified, -print is assumed"
324 //usage: "\n -print Print file name"
325 //usage: IF_FEATURE_FIND_PRINT0(
326 //usage: "\n -print0 Print file name, NUL terminated"
328 //usage: IF_FEATURE_FIND_EXEC(
329 //usage: "\n -exec CMD ARG ; Run CMD with all instances of {} replaced by"
330 //usage: "\n file name. Fails if CMD exits with nonzero"
332 //usage: IF_FEATURE_FIND_EXEC_PLUS(
333 //usage: "\n -exec CMD ARG + Run CMD with {} replaced by list of file names"
335 //usage: IF_FEATURE_FIND_DELETE(
336 //usage: "\n -delete Delete current file/directory. Turns on -depth option"
339 //usage:#define find_example_usage
340 //usage: "$ find / -name passwd\n"
341 //usage: "/etc/passwd\n"
345 #if ENABLE_FEATURE_FIND_REGEX
350 # define FNM_CASEFOLD 0
354 # define dbg(...) ((void)0)
356 # define dbg(...) bb_error_msg(__VA_ARGS__)
360 /* This is a NOEXEC applet. Be very careful! */
363 typedef int (*action_fp)(const char *fileName, const struct stat *statbuf, void *) FAST_FUNC;
367 #if ENABLE_FEATURE_FIND_NOT
372 #define ACTS(name, ...) typedef struct { action a; __VA_ARGS__ } action_##name;
374 static int FAST_FUNC func_##name(const char *fileName UNUSED_PARAM, \
375 const struct stat *statbuf UNUSED_PARAM, \
376 action_##name* ap UNUSED_PARAM)
379 ACTS(name, const char *pattern; bool iname;)
380 IF_FEATURE_FIND_PATH( ACTS(path, const char *pattern; bool ipath;))
381 IF_FEATURE_FIND_REGEX( ACTS(regex, regex_t compiled_pattern;))
382 IF_FEATURE_FIND_PRINT0( ACTS(print0))
383 IF_FEATURE_FIND_TYPE( ACTS(type, int type_mask;))
384 IF_FEATURE_FIND_PERM( ACTS(perm, char perm_char; mode_t perm_mask;))
385 IF_FEATURE_FIND_MTIME( ACTS(mtime, char mtime_char; unsigned mtime_days;))
386 IF_FEATURE_FIND_MMIN( ACTS(mmin, char mmin_char; unsigned mmin_mins;))
387 IF_FEATURE_FIND_NEWER( ACTS(newer, time_t newer_mtime;))
388 IF_FEATURE_FIND_INUM( ACTS(inum, ino_t inode_num;))
389 IF_FEATURE_FIND_USER( ACTS(user, uid_t uid;))
390 IF_FEATURE_FIND_SIZE( ACTS(size, char size_char; off_t size;))
391 IF_FEATURE_FIND_CONTEXT(ACTS(context, security_context_t context;))
392 IF_FEATURE_FIND_PAREN( ACTS(paren, action ***subexpr;))
393 IF_FEATURE_FIND_PRUNE( ACTS(prune))
394 IF_FEATURE_FIND_DELETE( ACTS(delete))
395 IF_FEATURE_FIND_EXEC( ACTS(exec,
396 char **exec_argv; /* -exec ARGS */
397 unsigned *subst_count;
398 int exec_argc; /* count of ARGS */
399 IF_FEATURE_FIND_EXEC_PLUS(
401 * filelist is NULL if "exec ;"
402 * non-NULL if "exec +"
409 IF_FEATURE_FIND_GROUP( ACTS(group, gid_t gid;))
410 IF_FEATURE_FIND_LINKS( ACTS(links, char links_char; int links_count;))
413 IF_FEATURE_FIND_XDEV(dev_t *xdev_dev;)
414 IF_FEATURE_FIND_XDEV(int xdev_count;)
415 #if ENABLE_FEATURE_FIND_MAXDEPTH
421 recurse_flags_t recurse_flags;
422 IF_FEATURE_FIND_EXEC_PLUS(unsigned max_argv_len;)
424 #define G (*(struct globals*)&bb_common_bufsiz1)
425 #define INIT_G() do { \
426 struct G_sizecheck { \
427 char G_sizecheck[sizeof(G) > COMMON_BUFSIZE ? -1 : 1]; \
429 /* we have to zero it out because of NOEXEC */ \
430 memset(&G, 0, sizeof(G)); \
431 IF_FEATURE_FIND_MAXDEPTH(G.minmaxdepth[1] = INT_MAX;) \
432 IF_FEATURE_FIND_EXEC_PLUS(G.max_argv_len = bb_arg_max() - 2048;) \
434 G.recurse_flags = ACTION_RECURSE; \
437 /* Return values of ACTFs ('action functions') are a bit mask:
438 * bit 1=1: prune (use SKIP constant for setting it)
439 * bit 0=1: matched successfully (TRUE)
442 static int exec_actions(action ***appp, const char *fileName, const struct stat *statbuf)
449 /* "action group" is a set of actions ANDed together.
450 * groups are ORed together.
451 * We simply evaluate each group until we find one in which all actions
454 /* -prune is special: if it is encountered, then we won't
455 * descend into current directory. It doesn't matter whether
456 * action group (in which -prune sits) will succeed or not:
457 * find * -prune -name 'f*' -o -name 'm*' -- prunes every dir
458 * find * -name 'f*' -o -prune -name 'm*' -- prunes all dirs
459 * not starting with 'f' */
461 /* We invert TRUE bit (bit 0). Now 1 there means 'failure'.
462 * and bitwise OR in "rc |= TRUE ^ ap->f()" will:
463 * (1) make SKIP (-prune) bit stick; and (2) detect 'failure'.
464 * On return, bit is restored. */
467 while ((app = appp[++cur_group]) != NULL) {
468 rc &= ~TRUE; /* 'success' so far, clear TRUE bit */
471 ap = app[++cur_action];
472 if (!ap) /* all actions in group were successful */
473 return rc ^ TRUE; /* restore TRUE bit */
474 rc |= TRUE ^ ap->f(fileName, statbuf, ap);
475 #if ENABLE_FEATURE_FIND_NOT
476 if (ap->invert) rc ^= TRUE;
478 dbg("grp %d action %d rc:0x%x", cur_group, cur_action, rc);
479 if (rc & TRUE) /* current group failed, try next */
483 dbg("returning:0x%x", rc ^ TRUE);
484 return rc ^ TRUE; /* restore TRUE bit */
488 static char *strcpy_upcase(char *dst, const char *src)
492 unsigned char ch = *src++;
493 if (ch >= 'a' && ch <= 'z')
505 const char *tmp = bb_basename(fileName);
506 if (tmp != fileName && *tmp == '\0') {
507 /* "foo/bar/". Oh no... go back to 'b' */
509 while (tmp != fileName && *--tmp != '/')
514 /* Was using FNM_PERIOD flag too,
515 * but somewhere between 4.1.20 and 4.4.0 GNU find stopped using it.
516 * find -name '*foo' should match .foo too:
519 return fnmatch(ap->pattern, tmp, (ap->iname ? FNM_CASEFOLD : 0)) == 0;
522 tmp = strcpy_upcase(alloca(strlen(tmp) + 1), tmp);
523 return fnmatch(ap->pattern, tmp, 0) == 0;
527 #if ENABLE_FEATURE_FIND_PATH
531 return fnmatch(ap->pattern, fileName, (ap->ipath ? FNM_CASEFOLD : 0)) == 0;
534 fileName = strcpy_upcase(alloca(strlen(fileName) + 1), fileName);
535 return fnmatch(ap->pattern, fileName, 0) == 0;
539 #if ENABLE_FEATURE_FIND_REGEX
543 if (regexec(&ap->compiled_pattern, fileName, 1, &match, 0 /*eflags*/))
544 return 0; /* no match */
546 return 0; /* match doesn't start at pos 0 */
547 if (fileName[match.rm_eo])
548 return 0; /* match doesn't end exactly at end of pathname */
552 #if ENABLE_FEATURE_FIND_TYPE
555 return ((statbuf->st_mode & S_IFMT) == ap->type_mask);
558 #if ENABLE_FEATURE_FIND_PERM
561 /* -perm [+/]mode: at least one of perm_mask bits are set */
562 if (ap->perm_char == '+' || ap->perm_char == '/')
563 return (statbuf->st_mode & ap->perm_mask) != 0;
564 /* -perm -mode: all of perm_mask are set */
565 if (ap->perm_char == '-')
566 return (statbuf->st_mode & ap->perm_mask) == ap->perm_mask;
567 /* -perm mode: file mode must match perm_mask */
568 return (statbuf->st_mode & 07777) == ap->perm_mask;
571 #if ENABLE_FEATURE_FIND_MTIME
574 time_t file_age = time(NULL) - statbuf->st_mtime;
575 time_t mtime_secs = ap->mtime_days * 24*60*60;
576 if (ap->mtime_char == '+')
577 return file_age >= mtime_secs + 24*60*60;
578 if (ap->mtime_char == '-')
579 return file_age < mtime_secs;
580 /* just numeric mtime */
581 return file_age >= mtime_secs && file_age < (mtime_secs + 24*60*60);
584 #if ENABLE_FEATURE_FIND_MMIN
587 time_t file_age = time(NULL) - statbuf->st_mtime;
588 time_t mmin_secs = ap->mmin_mins * 60;
589 if (ap->mmin_char == '+')
590 return file_age >= mmin_secs + 60;
591 if (ap->mmin_char == '-')
592 return file_age < mmin_secs;
593 /* just numeric mmin */
594 return file_age >= mmin_secs && file_age < (mmin_secs + 60);
597 #if ENABLE_FEATURE_FIND_NEWER
600 return (ap->newer_mtime < statbuf->st_mtime);
603 #if ENABLE_FEATURE_FIND_INUM
606 return (statbuf->st_ino == ap->inode_num);
609 #if ENABLE_FEATURE_FIND_EXEC
610 static int do_exec(action_exec *ap, const char *fileName)
613 # if ENABLE_FEATURE_FIND_EXEC_PLUS
614 int size = ap->exec_argc + ap->filelist_idx + 1;
616 int size = ap->exec_argc + 1;
618 # if ENABLE_USE_PORTABLE_CODE
619 char **argv = alloca(sizeof(char*) * size);
620 # else /* gcc 4.3.1 generates smaller code: */
625 for (i = 0; i < ap->exec_argc; i++) {
626 const char *arg = ap->exec_argv[i];
628 # if ENABLE_FEATURE_FIND_EXEC_PLUS
630 /* Handling "-exec +"
631 * Only one exec_argv[i] has substitution in it.
632 * Expand that one exec_argv[i] into file list.
634 if (ap->subst_count[i] == 0) {
635 *pp++ = xstrdup(arg);
638 while (ap->filelist[j]) {
639 /* 2nd arg here should be ap->subst_count[i], but it is always 1: */
640 *pp++ = xmalloc_substitute_string(arg, 1, "{}", ap->filelist[j]);
641 free(ap->filelist[j]);
648 /* Handling "-exec ;" */
649 *pp++ = xmalloc_substitute_string(arg, ap->subst_count[i], "{}", fileName);
652 *pp = NULL; /* terminate the list */
654 # if ENABLE_FEATURE_FIND_EXEC_PLUS
656 ap->filelist[0] = NULL;
657 ap->filelist_idx = 0;
662 rc = spawn_and_wait(argv);
664 bb_simple_perror_msg(argv[0]);
669 return rc == 0; /* return 1 if exitcode 0 */
673 # if ENABLE_FEATURE_FIND_EXEC_PLUS
677 ap->filelist = xrealloc_vector(ap->filelist, 8, ap->filelist_idx);
678 ap->filelist[ap->filelist_idx++] = xstrdup(fileName);
679 ap->file_len += strlen(fileName) + sizeof(char*) + 1;
680 /* If we have lots of files already, exec the command */
682 if (ap->file_len >= G.max_argv_len)
683 rc = do_exec(ap, NULL);
687 return do_exec(ap, fileName);
689 # if ENABLE_FEATURE_FIND_EXEC_PLUS
690 static int flush_exec_plus(void)
694 action ***appp = G.actions;
695 while ((app = *appp++) != NULL) {
696 while ((ap = *app++) != NULL) {
697 if (ap->f == (action_fp)func_exec) {
698 action_exec *ae = (void*)ap;
699 if (ae->filelist_idx != 0) {
700 int rc = do_exec(ae, NULL);
701 # if ENABLE_FEATURE_FIND_NOT
702 if (ap->invert) rc = !rc;
714 #if ENABLE_FEATURE_FIND_USER
717 return (statbuf->st_uid == ap->uid);
720 #if ENABLE_FEATURE_FIND_GROUP
723 return (statbuf->st_gid == ap->gid);
726 #if ENABLE_FEATURE_FIND_PRINT0
729 printf("%s%c", fileName, '\0');
738 #if ENABLE_FEATURE_FIND_PAREN
741 return exec_actions(ap->subexpr, fileName, statbuf);
744 #if ENABLE_FEATURE_FIND_SIZE
747 if (ap->size_char == '+')
748 return statbuf->st_size > ap->size;
749 if (ap->size_char == '-')
750 return statbuf->st_size < ap->size;
751 return statbuf->st_size == ap->size;
754 #if ENABLE_FEATURE_FIND_PRUNE
756 * -prune: if -depth is not given, return true and do not descend
757 * current dir; if -depth is given, return false with no effect.
759 * find dir -name 'asm-*' -prune -o -name '*.[chS]' -print
766 #if ENABLE_FEATURE_FIND_DELETE
770 if (S_ISDIR(statbuf->st_mode)) {
771 /* "find . -delete" skips rmdir(".") */
773 if (NOT_LONE_CHAR(fileName, '.'))
774 rc = rmdir(fileName);
776 rc = unlink(fileName);
779 bb_simple_perror_msg(fileName);
783 #if ENABLE_FEATURE_FIND_CONTEXT
786 security_context_t con;
789 if (G.recurse_flags & ACTION_FOLLOWLINKS) {
790 rc = getfilecon(fileName, &con);
792 rc = lgetfilecon(fileName, &con);
796 rc = strcmp(ap->context, con);
801 #if ENABLE_FEATURE_FIND_LINKS
804 switch(ap->links_char) {
805 case '-' : return (statbuf->st_nlink < ap->links_count);
806 case '+' : return (statbuf->st_nlink > ap->links_count);
807 default: return (statbuf->st_nlink == ap->links_count);
812 static int FAST_FUNC fileAction(const char *fileName,
813 struct stat *statbuf,
814 void *userData UNUSED_PARAM,
815 int depth IF_NOT_FEATURE_FIND_MAXDEPTH(UNUSED_PARAM))
820 #if ENABLE_FEATURE_FIND_XDEV
821 if (S_ISDIR(statbuf->st_mode) && G.xdev_count) {
823 for (i = 0; i < G.xdev_count; i++) {
824 if (G.xdev_dev[i] == statbuf->st_dev)
827 //bb_error_msg("'%s': not same fs", fileName);
833 #if ENABLE_FEATURE_FIND_MAXDEPTH
834 if (depth < G.minmaxdepth[0]) {
836 return TRUE; /* skip this, continue recursing */
837 return SKIP; /* stop recursing */
839 if (depth > G.minmaxdepth[1])
840 return SKIP; /* stop recursing */
843 r = exec_actions(G.actions, fileName, statbuf);
844 /* Had no explicit -print[0] or -exec? then print */
845 if ((r & TRUE) && G.need_print)
848 #if ENABLE_FEATURE_FIND_MAXDEPTH
849 if (S_ISDIR(statbuf->st_mode)) {
850 if (depth == G.minmaxdepth[1])
854 /* -xdev stops on mountpoints, but AFTER mountpoit itself
855 * is processed as usual */
860 /* Cannot return 0: our caller, recursive_action(),
861 * will perror() and skip dirs (if called on dir) */
862 return (r & SKIP) ? SKIP : TRUE;
866 #if ENABLE_FEATURE_FIND_TYPE
867 static int find_type(const char *type)
873 else if (*type == 'c')
875 else if (*type == 'd')
877 else if (*type == 'p')
879 else if (*type == 'f')
881 else if (*type == 'l')
883 else if (*type == 's')
886 if (mask == 0 || type[1] != '\0')
887 bb_error_msg_and_die(bb_msg_invalid_arg, type, "-type");
893 #if ENABLE_FEATURE_FIND_PERM \
894 || ENABLE_FEATURE_FIND_MTIME || ENABLE_FEATURE_FIND_MMIN \
895 || ENABLE_FEATURE_FIND_SIZE || ENABLE_FEATURE_FIND_LINKS
896 static const char* plus_minus_num(const char* str)
898 if (*str == '-' || *str == '+')
904 /* Say no to GCCism */
905 #define USE_NESTED_FUNCTION 0
907 #if !USE_NESTED_FUNCTION
912 IF_FEATURE_FIND_NOT( bool invert_flag; )
914 static action* alloc_action(struct pp_locals *ppl, int sizeof_struct, action_fp f)
916 action *ap = xzalloc(sizeof_struct);
918 action ***group = &ppl->appp[ppl->cur_group];
919 *group = app = xrealloc(*group, (ppl->cur_action+2) * sizeof(ppl->appp[0][0]));
920 app[ppl->cur_action++] = ap;
921 app[ppl->cur_action] = NULL;
923 IF_FEATURE_FIND_NOT( ap->invert = ppl->invert_flag; )
924 IF_FEATURE_FIND_NOT( ppl->invert_flag = 0; )
929 static action*** parse_params(char **argv)
933 IF_FEATURE_FIND_XDEV( OPT_XDEV ,)
934 IF_FEATURE_FIND_DEPTH( OPT_DEPTH ,)
937 IF_FEATURE_FIND_NOT( PARM_char_not ,)
941 IF_FEATURE_FIND_NOT( PARM_not ,)
944 IF_FEATURE_FIND_PRINT0( PARM_print0 ,)
945 IF_FEATURE_FIND_PRUNE( PARM_prune ,)
946 IF_FEATURE_FIND_DELETE( PARM_delete ,)
947 IF_FEATURE_FIND_EXEC( PARM_exec ,)
948 IF_FEATURE_FIND_PAREN( PARM_char_brace,)
949 /* All options/actions starting from here require argument */
952 IF_FEATURE_FIND_PATH( PARM_path ,)
954 /* -wholename is a synonym for -path */
955 /* We support it because Linux kernel's "make tags" uses it */
956 IF_FEATURE_FIND_PATH( PARM_wholename ,)
958 IF_FEATURE_FIND_PATH( PARM_ipath ,)
959 IF_FEATURE_FIND_REGEX( PARM_regex ,)
960 IF_FEATURE_FIND_TYPE( PARM_type ,)
961 IF_FEATURE_FIND_PERM( PARM_perm ,)
962 IF_FEATURE_FIND_MTIME( PARM_mtime ,)
963 IF_FEATURE_FIND_MMIN( PARM_mmin ,)
964 IF_FEATURE_FIND_NEWER( PARM_newer ,)
965 IF_FEATURE_FIND_INUM( PARM_inum ,)
966 IF_FEATURE_FIND_USER( PARM_user ,)
967 IF_FEATURE_FIND_GROUP( PARM_group ,)
968 IF_FEATURE_FIND_SIZE( PARM_size ,)
969 IF_FEATURE_FIND_CONTEXT(PARM_context ,)
970 IF_FEATURE_FIND_LINKS( PARM_links ,)
971 IF_FEATURE_FIND_MAXDEPTH(OPT_MINDEPTH,OPT_MAXDEPTH,)
974 static const char params[] ALIGN1 =
976 IF_FEATURE_FIND_XDEV( "-xdev\0" )
977 IF_FEATURE_FIND_DEPTH( "-depth\0" )
980 IF_FEATURE_FIND_NOT( "!\0" )
984 IF_FEATURE_FIND_NOT( "-not\0" )
987 IF_FEATURE_FIND_PRINT0( "-print0\0" )
988 IF_FEATURE_FIND_PRUNE( "-prune\0" )
989 IF_FEATURE_FIND_DELETE( "-delete\0" )
990 IF_FEATURE_FIND_EXEC( "-exec\0" )
991 IF_FEATURE_FIND_PAREN( "(\0" )
992 /* All options/actions starting from here require argument */
995 IF_FEATURE_FIND_PATH( "-path\0" )
997 IF_FEATURE_FIND_PATH( "-wholename\0")
999 IF_FEATURE_FIND_PATH( "-ipath\0" )
1000 IF_FEATURE_FIND_REGEX( "-regex\0" )
1001 IF_FEATURE_FIND_TYPE( "-type\0" )
1002 IF_FEATURE_FIND_PERM( "-perm\0" )
1003 IF_FEATURE_FIND_MTIME( "-mtime\0" )
1004 IF_FEATURE_FIND_MMIN( "-mmin\0" )
1005 IF_FEATURE_FIND_NEWER( "-newer\0" )
1006 IF_FEATURE_FIND_INUM( "-inum\0" )
1007 IF_FEATURE_FIND_USER( "-user\0" )
1008 IF_FEATURE_FIND_GROUP( "-group\0" )
1009 IF_FEATURE_FIND_SIZE( "-size\0" )
1010 IF_FEATURE_FIND_CONTEXT("-context\0")
1011 IF_FEATURE_FIND_LINKS( "-links\0" )
1012 IF_FEATURE_FIND_MAXDEPTH("-mindepth\0""-maxdepth\0")
1015 #if !USE_NESTED_FUNCTION
1016 struct pp_locals ppl;
1017 #define appp (ppl.appp )
1018 #define cur_group (ppl.cur_group )
1019 #define cur_action (ppl.cur_action )
1020 #define invert_flag (ppl.invert_flag)
1021 #define ALLOC_ACTION(name) (action_##name*)alloc_action(&ppl, sizeof(action_##name), (action_fp) func_##name)
1025 unsigned cur_action;
1026 IF_FEATURE_FIND_NOT( bool invert_flag; )
1028 /* This is the only place in busybox where we use nested function.
1029 * So far more standard alternatives were bigger. */
1030 /* Auto decl suppresses "func without a prototype" warning: */
1031 auto action* alloc_action(int sizeof_struct, action_fp f);
1032 action* alloc_action(int sizeof_struct, action_fp f)
1035 appp[cur_group] = xrealloc(appp[cur_group], (cur_action+2) * sizeof(appp[0][0]));
1036 appp[cur_group][cur_action++] = ap = xzalloc(sizeof_struct);
1037 appp[cur_group][cur_action] = NULL;
1039 IF_FEATURE_FIND_NOT( ap->invert = invert_flag; )
1040 IF_FEATURE_FIND_NOT( invert_flag = 0; )
1043 #define ALLOC_ACTION(name) (action_##name*)alloc_action(sizeof(action_##name), (action_fp) func_##name)
1048 IF_FEATURE_FIND_NOT( invert_flag = 0; )
1049 appp = xzalloc(2 * sizeof(appp[0])); /* appp[0],[1] == NULL */
1052 const char *arg = argv[0];
1053 int parm = index_in_strings(params, arg);
1054 const char *arg1 = argv[1];
1056 dbg("arg:'%s' arg1:'%s' parm:%d PARM_type:%d", arg, arg1, parm, PARM_type);
1058 if (parm >= PARM_name) {
1059 /* All options/actions starting from -name require argument */
1061 bb_error_msg_and_die(bb_msg_requires_arg, arg);
1065 /* We can use big switch() here, but on i386
1066 * it doesn't give smaller code. Other arches? */
1068 /* Options always return true. They always take effect
1069 * rather than being processed only when their place in the
1070 * expression is reached.
1073 if (parm == OPT_FOLLOW) {
1074 dbg("follow enabled: %d", __LINE__);
1075 G.recurse_flags |= ACTION_FOLLOWLINKS | ACTION_DANGLING_OK;
1077 #if ENABLE_FEATURE_FIND_XDEV
1078 else if (parm == OPT_XDEV) {
1079 dbg("%d", __LINE__);
1083 #if ENABLE_FEATURE_FIND_MAXDEPTH
1084 else if (parm == OPT_MINDEPTH || parm == OPT_MINDEPTH + 1) {
1085 dbg("%d", __LINE__);
1086 G.minmaxdepth[parm - OPT_MINDEPTH] = xatoi_positive(arg1);
1089 #if ENABLE_FEATURE_FIND_DEPTH
1090 else if (parm == OPT_DEPTH) {
1091 dbg("%d", __LINE__);
1092 G.recurse_flags |= ACTION_DEPTHFIRST;
1095 /* Actions are grouped by operators
1096 * ( expr ) Force precedence
1097 * ! expr True if expr is false
1098 * -not expr Same as ! expr
1099 * expr1 [-a[nd]] expr2 And; expr2 is not evaluated if expr1 is false
1100 * expr1 -o[r] expr2 Or; expr2 is not evaluated if expr1 is true
1101 * expr1 , expr2 List; both expr1 and expr2 are always evaluated
1102 * We implement: (), -a, -o
1105 else if (parm == PARM_a IF_DESKTOP(|| parm == PARM_and)) {
1106 dbg("%d", __LINE__);
1107 /* no further special handling required */
1109 else if (parm == PARM_o IF_DESKTOP(|| parm == PARM_or)) {
1110 dbg("%d", __LINE__);
1111 /* start new OR group */
1113 appp = xrealloc(appp, (cur_group+2) * sizeof(appp[0]));
1114 /*appp[cur_group] = NULL; - already NULL */
1115 appp[cur_group+1] = NULL;
1118 #if ENABLE_FEATURE_FIND_NOT
1119 else if (parm == PARM_char_not IF_DESKTOP(|| parm == PARM_not)) {
1120 /* also handles "find ! ! -name 'foo*'" */
1122 dbg("invert_flag:%d", invert_flag);
1126 else if (parm == PARM_print) {
1127 dbg("%d", __LINE__);
1129 (void) ALLOC_ACTION(print);
1131 #if ENABLE_FEATURE_FIND_PRINT0
1132 else if (parm == PARM_print0) {
1133 dbg("%d", __LINE__);
1135 (void) ALLOC_ACTION(print0);
1138 #if ENABLE_FEATURE_FIND_PRUNE
1139 else if (parm == PARM_prune) {
1140 dbg("%d", __LINE__);
1141 (void) ALLOC_ACTION(prune);
1144 #if ENABLE_FEATURE_FIND_DELETE
1145 else if (parm == PARM_delete) {
1146 dbg("%d", __LINE__);
1148 G.recurse_flags |= ACTION_DEPTHFIRST;
1149 (void) ALLOC_ACTION(delete);
1152 #if ENABLE_FEATURE_FIND_EXEC
1153 else if (parm == PARM_exec) {
1156 IF_FEATURE_FIND_EXEC_PLUS(int all_subst = 0;)
1157 dbg("%d", __LINE__);
1159 ap = ALLOC_ACTION(exec);
1160 ap->exec_argv = ++argv; /* first arg after -exec */
1161 /*ap->exec_argc = 0; - ALLOC_ACTION did it */
1163 if (!*argv) /* did not see ';' or '+' until end */
1164 bb_error_msg_and_die(bb_msg_requires_arg, "-exec");
1165 // find -exec echo Foo ">{}<" ";"
1166 // executes "echo Foo >FILENAME<",
1167 // find -exec echo Foo ">{}<" "+"
1168 // executes "echo Foo FILENAME1 FILENAME2 FILENAME3...".
1169 if ((argv[0][0] == ';' || argv[0][0] == '+')
1170 && argv[0][1] == '\0'
1172 # if ENABLE_FEATURE_FIND_EXEC_PLUS
1173 if (argv[0][0] == '+')
1174 ap->filelist = xzalloc(sizeof(ap->filelist[0]));
1181 if (ap->exec_argc == 0)
1182 bb_error_msg_and_die(bb_msg_requires_arg, arg);
1183 ap->subst_count = xmalloc(ap->exec_argc * sizeof(int));
1186 ap->subst_count[i] = count_strstr(ap->exec_argv[i], "{}");
1187 IF_FEATURE_FIND_EXEC_PLUS(all_subst += ap->subst_count[i];)
1189 # if ENABLE_FEATURE_FIND_EXEC_PLUS
1191 * coreutils expects {} to appear only once in "-exec +"
1193 if (all_subst != 1 && ap->filelist)
1194 bb_error_msg_and_die("only one '{}' allowed for -exec +");
1198 #if ENABLE_FEATURE_FIND_PAREN
1199 else if (parm == PARM_char_brace) {
1202 unsigned nested = 1;
1204 dbg("%d", __LINE__);
1208 bb_error_msg_and_die("unpaired '('");
1209 if (LONE_CHAR(*endarg, '('))
1211 else if (LONE_CHAR(*endarg, ')') && !--nested) {
1216 ap = ALLOC_ACTION(paren);
1217 ap->subexpr = parse_params(argv + 1);
1218 *endarg = (char*) ")"; /* restore NULLed parameter */
1222 else if (parm == PARM_name || parm == PARM_iname) {
1224 dbg("%d", __LINE__);
1225 ap = ALLOC_ACTION(name);
1227 ap->iname = (parm == PARM_iname);
1229 #if ENABLE_FEATURE_FIND_PATH
1230 else if (parm == PARM_path IF_DESKTOP(|| parm == PARM_wholename) || parm == PARM_ipath) {
1232 dbg("%d", __LINE__);
1233 ap = ALLOC_ACTION(path);
1235 ap->ipath = (parm == PARM_ipath);
1238 #if ENABLE_FEATURE_FIND_REGEX
1239 else if (parm == PARM_regex) {
1241 dbg("%d", __LINE__);
1242 ap = ALLOC_ACTION(regex);
1243 xregcomp(&ap->compiled_pattern, arg1, 0 /*cflags*/);
1246 #if ENABLE_FEATURE_FIND_TYPE
1247 else if (parm == PARM_type) {
1249 ap = ALLOC_ACTION(type);
1250 ap->type_mask = find_type(arg1);
1251 dbg("created:type mask:%x", ap->type_mask);
1254 #if ENABLE_FEATURE_FIND_PERM
1255 /* -perm BITS File's mode bits are exactly BITS (octal or symbolic).
1256 * Symbolic modes use mode 0 as a point of departure.
1257 * -perm -BITS All of the BITS are set in file's mode.
1258 * -perm [+/]BITS At least one of the BITS is set in file's mode.
1260 else if (parm == PARM_perm) {
1262 dbg("%d", __LINE__);
1263 ap = ALLOC_ACTION(perm);
1264 ap->perm_char = arg1[0];
1265 arg1 = (arg1[0] == '/' ? arg1+1 : plus_minus_num(arg1));
1266 /*ap->perm_mask = 0; - ALLOC_ACTION did it */
1267 ap->perm_mask = bb_parse_mode(arg1, ap->perm_mask);
1268 if (ap->perm_mask == (mode_t)-1)
1269 bb_error_msg_and_die("invalid mode '%s'", arg1);
1272 #if ENABLE_FEATURE_FIND_MTIME
1273 else if (parm == PARM_mtime) {
1275 dbg("%d", __LINE__);
1276 ap = ALLOC_ACTION(mtime);
1277 ap->mtime_char = arg1[0];
1278 ap->mtime_days = xatoul(plus_minus_num(arg1));
1281 #if ENABLE_FEATURE_FIND_MMIN
1282 else if (parm == PARM_mmin) {
1284 dbg("%d", __LINE__);
1285 ap = ALLOC_ACTION(mmin);
1286 ap->mmin_char = arg1[0];
1287 ap->mmin_mins = xatoul(plus_minus_num(arg1));
1290 #if ENABLE_FEATURE_FIND_NEWER
1291 else if (parm == PARM_newer) {
1292 struct stat stat_newer;
1294 dbg("%d", __LINE__);
1295 ap = ALLOC_ACTION(newer);
1296 xstat(arg1, &stat_newer);
1297 ap->newer_mtime = stat_newer.st_mtime;
1300 #if ENABLE_FEATURE_FIND_INUM
1301 else if (parm == PARM_inum) {
1303 dbg("%d", __LINE__);
1304 ap = ALLOC_ACTION(inum);
1305 ap->inode_num = xatoul(arg1);
1308 #if ENABLE_FEATURE_FIND_USER
1309 else if (parm == PARM_user) {
1311 dbg("%d", __LINE__);
1312 ap = ALLOC_ACTION(user);
1313 ap->uid = bb_strtou(arg1, NULL, 10);
1315 ap->uid = xuname2uid(arg1);
1318 #if ENABLE_FEATURE_FIND_GROUP
1319 else if (parm == PARM_group) {
1321 dbg("%d", __LINE__);
1322 ap = ALLOC_ACTION(group);
1323 ap->gid = bb_strtou(arg1, NULL, 10);
1325 ap->gid = xgroup2gid(arg1);
1328 #if ENABLE_FEATURE_FIND_SIZE
1329 else if (parm == PARM_size) {
1330 /* -size n[bckw]: file uses n units of space
1331 * b (default): units are 512-byte blocks
1337 #define XATOU_SFX xatoull_sfx
1339 #define XATOU_SFX xatoul_sfx
1341 static const struct suffix_mult find_suffixes[] = {
1350 dbg("%d", __LINE__);
1351 ap = ALLOC_ACTION(size);
1352 ap->size_char = arg1[0];
1353 ap->size = XATOU_SFX(plus_minus_num(arg1), find_suffixes);
1356 #if ENABLE_FEATURE_FIND_CONTEXT
1357 else if (parm == PARM_context) {
1359 dbg("%d", __LINE__);
1360 ap = ALLOC_ACTION(context);
1361 /*ap->context = NULL; - ALLOC_ACTION did it */
1362 /* SELinux headers erroneously declare non-const parameter */
1363 if (selinux_raw_to_trans_context((char*)arg1, &ap->context))
1364 bb_simple_perror_msg(arg1);
1367 #if ENABLE_FEATURE_FIND_LINKS
1368 else if (parm == PARM_links) {
1370 dbg("%d", __LINE__);
1371 ap = ALLOC_ACTION(links);
1372 ap->links_char = arg1[0];
1373 ap->links_count = xatoul(plus_minus_num(arg1));
1377 bb_error_msg("unrecognized: %s", arg);
1382 dbg("exiting %s", __func__);
1390 int find_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
1391 int find_main(int argc UNUSED_PARAM, char **argv)
1393 int i, firstopt, status = EXIT_SUCCESS;
1394 char **past_HLP, *saved;
1398 /* "find -type f" + getopt("+HLP") => disaster.
1399 * Need to avoid getopt running into a non-HLP option.
1400 * Do this by temporarily storing NULL there:
1404 saved = *++past_HLP;
1407 if (saved[0] != '-')
1410 break; /* it is "-" */
1411 if ((saved+1)[strspn(saved+1, "HLP")] != '\0')
1415 /* "+": stop on first non-option */
1416 i = getopt32(argv, "+HLP");
1418 G.recurse_flags |= ACTION_FOLLOWLINKS_L0 | ACTION_DANGLING_OK;
1420 G.recurse_flags |= ACTION_FOLLOWLINKS | ACTION_DANGLING_OK;
1421 /* -P is default and is ignored */
1422 argv = past_HLP; /* same result as "argv += optind;" */
1425 for (firstopt = 0; argv[firstopt]; firstopt++) {
1426 if (argv[firstopt][0] == '-')
1428 if (ENABLE_FEATURE_FIND_NOT && LONE_CHAR(argv[firstopt], '!'))
1430 if (ENABLE_FEATURE_FIND_PAREN && LONE_CHAR(argv[firstopt], '('))
1433 if (firstopt == 0) {
1434 *--argv = (char*)".";
1438 G.actions = parse_params(&argv[firstopt]);
1439 argv[firstopt] = NULL;
1441 #if ENABLE_FEATURE_FIND_XDEV
1445 G.xdev_count = firstopt;
1446 G.xdev_dev = xzalloc(G.xdev_count * sizeof(G.xdev_dev[0]));
1447 for (i = 0; argv[i]; i++) {
1448 /* not xstat(): shouldn't bomb out on
1449 * "find not_exist exist -xdev" */
1450 if (stat(argv[i], &stbuf) == 0)
1451 G.xdev_dev[i] = stbuf.st_dev;
1452 /* else G.xdev_dev[i] stays 0 and
1453 * won't match any real device dev_t
1459 for (i = 0; argv[i]; i++) {
1460 if (!recursive_action(argv[i],
1461 G.recurse_flags,/* flags */
1462 fileAction, /* file action */
1463 fileAction, /* dir action */
1464 NULL, /* user data */
1467 status |= EXIT_FAILURE;
1471 IF_FEATURE_FIND_EXEC_PLUS(status |= flush_exec_plus();)