xref: /titanic_44/usr/src/lib/libast/common/include/find.h (revision 3e14f97f673e8a630f076077de35afdd43dc1587)
1da2e3ebdSchin /***********************************************************************
2da2e3ebdSchin *                                                                      *
3da2e3ebdSchin *               This software is part of the ast package               *
4*3e14f97fSRoger A. Faulkner *          Copyright (c) 1985-2010 AT&T Intellectual Property          *
5da2e3ebdSchin *                      and is licensed under the                       *
6da2e3ebdSchin *                  Common Public License, Version 1.0                  *
77c2fbfb3SApril Chin *                    by AT&T Intellectual Property                     *
8da2e3ebdSchin *                                                                      *
9da2e3ebdSchin *                A copy of the License is available at                 *
10da2e3ebdSchin *            http://www.opensource.org/licenses/cpl1.0.txt             *
11da2e3ebdSchin *         (with md5 checksum 059e8cd6165cb4c31e351f2b69388fd9)         *
12da2e3ebdSchin *                                                                      *
13da2e3ebdSchin *              Information and Software Systems Research               *
14da2e3ebdSchin *                            AT&T Research                             *
15da2e3ebdSchin *                           Florham Park NJ                            *
16da2e3ebdSchin *                                                                      *
17da2e3ebdSchin *                 Glenn Fowler <gsf@research.att.com>                  *
18da2e3ebdSchin *                  David Korn <dgk@research.att.com>                   *
19da2e3ebdSchin *                   Phong Vo <kpv@research.att.com>                    *
20da2e3ebdSchin *                                                                      *
21da2e3ebdSchin ***********************************************************************/
22da2e3ebdSchin #pragma prototyped
23da2e3ebdSchin /*
24da2e3ebdSchin  * Glenn Fowler
25da2e3ebdSchin  * AT&T Research
26da2e3ebdSchin  *
27da2e3ebdSchin  * fast find interface definitions
28da2e3ebdSchin  */
29da2e3ebdSchin 
30da2e3ebdSchin #ifndef _FIND_H
31da2e3ebdSchin #define _FIND_H
32da2e3ebdSchin 
33da2e3ebdSchin #define FIND_VERSION	19980301L
34da2e3ebdSchin 
35da2e3ebdSchin #ifndef FIND_CODES
36da2e3ebdSchin #define FIND_CODES	"lib/find/codes"
37da2e3ebdSchin #endif
38da2e3ebdSchin 
39da2e3ebdSchin #define FIND_CODES_ENV	"FINDCODES"
40da2e3ebdSchin 
41da2e3ebdSchin #define FIND_GENERATE	(1<<0)		/* generate new codes		*/
42da2e3ebdSchin #define FIND_ICASE	(1<<1)		/* ignore case in match		*/
43da2e3ebdSchin #define FIND_GNU	(1<<2)		/* generate gnu format codes	*/
44da2e3ebdSchin #define FIND_OLD	(1<<3)		/* generate old format codes	*/
45da2e3ebdSchin #define FIND_TYPE	(1<<4)		/* generate type with codes	*/
46da2e3ebdSchin #define FIND_VERIFY	(1<<5)		/* verify the dir hierarchy	*/
47da2e3ebdSchin 
48da2e3ebdSchin #define FIND_USER	(1L<<16)	/* first user flag bit		*/
49da2e3ebdSchin 
50da2e3ebdSchin struct Find_s;
51da2e3ebdSchin struct Finddisc_s;
52da2e3ebdSchin 
53da2e3ebdSchin typedef int (*Findverify_f)(struct Find_s*, const char*, size_t, struct Finddisc_s*);
54da2e3ebdSchin 
55da2e3ebdSchin typedef struct Finddisc_s
56da2e3ebdSchin {
57da2e3ebdSchin 	unsigned long	version;	/* interface version		*/
58da2e3ebdSchin 	unsigned long	flags;		/* FIND_* flags			*/
59da2e3ebdSchin 	Error_f		errorf;		/* error function		*/
60da2e3ebdSchin 	Findverify_f	verifyf;	/* dir verify function		*/
61da2e3ebdSchin 	char**		dirs;		/* dir prefixes to search	*/
62da2e3ebdSchin } Finddisc_t;
63da2e3ebdSchin 
64da2e3ebdSchin typedef struct Find_s
65da2e3ebdSchin {
66da2e3ebdSchin 	const char*	id;		/* library id string		*/
67da2e3ebdSchin 	unsigned long	stamp;		/* codes time stamp		*/
68da2e3ebdSchin 
69da2e3ebdSchin #ifdef _FIND_PRIVATE_
70da2e3ebdSchin 	_FIND_PRIVATE_
71da2e3ebdSchin #endif
72da2e3ebdSchin 
73da2e3ebdSchin } Find_t;
74da2e3ebdSchin 
75da2e3ebdSchin #if _BLD_ast && defined(__EXPORT__)
76da2e3ebdSchin #define extern		__EXPORT__
77da2e3ebdSchin #endif
78da2e3ebdSchin 
79da2e3ebdSchin extern Find_t*		findopen(const char*, const char*, const char*, Finddisc_t*);
80da2e3ebdSchin extern char*		findread(Find_t*);
81da2e3ebdSchin extern int		findwrite(Find_t*, const char*, size_t, const char*);
82da2e3ebdSchin extern int		findclose(Find_t*);
83da2e3ebdSchin 
84da2e3ebdSchin #undef	extern
85da2e3ebdSchin 
86da2e3ebdSchin #endif
87