xref: /freebsd/lib/libc/gen/telldir.h (revision 9336e0699bda8a301cd2bfa37106b6ec5e32012e)
1 /*
2  * Copyright (c) 1983, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  *
5  * Copyright (c) 2000
6  * 	Daniel Eischen.  All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. Neither the name of the University nor the names of its contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  *
32  * $FreeBSD$
33  */
34 
35 #ifndef _TELLDIR_H_
36 #define	_TELLDIR_H_
37 
38 #include <sys/queue.h>
39 
40 /*
41  * One of these structures is malloced to describe the current directory
42  * position each time telldir is called. It records the current magic
43  * cookie returned by getdirentries and the offset within the buffer
44  * associated with that return value.
45  */
46 struct ddloc {
47 	LIST_ENTRY(ddloc) loc_lqe; /* entry in list */
48 	long	loc_index;	/* key associated with structure */
49 	long	loc_seek;	/* magic cookie returned by getdirentries */
50 	long	loc_loc;	/* offset of entry in buffer */
51 };
52 
53 /*
54  * One of these structures is malloced for each DIR to record telldir
55  * positions.
56  */
57 struct _telldir {
58 	LIST_HEAD(, ddloc) td_locq; /* list of locations */
59 	long	td_loccnt;	/* index of entry for sequential readdir's */
60 };
61 
62 struct dirent	*_readdir_unlocked(DIR *);
63 void 		_reclaim_telldir(DIR *);
64 void 		_seekdir(DIR *, long);
65 
66 #endif
67