1 /* find.c - Search directories for matching files.
3 * Copyright 2014 Rob Landley <rob@landley.net>
5 * See http://pubs.opengroup.org/onlinepubs/9699919799/utilities/find.c
7 * Our "unspecified" behavior for no paths is to use "."
8 * Parentheses can only stack 4096 deep
9 * Not treating two {} as an error, but only using last
11 USE_FIND(NEWTOY(find, "?^HL[-HL]", TOYFLAG_USR|TOYFLAG_BIN))
17 usage: find [-HL] [DIR...] [<options>]
19 Search directories for matching files.
20 Default: search "." match all -print all matches.
22 -H Follow command line symlinks -L Follow all symlinks
25 -name PATTERN filename with wildcards -iname case insensitive -name
26 -path PATTERN path name with wildcards -ipath case insensitive -path
27 -user UNAME belongs to user UNAME -nouser user not in /etc/passwd
28 -group GROUP belongs to group GROUP -nogroup group not in /etc/group
29 -perm [-]MODE permissons (-=at least) -prune ignore contents of dir
30 -size N[c] 512 byte blocks (c=bytes) -xdev stay in this filesystem
31 -links N hardlink count -atime N accessed N days ago
32 -ctime N created N days ago -mtime N modified N days ago
33 -newer FILE newer mtime than FILE -mindepth # at least # dirs down
34 -depth ignore contents of dir -maxdepth # at most # dirs down
35 -inum N inode number N
36 -type [bcdflps] (block, char, dir, file, symlink, pipe, socket)
38 Numbers N may be prefixed by a - (less than) or + (greater than):
41 !, -a, -o, ( ) not, and, or, group expressions
44 -print Print match with newline -print0 Print match with null
45 -exec Run command with path -execdir Run command in file's dir
46 -ok Ask before exec -okdir Ask before execdir
48 Commands substitute "{}" with matched file. End with ";" to run each file,
49 or "+" (next argument after "{}") to collect and run with multiple files.
57 struct double_list *argdata;
58 int topdir, xdev, depth, envsize;
62 // None of this can go in TT because you can have more than one -exec
66 int dir, plus, arglen, argsize, curly, namecount, namesize;
68 struct double_list *names;
71 // Perform pending -exec (if any)
72 static int flush_exec(struct dirtree *new, struct exec_range *aa)
74 struct double_list **dl;
78 if (!aa->namecount) return 0;
80 if (aa->dir && new->parent) dl = (void *)&new->parent->extra;
84 // switch to directory for -execdir, or back to top if we have an -execdir
85 // _and_ a normal -exec, or are at top of tree in -execdir
86 if (aa->dir && new->parent) rc = fchdir(new->parent->data);
87 else if (TT.topdir != -1) rc = fchdir(TT.topdir);
89 perror_msg("%s", new->name);
94 // execdir: accumulated execs in this directory's children.
95 newargs = xmalloc(sizeof(char *)*(aa->arglen+aa->namecount+1));
97 memcpy(newargs, aa->argstart, sizeof(char *)*aa->arglen);
98 newargs[aa->arglen] = 0;
100 struct double_list *dl2 = *dl;
101 int pos = aa->curly, rest = aa->arglen - aa->curly;
103 // Collate argument list
104 memcpy(newargs, aa->argstart, sizeof(char *)*pos);
105 for (dl2 = *dl; dl2; dl2 = dl2->next) newargs[pos++] = dl2->data;
106 rest = aa->arglen - aa->curly - 1;
107 memcpy(newargs+pos, aa->argstart+aa->curly+1, sizeof(char *)*rest);
108 newargs[pos+rest] = 0;
113 llist_traverse(*dl, llist_free_double);
120 // Return numeric value with explicit sign
121 static int compare_numsign(long val, long units, char *str)
126 if (*str == '+' || *str == '-') sign = *(str++);
127 else if (!isdigit(*str)) error_exit("%s not [+-]N", str);
129 if (units && isdigit(str[strlen(str)-1])) myval *= units;
131 if (sign == '+') return val > myval;
132 if (sign == '-') return val < myval;
136 static void do_print(struct dirtree *new, char c)
138 char *s=dirtree_path(new, 0);
140 xprintf("%s%c", s, c);
144 char *strlower(char *s)
148 if (!CFG_TOYBOX_I18N) {
149 try = new = xstrdup(s);
150 for (; *s; s++) *(new++) = tolower(*s);
152 // I can't guarantee the string _won't_ expand during reencoding, so...?
153 try = new = xmalloc(strlen(s)*2+1);
157 int len = mbrtowc(&c, s, MB_CUR_MAX, 0);
159 if (len < 1) *(new++) = *(s++);
162 // squash title case too
165 // if we had a valid utf8 sequence, convert it to lower case, and can't
166 // encode back to utf8, something is wrong with your libc. But just
167 // in case somebody finds an exploit...
168 len = wcrtomb(new, c, 0);
169 if (len < 1) error_exit("bad utf8 %x", (int)c);
179 // Call this with 0 for first pass argument parsing and syntax checking (which
180 // populates argdata). Later commands traverse argdata (in order) when they
181 // need "do once" results.
182 static int do_find(struct dirtree *new)
184 int pcount = 0, print = 0, not = 0, active = !!new, test = active, recurse;
185 struct double_list *argdata = TT.argdata;
188 recurse = DIRTREE_COMEAGAIN|(DIRTREE_SYMFOLLOW*!!(toys.optflags&FLAG_L));
190 // skip . and .. below topdir, handle -xdev and -depth
193 if (!dirtree_notdotdot(new)) return 0;
194 if (TT.xdev && new->st.st_dev != new->parent->st.st_dev) recurse = 0;
196 if (S_ISDIR(new->st.st_mode)) {
200 if (TT.depth) return recurse;
201 for (n = new->parent; n; n = n->parent) {
202 if (n->st.st_ino==new->st.st_ino && n->st.st_dev==new->st.st_dev) {
203 error_msg("'%s': loop detected", s = dirtree_path(new, 0));
210 struct double_list *dl;
213 for (dl = TT.argdata; dl; dl = dl->next)
214 if (dl->prev == (void *)1 || !new->parent)
215 toys.exitval |= flush_exec(new, (void *)dl);
222 // pcount: parentheses stack depth (using toybuf bytes, 4096 max depth)
223 // test: result of most recent test
224 // active: if 0 don't perform tests
225 // not: a pending ! applies to this test (only set if performing tests)
226 // print: saw one of print/ok/exec, no need for default -print
228 if (TT.filter) for (ss = TT.filter; *ss; ss++) {
229 int check = active && test;
233 // handle ! ( ) using toybuf as a stack
235 if (s[1]) goto error;
238 // Don't invert if we're not making a decision
239 if (check) not = !not;
241 // Save old "not" and "active" on toybuf stack.
242 // Deactivate this parenthetical if !test
243 // Note: test value should never change while !active
244 } else if (*s == '(') {
245 if (pcount == sizeof(toybuf)) goto error;
246 toybuf[pcount++] = not+(active<<1);
247 if (!check) active = 0;
250 // Pop status, apply deferred not to test
251 } else if (*s == ')') {
252 if (--pcount < 0) goto error;
253 // Pop active state, apply deferred not (which was only set if checking)
254 active = (toybuf[pcount]>>1)&1;
255 if (active && (toybuf[pcount]&1)) test = !test;
262 if (!strcmp(s, "xdev")) TT.xdev = 1;
263 else if (!strcmp(s, "depth")) TT.depth = 1;
264 else if (!strcmp(s, "o") || !strcmp(s, "or")) {
268 else active = 0; // decision has been made until next ")"
270 } else if (!strcmp(s, "not")) {
271 if (check) not = !not;
273 // Mostly ignore NOP argument
274 } else if (!strcmp(s, "a") || !strcmp(s, "and")) {
277 } else if (!strcmp(s, "print") || !strcmp("print0", s)) {
279 if (check) do_print(new, s[5] ? 0 : '\n');
281 } else if (!strcmp(s, "nouser")) {
282 if (check) if (getpwuid(new->st.st_uid)) test = 0;
283 } else if (!strcmp(s, "nogroup")) {
284 if (check) if (getgrgid(new->st.st_gid)) test = 0;
285 } else if (!strcmp(s, "prune")) {
286 if (check && S_ISDIR(new->st.st_dev) && !TT.depth) recurse = 0;
288 // Remaining filters take an argument
290 if (!strcmp(s, "name") || !strcmp(s, "iname")
291 || !strcmp(s, "path") || !strcmp(s, "ipath"))
294 char *arg = ss[1], *path = 0, *name = new->name;
296 // Handle path expansion and case flattening
297 if (new && s[i] == 'p') name = path = dirtree_path(new, 0);
300 name = strlower(new ? name : arg);
302 dlist_add(&TT.argdata, name);
304 } else arg = ((struct double_list *)llist_pop(&argdata))->data;
309 test = !fnmatch(arg, name, FNM_PATHNAME*(s[i] == 'p'));
313 } else if (!strcmp(s, "perm")) {
316 mode_t m1 = string_to_mode(m+(*m == '-'), 0),
317 m2 = new->st.st_dev & 07777;
319 if (*m != '-') m2 &= m1;
322 } else if (!strcmp(s, "type")) {
324 int types[] = {S_IFBLK, S_IFCHR, S_IFDIR, S_IFLNK, S_IFIFO,
325 S_IFREG, S_IFSOCK}, i = stridx("bcdlpfs", *ss[1]);
327 if (i<0) error_exit("bad -type '%c'", *ss[1]);
328 if ((new->st.st_mode & S_IFMT) != types[i]) test = 0;
331 } else if (!strcmp(s, "atime")) {
333 test = compare_numsign(TT.now - new->st.st_atime, 86400, ss[1]);
334 } else if (!strcmp(s, "ctime")) {
336 test = compare_numsign(TT.now - new->st.st_ctime, 86400, ss[1]);
337 } else if (!strcmp(s, "mtime")) {
339 test = compare_numsign(TT.now - new->st.st_mtime, 86400, ss[1]);
340 } else if (!strcmp(s, "size")) {
342 test = compare_numsign(new->st.st_size, 512, ss[1]);
343 } else if (!strcmp(s, "links")) {
344 if (check) test = compare_numsign(new->st.st_nlink, 0, ss[1]);
345 } else if (!strcmp(s, "inum")) {
347 test = compare_numsign(new->st.st_ino, 0, ss[1]);
348 } else if (!strcmp(s, "mindepth") || !strcmp(s, "maxdepth")) {
350 struct dirtree *dt = new;
351 int i = 0, d = atolx(ss[1]);
353 while ((dt = dt->parent)) i++;
356 if (i == d && not) recurse = 0;
359 if (i == d && !not) recurse = 0;
362 } else if (!strcmp(s, "user") || !strcmp(s, "group")
363 || !strcmp(s, "newer"))
375 udl = xmalloc(sizeof(*udl));
376 dlist_add_nomalloc(&TT.argdata, (void *)udl);
378 if (*s == 'u') udl->u.uid = xgetpwnamid(ss[1])->pw_uid;
379 else if (*s == 'g') udl->u.gid = xgetgrnamid(ss[1])->gr_gid;
384 udl->u.tm = st.st_mtim;
387 udl = (void *)llist_pop(&argdata);
388 if (*s == 'u') test = new->st.st_uid == udl->u.uid;
389 else if (*s == 'g') test = new->st.st_gid == udl->u.gid;
391 test = new->st.st_mtim.tv_sec > udl->u.tm.tv_sec;
392 if (new->st.st_mtim.tv_sec == udl->u.tm.tv_sec)
393 test = new->st.st_mtim.tv_nsec > udl->u.tm.tv_nsec;
396 } else if (!strcmp(s, "exec") || !strcmp("ok", s)
397 || !strcmp(s, "execdir") || !strcmp(s, "okdir"))
399 struct exec_range *aa;
403 // Initial argument parsing pass
407 // catch "-exec" with no args and "-exec \;"
408 if (!ss[1] || !strcmp(ss[1], ";")) error_exit("'%s' needs 1 arg", s);
410 dlist_add_nomalloc(&TT.argdata, (void *)(aa = xzalloc(sizeof(*aa))));
414 // Record command line arguments to -exec
415 for (len = 0; ss[len]; len++) {
416 if (!strcmp(ss[len], ";")) break;
417 else if (!strcmp(ss[len], "{}")) {
419 if (!strcmp(ss[len+1], "+")) {
421 // Measure environment space
425 for (env = environ; *env; env++)
426 TT.envsize += sizeof(char *) + strlen(*env) + 1;
427 TT.envsize += sizeof(char *);
433 } else aa->argsize += sizeof(char *) + strlen(ss[len]) + 1;
435 if (!ss[len]) error_exit("-exec without \\;");
438 aa->dir = !!strchr(s, 'd');
439 if (aa->dir && TT.topdir == -1) TT.topdir = xopen(".", 0);
441 // collect names and execute commands
443 char *name, *ss1 = ss[1];
444 struct double_list **ddl;
446 // Grab command line exec argument list
447 aa = (void *)llist_pop(&argdata);
448 ss += aa->arglen + 1;
450 if (!check) goto cont;
451 // name is always a new malloc, so we can always free it.
452 name = aa->dir ? xstrdup(new->name) : dirtree_path(new, 0);
454 // Mark entry so COMEAGAIN can call flush_exec() in parent.
455 // This is never a valid pointer value for prev to have otherwise
456 if (aa->dir) aa->prev = (void *)1;
459 char *prompt = xmprintf("[%s] %s", ss1, name);
460 test = yesno(prompt, 0);
468 // Add next name to list (global list without -dir, local with)
469 if (aa->dir && new->parent)
470 ddl = (struct double_list **)&new->parent->extra;
471 else ddl = &aa->names;
475 int size = sizeof(char *)+strlen(name)+1;
477 // Linux caps environment space (env vars + args) at 32 4k pages.
478 // todo: is there a way to probe this instead of constant here?
480 if (TT.envsize+aa->argsize+aa->namesize+size >= 131072)
481 toys.exitval |= flush_exec(new, aa);
482 aa->namesize += size;
484 dlist_add(ddl, name);
486 if (!aa->plus) test = flush_exec(new, aa);
489 // Argument consumed, skip the check.
493 // This test can go at the end because we do a syntax checking
494 // pass first. Putting it here gets the error message (-unknown
495 // vs -known noarg) right.
496 if (!*++ss) error_exit("'%s' needs 1 arg", --s);
499 // Apply pending "!" to result
500 if (active && not) test = !test;
505 // If there was no action, print
506 if (!print && test) do_print(new, '\n');
507 } else dlist_terminate(TT.argdata);
512 error_exit("bad arg '%s'", *ss);
518 char **ss = toys.optargs;
522 // Distinguish paths from filters
523 for (len = 0; toys.optargs[len]; len++)
524 if (strchr("-!(", *toys.optargs[len])) break;
525 TT.filter = toys.optargs+len;
527 // use "." if no paths
529 ss = (char *[]){"."};
533 // first pass argument parsing, verify args match up, handle "evaluate once"
537 // Loop through paths
538 for (i = 0; i < len; i++)
539 dirtree_handle_callback(dirtree_start(ss[i], toys.optflags&(FLAG_H|FLAG_L)),
542 if (CFG_TOYBOX_FREE) {
544 llist_traverse(TT.argdata, free);