2 * Copyright (c) 1990, 1993, 1994
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. All advertising materials mentioning features or use of this software
14 * must display the following acknowledgement:
15 * This product includes software developed by the University of
16 * California, Berkeley and its contributors.
17 * 4. Neither the name of the University nor the names of its contributors
18 * may be used to endorse or promote products derived from this software
19 * without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * $OpenBSD: fts.c,v 1.22 1999/10/03 19:22:22 millert Exp $
37 #if defined(LIBC_SCCS) && !defined(lint)
38 static char sccsid
[] = "@(#)fts.c 8.6 (Berkeley) 8/14/94";
39 #endif /* LIBC_SCCS and not lint */
42 #define MAX(a, b) ((a) > (b) ? (a) : (b))
43 #define MIN(a, b) ((a) < (b) ? (a) : (b))
46 #define _POSIX_SOURCE 1
49 #include "namespace.h"
50 #include <sys/param.h>
61 #include "un-namespace.h"
63 static FTSENT
*fts_alloc(FTS
*, char *, int);
64 static FTSENT
*fts_build(FTS
*, int);
65 static void fts_lfree(FTSENT
*);
66 static void fts_load(FTS
*, FTSENT
*);
67 static size_t fts_maxarglen(char * const *);
68 static void fts_padjust(FTS
*, FTSENT
*);
69 static int fts_palloc(FTS
*, size_t);
70 static FTSENT
*fts_sort(FTS
*, FTSENT
*, int);
71 static u_short
fts_stat(FTS
*, FTSENT
*, int);
72 static int fts_safe_changedir(FTS
*, FTSENT
*, int, char *);
73 static int fts_ufslinks(FTS
*, const FTSENT
*);
75 #define ISDOT(a) (a[0] == '.' && (!a[1] || (a[1] == '.' && !a[2])))
77 #define CLR(opt) (sp->fts_options &= ~(opt))
78 #define ISSET(opt) (sp->fts_options & (opt))
79 #define SET(opt) (sp->fts_options |= (opt))
81 #define FCHDIR(sp, fd) (!ISSET(FTS_NOCHDIR) && fchdir(fd))
84 #define BCHILD 1 /* fts_children */
85 #define BNAMES 2 /* fts_children, names only */
86 #define BREAD 3 /* fts_read */
89 * Internal representation of an FTS, including extra implementation
90 * details. The FTS returned from fts_open points to this structure's
91 * ftsp_fts member (and can be cast to an _fts_private as required)
96 int ftsp_linksreliable
;
100 * The "FTS_NOSTAT" option can avoid a lot of calls to stat(2) if it
101 * knows that a directory could not possibly have subdirectories. This
102 * is decided by looking at the link count: a subdirectory would
103 * increment its parent's link count by virtue of its own ".." entry.
104 * This assumption only holds for UFS-like filesystems that implement
105 * links and directories this way, so we must punt for others.
108 static const char *ufslike_filesystems
[] = {
116 static void *reallocf(void *ptr
, size_t size
)
119 if((p
= realloc(ptr
, size
))) return p
;
125 fts_open(argv
, options
, compar
)
128 int (*compar
)(const FTSENT
* const *, const FTSENT
* const *);
130 struct _fts_private
*priv
;
134 FTSENT
*parent
, *tmp
;
138 if (options
& ~FTS_OPTIONMASK
) {
143 /* Allocate/initialize the stream. */
144 if ((priv
= malloc(sizeof(*priv
))) == NULL
)
146 memset(priv
, 0, sizeof(*priv
));
147 sp
= &priv
->ftsp_fts
;
148 sp
->fts_compar
= compar
;
149 sp
->fts_options
= options
;
154 /* Logical walks turn on NOCHDIR; symbolic links are too hard. */
155 if (ISSET(FTS_LOGICAL
))
159 * Start out with 1K of path space, and enough, in any case,
160 * to hold the user's paths.
162 if (fts_palloc(sp
, MAX(fts_maxarglen(argv
), PATH_MAX
)))
165 /* Allocate/initialize root's parent. */
166 if ((parent
= fts_alloc(sp
, "", 0)) == NULL
)
168 parent
->fts_level
= FTS_ROOTPARENTLEVEL
;
170 /* Allocate/initialize root(s). */
171 for (root
= NULL
, nitems
= 0; *argv
!= NULL
; ++argv
, ++nitems
) {
172 /* Don't allow zero-length paths. */
173 if ((len
= strlen(*argv
)) == 0) {
178 p
= fts_alloc(sp
, *argv
, len
);
179 p
->fts_level
= FTS_ROOTLEVEL
;
180 p
->fts_parent
= parent
;
181 p
->fts_accpath
= p
->fts_name
;
182 p
->fts_info
= fts_stat(sp
, p
, ISSET(FTS_COMFOLLOW
));
184 /* Command-line "." and ".." are real directories. */
185 if (p
->fts_info
== FTS_DOT
)
189 * If comparison routine supplied, traverse in sorted
190 * order; otherwise traverse in the order specified.
205 if (compar
&& nitems
> 1)
206 root
= fts_sort(sp
, root
, nitems
);
209 * Allocate a dummy pointer and make fts_read think that we've just
210 * finished the node before the root(s); set p->fts_info to FTS_INIT
211 * so that everything about the "current" node is ignored.
213 if ((sp
->fts_cur
= fts_alloc(sp
, "", 0)) == NULL
)
215 sp
->fts_cur
->fts_link
= root
;
216 sp
->fts_cur
->fts_info
= FTS_INIT
;
219 * If using chdir(2), grab a file descriptor pointing to dot to ensure
220 * that we can get back here; this could be avoided for some paths,
221 * but almost certainly not worth the effort. Slashes, symbolic links,
222 * and ".." are all fairly nasty problems. Note, if we can't get the
223 * descriptor we run anyway, just more slowly.
225 if (!ISSET(FTS_NOCHDIR
) && (sp
->fts_rfd
= _open(".", O_RDONLY
, 0)) < 0)
230 mem3
: fts_lfree(root
);
232 mem2
: free(sp
->fts_path
);
246 * Load the stream structure for the next traversal. Since we don't
247 * actually enter the directory until after the preorder visit, set
248 * the fts_accpath field specially so the chdir gets done to the right
249 * place and the user can access the first node. From fts_open it's
250 * known that the path will fit.
252 len
= p
->fts_pathlen
= p
->fts_namelen
;
253 memmove(sp
->fts_path
, p
->fts_name
, len
+ 1);
254 if ((cp
= strrchr(p
->fts_name
, '/')) && (cp
!= p
->fts_name
|| cp
[1])) {
256 memmove(p
->fts_name
, cp
, len
+ 1);
257 p
->fts_namelen
= len
;
259 p
->fts_accpath
= p
->fts_path
= sp
->fts_path
;
260 sp
->fts_dev
= p
->fts_dev
;
271 * This still works if we haven't read anything -- the dummy structure
272 * points to the root list, so we step through to the end of the root
273 * list which has a valid parent pointer.
276 for (p
= sp
->fts_cur
; p
->fts_level
>= FTS_ROOTLEVEL
;) {
278 p
= p
->fts_link
!= NULL
? p
->fts_link
: p
->fts_parent
;
284 /* Free up child linked list, sort array, path buffer. */
286 fts_lfree(sp
->fts_child
);
291 /* Return to original directory, save errno if necessary. */
292 if (!ISSET(FTS_NOCHDIR
)) {
293 saved_errno
= fchdir(sp
->fts_rfd
) ? errno
: 0;
294 (void)_close(sp
->fts_rfd
);
296 /* Set errno and return. */
297 if (saved_errno
!= 0) {
298 /* Free up the stream pointer. */
305 /* Free up the stream pointer. */
311 * Special case of "/" at the end of the path so that slashes aren't
312 * appended which would cause paths to be written as "....//foo".
315 (p->fts_path[p->fts_pathlen - 1] == '/' \
316 ? p->fts_pathlen - 1 : p->fts_pathlen)
327 /* If finished or unrecoverable error, return NULL. */
328 if (sp
->fts_cur
== NULL
|| ISSET(FTS_STOP
))
331 /* Set current node pointer. */
334 /* Save and zero out user instructions. */
335 instr
= p
->fts_instr
;
336 p
->fts_instr
= FTS_NOINSTR
;
338 /* Any type of file may be re-visited; re-stat and re-turn. */
339 if (instr
== FTS_AGAIN
) {
340 p
->fts_info
= fts_stat(sp
, p
, 0);
345 * Following a symlink -- SLNONE test allows application to see
346 * SLNONE and recover. If indirecting through a symlink, have
347 * keep a pointer to current location. If unable to get that
348 * pointer, follow fails.
350 if (instr
== FTS_FOLLOW
&&
351 (p
->fts_info
== FTS_SL
|| p
->fts_info
== FTS_SLNONE
)) {
352 p
->fts_info
= fts_stat(sp
, p
, 1);
353 if (p
->fts_info
== FTS_D
&& !ISSET(FTS_NOCHDIR
)) {
354 if ((p
->fts_symfd
= _open(".", O_RDONLY
, 0)) < 0) {
355 p
->fts_errno
= errno
;
356 p
->fts_info
= FTS_ERR
;
358 p
->fts_flags
|= FTS_SYMFOLLOW
;
363 /* Directory in pre-order. */
364 if (p
->fts_info
== FTS_D
) {
365 /* If skipped or crossed mount point, do post-order visit. */
366 if (instr
== FTS_SKIP
||
367 (ISSET(FTS_XDEV
) && p
->fts_dev
!= sp
->fts_dev
)) {
368 if (p
->fts_flags
& FTS_SYMFOLLOW
)
369 (void)_close(p
->fts_symfd
);
371 fts_lfree(sp
->fts_child
);
372 sp
->fts_child
= NULL
;
374 p
->fts_info
= FTS_DP
;
378 /* Rebuild if only read the names and now traversing. */
379 if (sp
->fts_child
!= NULL
&& ISSET(FTS_NAMEONLY
)) {
381 fts_lfree(sp
->fts_child
);
382 sp
->fts_child
= NULL
;
386 * Cd to the subdirectory.
388 * If have already read and now fail to chdir, whack the list
389 * to make the names come out right, and set the parent errno
390 * so the application will eventually get an error condition.
391 * Set the FTS_DONTCHDIR flag so that when we logically change
392 * directories back to the parent we don't do a chdir.
394 * If haven't read do so. If the read fails, fts_build sets
395 * FTS_STOP or the fts_info field of the node.
397 if (sp
->fts_child
!= NULL
) {
398 if (fts_safe_changedir(sp
, p
, -1, p
->fts_accpath
)) {
399 p
->fts_errno
= errno
;
400 p
->fts_flags
|= FTS_DONTCHDIR
;
401 for (p
= sp
->fts_child
; p
!= NULL
;
404 p
->fts_parent
->fts_accpath
;
406 } else if ((sp
->fts_child
= fts_build(sp
, BREAD
)) == NULL
) {
412 sp
->fts_child
= NULL
;
416 /* Move to the next node on this level. */
418 if ((p
= p
->fts_link
) != NULL
) {
422 * If reached the top, return to the original directory (or
423 * the root of the tree), and load the paths for the next root.
425 if (p
->fts_level
== FTS_ROOTLEVEL
) {
426 if (FCHDIR(sp
, sp
->fts_rfd
)) {
431 return (sp
->fts_cur
= p
);
435 * User may have called fts_set on the node. If skipped,
436 * ignore. If followed, get a file descriptor so we can
437 * get back if necessary.
439 if (p
->fts_instr
== FTS_SKIP
)
441 if (p
->fts_instr
== FTS_FOLLOW
) {
442 p
->fts_info
= fts_stat(sp
, p
, 1);
443 if (p
->fts_info
== FTS_D
&& !ISSET(FTS_NOCHDIR
)) {
445 _open(".", O_RDONLY
, 0)) < 0) {
446 p
->fts_errno
= errno
;
447 p
->fts_info
= FTS_ERR
;
449 p
->fts_flags
|= FTS_SYMFOLLOW
;
451 p
->fts_instr
= FTS_NOINSTR
;
454 name
: t
= sp
->fts_path
+ NAPPEND(p
->fts_parent
);
456 memmove(t
, p
->fts_name
, p
->fts_namelen
+ 1);
457 return (sp
->fts_cur
= p
);
460 /* Move up to the parent node. */
464 if (p
->fts_level
== FTS_ROOTPARENTLEVEL
) {
466 * Done; free everything up and set errno to 0 so the user
467 * can distinguish between error and EOF.
471 return (sp
->fts_cur
= NULL
);
474 /* NUL terminate the pathname. */
475 sp
->fts_path
[p
->fts_pathlen
] = '\0';
478 * Return to the parent directory. If at a root node or came through
479 * a symlink, go back through the file descriptor. Otherwise, cd up
482 if (p
->fts_level
== FTS_ROOTLEVEL
) {
483 if (FCHDIR(sp
, sp
->fts_rfd
)) {
487 } else if (p
->fts_flags
& FTS_SYMFOLLOW
) {
488 if (FCHDIR(sp
, p
->fts_symfd
)) {
490 (void)_close(p
->fts_symfd
);
495 (void)_close(p
->fts_symfd
);
496 } else if (!(p
->fts_flags
& FTS_DONTCHDIR
) &&
497 fts_safe_changedir(sp
, p
->fts_parent
, -1, "..")) {
501 p
->fts_info
= p
->fts_errno
? FTS_ERR
: FTS_DP
;
502 return (sp
->fts_cur
= p
);
506 * Fts_set takes the stream as an argument although it's not used in this
507 * implementation; it would be necessary if anyone wanted to add global
508 * semantics to fts using fts_set. An error return is allowed for similar
513 fts_set(sp
, p
, instr
)
518 if (instr
!= 0 && instr
!= FTS_AGAIN
&& instr
!= FTS_FOLLOW
&&
519 instr
!= FTS_NOINSTR
&& instr
!= FTS_SKIP
) {
523 p
->fts_instr
= instr
;
528 fts_children(sp
, instr
)
535 if (instr
!= 0 && instr
!= FTS_NAMEONLY
) {
540 /* Set current node pointer. */
544 * Errno set to 0 so user can distinguish empty directory from
549 /* Fatal errors stop here. */
553 /* Return logical hierarchy of user's arguments. */
554 if (p
->fts_info
== FTS_INIT
)
555 return (p
->fts_link
);
558 * If not a directory being visited in pre-order, stop here. Could
559 * allow FTS_DNR, assuming the user has fixed the problem, but the
560 * same effect is available with FTS_AGAIN.
562 if (p
->fts_info
!= FTS_D
/* && p->fts_info != FTS_DNR */)
565 /* Free up any previous child list. */
566 if (sp
->fts_child
!= NULL
)
567 fts_lfree(sp
->fts_child
);
569 if (instr
== FTS_NAMEONLY
) {
576 * If using chdir on a relative path and called BEFORE fts_read does
577 * its chdir to the root of a traversal, we can lose -- we need to
578 * chdir into the subdirectory, and we don't know where the current
579 * directory is, so we can't get back so that the upcoming chdir by
580 * fts_read will work.
582 if (p
->fts_level
!= FTS_ROOTLEVEL
|| p
->fts_accpath
[0] == '/' ||
584 return (sp
->fts_child
= fts_build(sp
, instr
));
586 if ((fd
= _open(".", O_RDONLY
, 0)) < 0)
588 sp
->fts_child
= fts_build(sp
, instr
);
592 return (sp
->fts_child
);
595 #ifndef fts_get_clientptr
596 #error "fts_get_clientptr not defined"
600 (fts_get_clientptr
)(FTS
*sp
)
603 return (fts_get_clientptr(sp
));
606 #ifndef fts_get_stream
607 #error "fts_get_stream not defined"
611 (fts_get_stream
)(FTSENT
*p
)
613 return (fts_get_stream(p
));
617 fts_set_clientptr(FTS
*sp
, void *clientptr
)
620 sp
->fts_clientptr
= clientptr
;
624 * This is the tricky part -- do not casually change *anything* in here. The
625 * idea is to build the linked list of entries that are used by fts_children
626 * and fts_read. There are lots of special cases.
628 * The real slowdown in walking the tree is the stat calls. If FTS_NOSTAT is
629 * set and it's a physical walk (so that symbolic links can't be directories),
630 * we can do things quickly. First, if it's a 4.4BSD file system, the type
631 * of the file is in the directory entry. Otherwise, we assume that the number
632 * of subdirectories in a node is equal to the number of links to the parent.
633 * The former skips all stat calls. The latter skips stat calls in any leaf
634 * directories and for any files after the subdirectories in the directory have
635 * been found, cutting the stat calls by about 2/3.
649 int cderrno
, descend
, len
, level
, maxlen
, nlinks
, oflag
, saved_errno
,
653 /* Set current node pointer. */
657 * Open the directory for reading. If this fails, we're done.
658 * If being called from fts_read, set the fts_info field.
661 if (ISSET(FTS_WHITEOUT
))
662 oflag
= DTF_NODUP
| DTF_REWIND
;
664 oflag
= DTF_HIDEW
| DTF_NODUP
| DTF_REWIND
;
666 #define __opendir2(path, flag) opendir(path)
668 if ((dirp
= __opendir2(cur
->fts_accpath
, oflag
)) == NULL
) {
670 cur
->fts_info
= FTS_DNR
;
671 cur
->fts_errno
= errno
;
677 * Nlinks is the number of possible entries of type directory in the
678 * directory if we're cheating on stat calls, 0 if we're not doing
679 * any stat calls at all, -1 if we're doing stats on everything.
681 if (type
== BNAMES
) {
683 /* Be quiet about nostat, GCC. */
685 } else if (ISSET(FTS_NOSTAT
) && ISSET(FTS_PHYSICAL
)) {
686 if (fts_ufslinks(sp
, cur
))
687 nlinks
= cur
->fts_nlink
- (ISSET(FTS_SEEDOT
) ? 0 : 2);
697 (void)printf("nlinks == %d (cur: %d)\n", nlinks
, cur
->fts_nlink
);
698 (void)printf("NOSTAT %d PHYSICAL %d SEEDOT %d\n",
699 ISSET(FTS_NOSTAT
), ISSET(FTS_PHYSICAL
), ISSET(FTS_SEEDOT
));
702 * If we're going to need to stat anything or we want to descend
703 * and stay in the directory, chdir. If this fails we keep going,
704 * but set a flag so we don't chdir after the post-order visit.
705 * We won't be able to stat anything, but we can still return the
706 * names themselves. Note, that since fts_read won't be able to
707 * chdir into the directory, it will have to return different path
708 * names than before, i.e. "a/b" instead of "b". Since the node
709 * has already been visited in pre-order, have to wait until the
710 * post-order visit to return the error. There is a special case
711 * here, if there was nothing to stat then it's not an error to
712 * not be able to stat. This is all fairly nasty. If a program
713 * needed sorted entries or stat information, they had better be
714 * checking FTS_NS on the returned nodes.
717 if (nlinks
|| type
== BREAD
) {
718 if (fts_safe_changedir(sp
, cur
, dirfd(dirp
), NULL
)) {
719 if (nlinks
&& type
== BREAD
)
720 cur
->fts_errno
= errno
;
721 cur
->fts_flags
|= FTS_DONTCHDIR
;
730 * Figure out the max file name length that can be stored in the
731 * current path -- the inner loop allocates more path as necessary.
732 * We really wouldn't have to do the maxlen calculations here, we
733 * could do them in fts_read before returning the path, but it's a
734 * lot easier here since the length is part of the dirent structure.
736 * If not changing directories set a pointer so that can just append
737 * each new name into the path.
740 if (ISSET(FTS_NOCHDIR
)) {
741 cp
= sp
->fts_path
+ len
;
744 /* GCC, you're too verbose. */
748 maxlen
= sp
->fts_pathlen
- len
;
750 level
= cur
->fts_level
+ 1;
752 /* Read the directory, attaching each entry to the `link' pointer. */
754 for (head
= tail
= NULL
, nitems
= 0; dirp
&& (dp
= readdir(dirp
));) {
755 dnamlen
= strlen(dp
->d_name
);
756 if (!ISSET(FTS_SEEDOT
) && ISDOT(dp
->d_name
))
759 if ((p
= fts_alloc(sp
, dp
->d_name
, (int)dnamlen
)) == NULL
)
761 if (dnamlen
>= maxlen
) { /* include space for NUL */
762 oldaddr
= sp
->fts_path
;
763 if (fts_palloc(sp
, dnamlen
+ len
+ 1)) {
765 * No more memory for path or structures. Save
766 * errno, free up the current structure and the
767 * structures already allocated.
769 mem1
: saved_errno
= errno
;
773 (void)closedir(dirp
);
774 cur
->fts_info
= FTS_ERR
;
779 /* Did realloc() change the pointer? */
780 if (oldaddr
!= sp
->fts_path
) {
782 if (ISSET(FTS_NOCHDIR
))
783 cp
= sp
->fts_path
+ len
;
785 maxlen
= sp
->fts_pathlen
- len
;
788 if (len
+ dnamlen
>= USHRT_MAX
) {
790 * In an FTSENT, fts_pathlen is a u_short so it is
791 * possible to wraparound here. If we do, free up
792 * the current structure and the structures already
793 * allocated, then error out with ENAMETOOLONG.
797 (void)closedir(dirp
);
798 cur
->fts_info
= FTS_ERR
;
800 errno
= ENAMETOOLONG
;
803 p
->fts_level
= level
;
804 p
->fts_parent
= sp
->fts_cur
;
805 p
->fts_pathlen
= len
+ dnamlen
;
808 if (dp
->d_type
== DT_WHT
)
809 p
->fts_flags
|= FTS_ISW
;
814 p
->fts_info
= FTS_NS
;
815 p
->fts_errno
= cderrno
;
817 p
->fts_info
= FTS_NSOK
;
818 p
->fts_accpath
= cur
->fts_accpath
;
819 } else if (nlinks
== 0
822 dp
->d_type
!= DT_DIR
&& dp
->d_type
!= DT_UNKNOWN
)
826 ISSET(FTS_NOCHDIR
) ? p
->fts_path
: p
->fts_name
;
827 p
->fts_info
= FTS_NSOK
;
829 /* Build a file name for fts_stat to stat. */
830 if (ISSET(FTS_NOCHDIR
)) {
831 p
->fts_accpath
= p
->fts_path
;
832 memmove(cp
, p
->fts_name
, p
->fts_namelen
+ 1);
834 p
->fts_accpath
= p
->fts_name
;
836 p
->fts_info
= fts_stat(sp
, p
, 0);
838 /* Decrement link count if applicable. */
839 if (nlinks
> 0 && (p
->fts_info
== FTS_D
||
840 p
->fts_info
== FTS_DC
|| p
->fts_info
== FTS_DOT
))
844 /* We walk in directory order so "ls -f" doesn't get upset. */
855 (void)closedir(dirp
);
858 * If realloc() changed the address of the path, adjust the
859 * addresses for the rest of the tree and the dir list.
862 fts_padjust(sp
, head
);
865 * If not changing directories, reset the path back to original
868 if (ISSET(FTS_NOCHDIR
)) {
869 if (len
== sp
->fts_pathlen
|| nitems
== 0)
875 * If descended after called from fts_children or after called from
876 * fts_read and nothing found, get back. At the root level we use
877 * the saved fd; if one of fts_open()'s arguments is a relative path
878 * to an empty directory, we wind up here with no other way back. If
879 * can't get back, we're done.
881 if (descend
&& (type
== BCHILD
|| !nitems
) &&
882 (cur
->fts_level
== FTS_ROOTLEVEL
?
883 FCHDIR(sp
, sp
->fts_rfd
) :
884 fts_safe_changedir(sp
, cur
->fts_parent
, -1, ".."))) {
885 cur
->fts_info
= FTS_ERR
;
890 /* If didn't find anything, return NULL. */
893 cur
->fts_info
= FTS_DP
;
897 /* Sort the entries. */
898 if (sp
->fts_compar
&& nitems
> 1)
899 head
= fts_sort(sp
, head
, nitems
);
904 fts_stat(sp
, p
, follow
)
912 struct stat
*sbp
, sb
;
915 /* If user needs stat info, stat buffer already allocated. */
916 sbp
= ISSET(FTS_NOSTAT
) ? &sb
: p
->fts_statp
;
919 /* Check for whiteout. */
920 if (p
->fts_flags
& FTS_ISW
) {
922 memset(sbp
, '\0', sizeof(*sbp
));
923 sbp
->st_mode
= S_IFWHT
;
930 * If doing a logical walk, or application requested FTS_FOLLOW, do
931 * a stat(2). If that fails, check for a non-existent symlink. If
932 * fail, set the errno from the stat call.
934 if (ISSET(FTS_LOGICAL
) || follow
) {
935 if (stat(p
->fts_accpath
, sbp
)) {
937 if (!lstat(p
->fts_accpath
, sbp
)) {
941 p
->fts_errno
= saved_errno
;
944 } else if (lstat(p
->fts_accpath
, sbp
)) {
945 p
->fts_errno
= errno
;
946 err
: memset(sbp
, 0, sizeof(struct stat
));
950 if (S_ISDIR(sbp
->st_mode
)) {
952 * Set the device/inode. Used to find cycles and check for
953 * crossing mount points. Also remember the link count, used
954 * in fts_build to limit the number of stat calls. It is
955 * understood that these fields are only referenced if fts_info
958 dev
= p
->fts_dev
= sbp
->st_dev
;
959 ino
= p
->fts_ino
= sbp
->st_ino
;
960 p
->fts_nlink
= sbp
->st_nlink
;
962 if (ISDOT(p
->fts_name
))
966 * Cycle detection is done by brute force when the directory
967 * is first encountered. If the tree gets deep enough or the
968 * number of symbolic links to directories is high enough,
969 * something faster might be worthwhile.
971 for (t
= p
->fts_parent
;
972 t
->fts_level
>= FTS_ROOTLEVEL
; t
= t
->fts_parent
)
973 if (ino
== t
->fts_ino
&& dev
== t
->fts_dev
) {
979 if (S_ISLNK(sbp
->st_mode
))
981 if (S_ISREG(sbp
->st_mode
))
983 return (FTS_DEFAULT
);
987 * The comparison function takes pointers to pointers to FTSENT structures.
988 * Qsort wants a comparison function that takes pointers to void.
989 * (Both with appropriate levels of const-poisoning, of course!)
990 * Use a trampoline function to deal with the difference.
993 fts_compar(const void *a
, const void *b
)
997 parent
= (*(const FTSENT
* const *)a
)->fts_fts
;
998 return (*parent
->fts_compar
)(a
, b
);
1002 fts_sort(sp
, head
, nitems
)
1010 * Construct an array of pointers to the structures and call qsort(3).
1011 * Reassemble the array in the order returned by qsort. If unable to
1012 * sort for memory reasons, return the directory entries in their
1013 * current order. Allocate enough space for the current needs plus
1014 * 40 so don't realloc one entry at a time.
1016 if (nitems
> sp
->fts_nitems
) {
1017 sp
->fts_nitems
= nitems
+ 40;
1018 if ((sp
->fts_array
= reallocf(sp
->fts_array
,
1019 sp
->fts_nitems
* sizeof(FTSENT
*))) == NULL
) {
1024 for (ap
= sp
->fts_array
, p
= head
; p
; p
= p
->fts_link
)
1026 qsort(sp
->fts_array
, nitems
, sizeof(FTSENT
*), fts_compar
);
1027 for (head
= *(ap
= sp
->fts_array
); --nitems
; ++ap
)
1028 ap
[0]->fts_link
= ap
[1];
1029 ap
[0]->fts_link
= NULL
;
1034 fts_alloc(sp
, name
, namelen
)
1042 struct ftsent_withstat
{
1044 struct stat statbuf
;
1048 * The file name is a variable length array and no stat structure is
1049 * necessary if the user has set the nostat bit. Allocate the FTSENT
1050 * structure, the file name and the stat structure in one chunk, but
1051 * be careful that the stat structure is reasonably aligned.
1053 if (ISSET(FTS_NOSTAT
))
1054 len
= sizeof(FTSENT
) + namelen
+ 1;
1056 len
= sizeof(struct ftsent_withstat
) + namelen
+ 1;
1058 if ((p
= malloc(len
)) == NULL
)
1061 if (ISSET(FTS_NOSTAT
)) {
1062 p
->fts_name
= (char *)(p
+ 1);
1063 p
->fts_statp
= NULL
;
1065 p
->fts_name
= (char *)((struct ftsent_withstat
*)p
+ 1);
1066 p
->fts_statp
= &((struct ftsent_withstat
*)p
)->statbuf
;
1069 /* Copy the name and guarantee NUL termination. */
1070 memcpy(p
->fts_name
, name
, namelen
);
1071 p
->fts_name
[namelen
] = '\0';
1072 p
->fts_namelen
= namelen
;
1073 p
->fts_path
= sp
->fts_path
;
1076 p
->fts_instr
= FTS_NOINSTR
;
1078 p
->fts_pointer
= NULL
;
1089 /* Free a linked list of structures. */
1090 while ((p
= head
)) {
1091 head
= head
->fts_link
;
1097 * Allow essentially unlimited paths; find, rm, ls should all work on any tree.
1098 * Most systems will allow creation of paths much longer than PATH_MAX, even
1099 * though the kernel won't resolve them. Add the size (not just what's needed)
1100 * plus 256 bytes so don't realloc the path 2 bytes at a time.
1103 fts_palloc(sp
, more
)
1108 sp
->fts_pathlen
+= more
+ 256;
1110 * Check for possible wraparound. In an FTS, fts_pathlen is
1111 * a signed int but in an FTSENT it is an unsigned short.
1112 * We limit fts_pathlen to USHRT_MAX to be safe in both cases.
1114 if (sp
->fts_pathlen
< 0 || sp
->fts_pathlen
>= USHRT_MAX
) {
1117 sp
->fts_path
= NULL
;
1118 errno
= ENAMETOOLONG
;
1121 sp
->fts_path
= reallocf(sp
->fts_path
, sp
->fts_pathlen
);
1122 return (sp
->fts_path
== NULL
);
1126 * When the path is realloc'd, have to fix all of the pointers in structures
1130 fts_padjust(sp
, head
)
1135 char *addr
= sp
->fts_path
;
1137 #define ADJUST(p) do { \
1138 if ((p)->fts_accpath != (p)->fts_name) { \
1139 (p)->fts_accpath = \
1140 (char *)addr + ((p)->fts_accpath - (p)->fts_path); \
1142 (p)->fts_path = addr; \
1144 /* Adjust the current set of children. */
1145 for (p
= sp
->fts_child
; p
; p
= p
->fts_link
)
1148 /* Adjust the rest of the tree, including the current level. */
1149 for (p
= head
; p
->fts_level
>= FTS_ROOTLEVEL
;) {
1151 p
= p
->fts_link
? p
->fts_link
: p
->fts_parent
;
1161 for (max
= 0; *argv
; ++argv
)
1162 if ((len
= strlen(*argv
)) > max
)
1168 * Change to dir specified by fd or p->fts_accpath without getting
1169 * tricked by someone changing the world out from underneath us.
1170 * Assumes p->fts_dev and p->fts_ino are filled in.
1173 fts_safe_changedir(sp
, p
, fd
, path
)
1179 int ret
, oerrno
, newfd
;
1183 if (ISSET(FTS_NOCHDIR
))
1185 if (fd
< 0 && (newfd
= _open(path
, O_RDONLY
, 0)) < 0)
1187 if (_fstat(newfd
, &sb
)) {
1191 if (p
->fts_dev
!= sb
.st_dev
|| p
->fts_ino
!= sb
.st_ino
) {
1192 errno
= ENOENT
; /* disinformation */
1196 ret
= fchdir(newfd
);
1200 (void)_close(newfd
);
1206 * Check if the filesystem for "ent" has UFS-style links.
1209 fts_ufslinks(FTS
*sp
, const FTSENT
*ent
)
1211 struct _fts_private
*priv
;
1214 priv
= (struct _fts_private
*)sp
;
1215 priv
->ftsp_linksreliable
= 0;