xref: /openbsd/include/ftw.h (revision bf198cc6)
1 /*	$OpenBSD: ftw.h,v 1.2 2019/01/25 00:19:25 millert Exp $	*/
2 
3 /*
4  * Copyright (c) 2003 Todd C. Miller <millert@openbsd.org>
5  *
6  * Permission to use, copy, modify, and distribute this software for any
7  * purpose with or without fee is hereby granted, provided that the above
8  * copyright notice and this permission notice appear in all copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17  *
18  * Sponsored in part by the Defense Advanced Research Projects
19  * Agency (DARPA) and Air Force Research Laboratory, Air Force
20  * Materiel Command, USAF, under agreement number F39502-99-1-0512.
21  */
22 
23 #ifndef	_FTW_H
24 #define	_FTW_H
25 
26 #include <sys/types.h>
27 #include <sys/stat.h>
28 
29 /*
30  * Valid flags for the 3rd argument to the function that is passed as the
31  * second argument to ftw(3) and nftw(3).  Say it three times fast!
32  */
33 #define	FTW_F		0	/* File.  */
34 #define	FTW_D		1	/* Directory.  */
35 #define	FTW_DNR		2	/* Directory without read permission.  */
36 #define	FTW_DP		3	/* Directory with subdirectories visited.  */
37 #define	FTW_NS		4	/* Unknown type; stat() failed.  */
38 #define	FTW_SL		5	/* Symbolic link.  */
39 #define	FTW_SLN		6	/* Sym link that names a nonexistent file.  */
40 
41 /*
42  * Flags for use as the 4th argument to nftw(3).  These may be ORed together.
43  */
44 #define	FTW_PHYS	0x01	/* Physical walk, don't follow sym links.  */
45 #define	FTW_MOUNT	0x02	/* The walk does not cross a mount point.  */
46 #define	FTW_DEPTH	0x04	/* Subdirs visited before the dir itself. */
47 #define	FTW_CHDIR	0x08	/* Change to a directory before reading it. */
48 
49 struct FTW {
50 	int base;
51 	int level;
52 };
53 
54 __BEGIN_DECLS
55 int	ftw(const char *, int (*)(const char *, const struct stat *, int), int);
56 int	nftw(const char *, int (*)(const char *, const struct stat *, int,
57 	    struct FTW *), int, int);
58 __END_DECLS
59 
60 #endif	/* !_FTW_H */
61