1 /* vi: set sw=4 ts=4: */
5 * Copyright (C) 1999-2004 by Erik Andersen <andersen@codepoet.org>
7 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
11 #undef DEBUG_RECURS_ACTION
14 * Walk down all the directories under the specified
15 * location, and do something (something specified
16 * by the fileAction and dirAction function pointers).
18 * Unfortunately, while nftw(3) could replace this and reduce
19 * code size a bit, nftw() wasn't supported before GNU libc 2.1,
20 * and so isn't sufficiently portable to take over since glibc2.1
21 * is so stinking huge.
24 static int FAST_FUNC true_action(const char *fileName UNUSED_PARAM,
25 struct stat *statbuf UNUSED_PARAM,
26 void* userData UNUSED_PARAM,
27 int depth UNUSED_PARAM)
32 /* fileName is (l)stat'ed (depending on ACTION_FOLLOWLINKS[_L0]).
34 * If it is a file: fileAction in run on it, its return value is returned.
36 * In case we are in a recursive invocation (see below):
37 * normally, fileAction should return 1 (TRUE) to indicate that
38 * everything is okay and processing should continue.
39 * fileAction return value of 0 (FALSE) on any file in directory will make
40 * recursive_action() also return 0, but it doesn't stop directory traversal
41 * (fileAction/dirAction will be called on each file).
43 * [TODO: maybe introduce -1 to mean "stop traversal NOW and return"]
45 * If it is a directory:
47 * If !ACTION_RECURSE, dirAction is called and its
48 * return value is returned from recursive_action(). No recursion.
50 * If ACTION_RECURSE, directory is opened, and recursive_action() is called
51 * on each file/subdirectory.
52 * If any one of these calls returns 0, current recursive_action() returns 0.
54 * If !ACTION_DEPTHFIRST, dirAction is called before recurse.
55 * Return value of 0 (FALSE) is an error: prevents recursion,
56 * the warning is printed (unless ACTION_QUIET) and recursive_action() returns 0.
57 * Return value of 2 (SKIP) prevents recursion, instead recursive_action()
58 * returns 1 (TRUE, no error).
60 * If ACTION_DEPTHFIRST, dirAction is called after recurse.
61 * If it returns 0, the warning is printed and recursive_action() returns 0.
63 * ACTION_FOLLOWLINKS mainly controls handling of links to dirs.
64 * 0: lstat(statbuf). Calls fileAction on link name even if points to dir.
65 * 1: stat(statbuf). Calls dirAction and optionally recurse on link to dir.
68 int FAST_FUNC recursive_action(const char *fileName,
70 int FAST_FUNC (*fileAction)(const char *fileName, struct stat *statbuf, void* userData, int depth),
71 int FAST_FUNC (*dirAction)(const char *fileName, struct stat *statbuf, void* userData, int depth),
81 if (!fileAction) fileAction = true_action;
82 if (!dirAction) dirAction = true_action;
84 follow = ACTION_FOLLOWLINKS;
86 follow = ACTION_FOLLOWLINKS | ACTION_FOLLOWLINKS_L0;
88 status = (follow ? stat : lstat)(fileName, &statbuf);
90 #ifdef DEBUG_RECURS_ACTION
91 bb_error_msg("status=%d flags=%x", status, flags);
93 if ((flags & ACTION_DANGLING_OK)
95 && lstat(fileName, &statbuf) == 0
98 return fileAction(fileName, &statbuf, userData, depth);
103 /* If S_ISLNK(m), then we know that !S_ISDIR(m).
104 * Then we can skip checking first part: if it is true, then
105 * (!dir) is also true! */
106 if ( /* (!(flags & ACTION_FOLLOWLINKS) && S_ISLNK(statbuf.st_mode)) || */
107 !S_ISDIR(statbuf.st_mode)
109 return fileAction(fileName, &statbuf, userData, depth);
112 /* It's a directory (or a link to one, and followLinks is set) */
114 if (!(flags & ACTION_RECURSE)) {
115 return dirAction(fileName, &statbuf, userData, depth);
118 if (!(flags & ACTION_DEPTHFIRST)) {
119 status = dirAction(fileName, &statbuf, userData, depth);
126 dir = opendir(fileName);
128 /* findutils-4.1.20 reports this */
129 /* (i.e. it doesn't silently return with exit code 1) */
130 /* To trigger: "find -exec rm -rf {} \;" */
134 while ((next = readdir(dir)) != NULL) {
138 nextFile = concat_subpath_file(fileName, next->d_name);
139 if (nextFile == NULL)
142 /* process every file (NB: ACTION_RECURSE is set in flags) */
143 s = recursive_action(nextFile, flags, fileAction, dirAction,
144 userData, depth + 1);
148 //#define RECURSE_RESULT_ABORT -1
149 // if (s == RECURSE_RESULT_ABORT) {
156 if (flags & ACTION_DEPTHFIRST) {
157 if (!dirAction(fileName, &statbuf, userData, depth))
164 if (!(flags & ACTION_QUIET))
165 bb_simple_perror_msg(fileName);