xref: /netbsd/include/fts.h (revision c4a72b64)
1 /*	$NetBSD: fts.h,v 1.10 2002/11/11 01:07:08 thorpej Exp $	*/
2 
3 /*
4  * Copyright (c) 1989, 1993
5  *	The Regents of the University of California.  All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. All advertising materials mentioning features or use of this software
16  *    must display the following acknowledgement:
17  *	This product includes software developed by the University of
18  *	California, Berkeley and its contributors.
19  * 4. Neither the name of the University nor the names of its contributors
20  *    may be used to endorse or promote products derived from this software
21  *    without specific prior written permission.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33  * SUCH DAMAGE.
34  *
35  *	@(#)fts.h	8.3 (Berkeley) 8/14/94
36  */
37 
38 #ifndef	_FTS_H_
39 #define	_FTS_H_
40 
41 typedef struct {
42 	struct _ftsent *fts_cur;	/* current node */
43 	struct _ftsent *fts_child;	/* linked list of children */
44 	struct _ftsent **fts_array;	/* sort array */
45 	dev_t fts_dev;			/* starting device # */
46 	char *fts_path;			/* path for this descent */
47 	int fts_rfd;			/* fd for root */
48 	u_int fts_pathlen;		/* sizeof(path) */
49 	u_int fts_nitems;		/* elements in the sort array */
50 	int (*fts_compar)		/* compare function */
51 	    __P((const struct _ftsent **, const struct _ftsent **));
52 
53 #define	FTS_COMFOLLOW	0x001		/* follow command line symlinks */
54 #define	FTS_LOGICAL	0x002		/* logical walk */
55 #define	FTS_NOCHDIR	0x004		/* don't change directories */
56 #define	FTS_NOSTAT	0x008		/* don't get stat info */
57 #define	FTS_PHYSICAL	0x010		/* physical walk */
58 #define	FTS_SEEDOT	0x020		/* return dot and dot-dot */
59 #define	FTS_XDEV	0x040		/* don't cross devices */
60 #define	FTS_WHITEOUT	0x080		/* return whiteout information */
61 #define	FTS_OPTIONMASK	0x0ff		/* valid user option mask */
62 
63 #define	FTS_NAMEONLY	0x100		/* (private) child names only */
64 #define	FTS_STOP	0x200		/* (private) unrecoverable error */
65 	int fts_options;		/* fts_open options, global flags */
66 } FTS;
67 
68 typedef struct _ftsent {
69 	struct _ftsent *fts_cycle;	/* cycle node */
70 	struct _ftsent *fts_parent;	/* parent directory */
71 	struct _ftsent *fts_link;	/* next file in directory */
72 	long fts_number;	        /* local numeric value */
73 	void *fts_pointer;	        /* local address value */
74 	char *fts_accpath;		/* access path */
75 	char *fts_path;			/* root path */
76 	int fts_errno;			/* errno for this node */
77 	int fts_symfd;			/* fd for symlink */
78 	u_short fts_pathlen;		/* strlen(fts_path) */
79 	u_short fts_namelen;		/* strlen(fts_name) */
80 
81 	ino_t fts_ino;			/* inode */
82 	dev_t fts_dev;			/* device */
83 #ifdef __LIBC12_SOURCE__
84 	u_int16_t fts_nlink;		/* link count */
85 #else
86 	nlink_t fts_nlink;		/* link count */
87 #endif
88 
89 #define	FTS_ROOTPARENTLEVEL	-1
90 #define	FTS_ROOTLEVEL		 0
91 	short fts_level;		/* depth (-1 to N) */
92 
93 #define	FTS_D		 1		/* preorder directory */
94 #define	FTS_DC		 2		/* directory that causes cycles */
95 #define	FTS_DEFAULT	 3		/* none of the above */
96 #define	FTS_DNR		 4		/* unreadable directory */
97 #define	FTS_DOT		 5		/* dot or dot-dot */
98 #define	FTS_DP		 6		/* postorder directory */
99 #define	FTS_ERR		 7		/* error; errno is set */
100 #define	FTS_F		 8		/* regular file */
101 #define	FTS_INIT	 9		/* initialized only */
102 #define	FTS_NS		10		/* stat(2) failed */
103 #define	FTS_NSOK	11		/* no stat(2) requested */
104 #define	FTS_SL		12		/* symbolic link */
105 #define	FTS_SLNONE	13		/* symbolic link without target */
106 #define	FTS_W		14		/* whiteout object */
107 	u_short fts_info;		/* user flags for FTSENT structure */
108 
109 #define	FTS_DONTCHDIR	 0x01		/* don't chdir .. to the parent */
110 #define	FTS_SYMFOLLOW	 0x02		/* followed a symlink to get here */
111 #define	FTS_ISW		 0x04		/* this is a whiteout object */
112 	u_short fts_flags;		/* private flags for FTSENT structure */
113 
114 #define	FTS_AGAIN	 1		/* read node again */
115 #define	FTS_FOLLOW	 2		/* follow symbolic link */
116 #define	FTS_NOINSTR	 3		/* no instructions */
117 #define	FTS_SKIP	 4		/* discard node */
118 	u_short fts_instr;		/* fts_set() instructions */
119 
120 #ifdef __LIBC12_SOURCE__
121 	struct stat12 *fts_statp;	/* stat(2) information */
122 #else
123 	struct stat *fts_statp;		/* stat(2) information */
124 #endif
125 	char fts_name[1];		/* file name */
126 } FTSENT;
127 
128 #include <sys/cdefs.h>
129 
130 __BEGIN_DECLS
131 #ifdef __LIBC12_SOURCE__
132 FTSENT	*fts_children __P((FTS *, int));
133 int	 fts_close __P((FTS *));
134 FTS	*fts_open __P((char * const *, int,
135 	    int (*)(const FTSENT **, const FTSENT **)));
136 FTSENT	*fts_read __P((FTS *));
137 int	 fts_set __P((FTS *, FTSENT *, int));
138 #else
139 FTSENT	*fts_children __P((FTS *, int))		__RENAME(__fts_children13);
140 int	 fts_close __P((FTS *))			__RENAME(__fts_close13);
141 FTS	*fts_open __P((char * const *, int,
142 	    int (*)(const FTSENT **, const FTSENT **)))
143 						__RENAME(__fts_open13);
144 FTSENT	*fts_read __P((FTS *))			__RENAME(__fts_read13);
145 int	 fts_set __P((FTS *, FTSENT *, int))	__RENAME(__fts_set13);
146 #endif
147 __END_DECLS
148 
149 #endif /* !_FTS_H_ */
150