1 |
1325 |
phoenix |
/* Copyright (C) 1991,92,95,96,97,98,2000,2001 Free Software Foundation, Inc.
|
2 |
|
|
This file is part of the GNU C Library.
|
3 |
|
|
|
4 |
|
|
The GNU C Library is free software; you can redistribute it and/or
|
5 |
|
|
modify it under the terms of the GNU Lesser General Public
|
6 |
|
|
License as published by the Free Software Foundation; either
|
7 |
|
|
version 2.1 of the License, or (at your option) any later version.
|
8 |
|
|
|
9 |
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
10 |
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
11 |
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
12 |
|
|
Lesser General Public License for more details.
|
13 |
|
|
|
14 |
|
|
You should have received a copy of the GNU Lesser General Public
|
15 |
|
|
License along with the GNU C Library; if not, write to the Free
|
16 |
|
|
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
17 |
|
|
02111-1307 USA. */
|
18 |
|
|
|
19 |
|
|
#ifndef _GLOB_H
|
20 |
|
|
#define _GLOB_H 1
|
21 |
|
|
|
22 |
|
|
#ifdef __cplusplus
|
23 |
|
|
extern "C" {
|
24 |
|
|
#endif
|
25 |
|
|
|
26 |
|
|
#undef __ptr_t
|
27 |
|
|
#if defined __cplusplus || (defined __STDC__ && __STDC__) || defined WINDOWS32
|
28 |
|
|
# if !defined __GLIBC__ || !defined __P
|
29 |
|
|
# undef __P
|
30 |
|
|
# undef __PMT
|
31 |
|
|
# define __P(protos) protos
|
32 |
|
|
# define __PMT(protos) protos
|
33 |
|
|
# if !defined __GNUC__ || __GNUC__ < 2
|
34 |
|
|
# undef __const
|
35 |
|
|
# define __const const
|
36 |
|
|
# endif
|
37 |
|
|
# endif
|
38 |
|
|
# define __ptr_t void *
|
39 |
|
|
#else /* Not C++ or ANSI C. */
|
40 |
|
|
# undef __P
|
41 |
|
|
# undef __PMT
|
42 |
|
|
# define __P(protos) ()
|
43 |
|
|
# define __PMT(protos) ()
|
44 |
|
|
# undef __const
|
45 |
|
|
# define __const
|
46 |
|
|
# define __ptr_t char *
|
47 |
|
|
#endif /* C++ or ANSI C. */
|
48 |
|
|
|
49 |
|
|
/* We need `size_t' for the following definitions. */
|
50 |
|
|
#ifndef __size_t
|
51 |
|
|
# if defined __GNUC__ && __GNUC__ >= 2
|
52 |
|
|
typedef __SIZE_TYPE__ __size_t;
|
53 |
|
|
# ifdef _XOPEN_SOURCE
|
54 |
|
|
typedef __SIZE_TYPE__ size_t;
|
55 |
|
|
# endif
|
56 |
|
|
# else
|
57 |
|
|
/* This is a guess. */
|
58 |
|
|
typedef unsigned long int __size_t;
|
59 |
|
|
# endif
|
60 |
|
|
#else
|
61 |
|
|
/* The GNU CC stddef.h version defines __size_t as empty. We need a real
|
62 |
|
|
definition. */
|
63 |
|
|
# undef __size_t
|
64 |
|
|
# define __size_t size_t
|
65 |
|
|
#endif
|
66 |
|
|
|
67 |
|
|
/* Bits set in the FLAGS argument to `glob'. */
|
68 |
|
|
#define GLOB_ERR (1 << 0)/* Return on read errors. */
|
69 |
|
|
#define GLOB_MARK (1 << 1)/* Append a slash to each name. */
|
70 |
|
|
#define GLOB_NOSORT (1 << 2)/* Don't sort the names. */
|
71 |
|
|
#define GLOB_DOOFFS (1 << 3)/* Insert PGLOB->gl_offs NULLs. */
|
72 |
|
|
#define GLOB_NOCHECK (1 << 4)/* If nothing matches, return the pattern. */
|
73 |
|
|
#define GLOB_APPEND (1 << 5)/* Append to results of a previous call. */
|
74 |
|
|
#define GLOB_NOESCAPE (1 << 6)/* Backslashes don't quote metacharacters. */
|
75 |
|
|
#define GLOB_PERIOD (1 << 7)/* Leading `.' can be matched by metachars. */
|
76 |
|
|
|
77 |
|
|
#if (!defined _POSIX_C_SOURCE || _POSIX_C_SOURCE < 2 || defined _BSD_SOURCE \
|
78 |
|
|
|| defined _GNU_SOURCE)
|
79 |
|
|
# define GLOB_MAGCHAR (1 << 8)/* Set in gl_flags if any metachars seen. */
|
80 |
|
|
# define GLOB_ALTDIRFUNC (1 << 9)/* Use gl_opendir et al functions. */
|
81 |
|
|
# define GLOB_BRACE (1 << 10)/* Expand "{a,b}" to "a" "b". */
|
82 |
|
|
# define GLOB_NOMAGIC (1 << 11)/* If no magic chars, return the pattern. */
|
83 |
|
|
# define GLOB_TILDE (1 << 12)/* Expand ~user and ~ to home directories. */
|
84 |
|
|
# define GLOB_ONLYDIR (1 << 13)/* Match only directories. */
|
85 |
|
|
# define GLOB_TILDE_CHECK (1 << 14)/* Like GLOB_TILDE but return an error
|
86 |
|
|
if the user name is not available. */
|
87 |
|
|
# define __GLOB_FLAGS (GLOB_ERR|GLOB_MARK|GLOB_NOSORT|GLOB_DOOFFS| \
|
88 |
|
|
GLOB_NOESCAPE|GLOB_NOCHECK|GLOB_APPEND| \
|
89 |
|
|
GLOB_PERIOD|GLOB_ALTDIRFUNC|GLOB_BRACE| \
|
90 |
|
|
GLOB_NOMAGIC|GLOB_TILDE|GLOB_ONLYDIR|GLOB_TILDE_CHECK)
|
91 |
|
|
#else
|
92 |
|
|
# define __GLOB_FLAGS (GLOB_ERR|GLOB_MARK|GLOB_NOSORT|GLOB_DOOFFS| \
|
93 |
|
|
GLOB_NOESCAPE|GLOB_NOCHECK|GLOB_APPEND| \
|
94 |
|
|
GLOB_PERIOD)
|
95 |
|
|
#endif
|
96 |
|
|
|
97 |
|
|
/* Error returns from `glob'. */
|
98 |
|
|
#define GLOB_NOSPACE 1 /* Ran out of memory. */
|
99 |
|
|
#define GLOB_ABORTED 2 /* Read error. */
|
100 |
|
|
#define GLOB_NOMATCH 3 /* No matches found. */
|
101 |
|
|
#define GLOB_NOSYS 4 /* Not implemented. */
|
102 |
|
|
#ifdef _GNU_SOURCE
|
103 |
|
|
/* Previous versions of this file defined GLOB_ABEND instead of
|
104 |
|
|
GLOB_ABORTED. Provide a compatibility definition here. */
|
105 |
|
|
# define GLOB_ABEND GLOB_ABORTED
|
106 |
|
|
#endif
|
107 |
|
|
|
108 |
|
|
/* Structure describing a globbing run. */
|
109 |
|
|
#if !defined _AMIGA && !defined VMS /* Buggy compiler. */
|
110 |
|
|
# ifdef _GNU_SOURCE
|
111 |
|
|
struct stat;
|
112 |
|
|
# endif
|
113 |
|
|
#endif
|
114 |
|
|
typedef struct
|
115 |
|
|
{
|
116 |
|
|
__size_t gl_pathc; /* Count of paths matched by the pattern. */
|
117 |
|
|
char **gl_pathv; /* List of matched pathnames. */
|
118 |
|
|
__size_t gl_offs; /* Slots to reserve in `gl_pathv'. */
|
119 |
|
|
int gl_flags; /* Set to FLAGS, maybe | GLOB_MAGCHAR. */
|
120 |
|
|
|
121 |
|
|
/* If the GLOB_ALTDIRFUNC flag is set, the following functions
|
122 |
|
|
are used instead of the normal file access functions. */
|
123 |
|
|
void (*gl_closedir) __PMT ((void *));
|
124 |
|
|
#ifdef _GNU_SOURCE
|
125 |
|
|
struct dirent *(*gl_readdir) __PMT ((void *));
|
126 |
|
|
#else
|
127 |
|
|
void *(*gl_readdir) __PMT ((void *));
|
128 |
|
|
#endif
|
129 |
|
|
__ptr_t (*gl_opendir) __PMT ((__const char *));
|
130 |
|
|
#ifdef _GNU_SOURCE
|
131 |
|
|
int (*gl_lstat) __PMT ((__const char *__restrict,
|
132 |
|
|
struct stat *__restrict));
|
133 |
|
|
int (*gl_stat) __PMT ((__const char *__restrict, struct stat *__restrict));
|
134 |
|
|
#else
|
135 |
|
|
int (*gl_lstat) __PMT ((__const char *__restrict, void *__restrict));
|
136 |
|
|
int (*gl_stat) __PMT ((__const char *__restrict, void *__restrict));
|
137 |
|
|
#endif
|
138 |
|
|
} glob_t;
|
139 |
|
|
|
140 |
|
|
#ifdef _LARGEFILE64_SOURCE
|
141 |
|
|
# ifdef _GNU_SOURCE
|
142 |
|
|
struct stat64;
|
143 |
|
|
# endif
|
144 |
|
|
typedef struct
|
145 |
|
|
{
|
146 |
|
|
__size_t gl_pathc;
|
147 |
|
|
char **gl_pathv;
|
148 |
|
|
__size_t gl_offs;
|
149 |
|
|
int gl_flags;
|
150 |
|
|
|
151 |
|
|
/* If the GLOB_ALTDIRFUNC flag is set, the following functions
|
152 |
|
|
are used instead of the normal file access functions. */
|
153 |
|
|
void (*gl_closedir) __PMT ((void *));
|
154 |
|
|
# ifdef _GNU_SOURCE
|
155 |
|
|
struct dirent64 *(*gl_readdir) __PMT ((void *));
|
156 |
|
|
# else
|
157 |
|
|
void *(*gl_readdir) __PMT ((void *));
|
158 |
|
|
# endif
|
159 |
|
|
__ptr_t (*gl_opendir) __PMT ((__const char *));
|
160 |
|
|
# ifdef _GNU_SOURCE
|
161 |
|
|
int (*gl_lstat) __PMT ((__const char *__restrict,
|
162 |
|
|
struct stat64 *__restrict));
|
163 |
|
|
int (*gl_stat) __PMT ((__const char *__restrict,
|
164 |
|
|
struct stat64 *__restrict));
|
165 |
|
|
# else
|
166 |
|
|
int (*gl_lstat) __PMT ((__const char *__restrict, void *__restrict));
|
167 |
|
|
int (*gl_stat) __PMT ((__const char *__restrict, void *__restrict));
|
168 |
|
|
# endif
|
169 |
|
|
} glob64_t;
|
170 |
|
|
#endif
|
171 |
|
|
|
172 |
|
|
#if _FILE_OFFSET_BITS == 64 && __GNUC__ < 2
|
173 |
|
|
# define glob glob64
|
174 |
|
|
# define globfree globfree64
|
175 |
|
|
#endif
|
176 |
|
|
|
177 |
|
|
/* Do glob searching for PATTERN, placing results in PGLOB.
|
178 |
|
|
The bits defined above may be set in FLAGS.
|
179 |
|
|
If a directory cannot be opened or read and ERRFUNC is not nil,
|
180 |
|
|
it is called with the pathname that caused the error, and the
|
181 |
|
|
`errno' value from the failing call; if it returns non-zero
|
182 |
|
|
`glob' returns GLOB_ABEND; if it returns zero, the error is ignored.
|
183 |
|
|
If memory cannot be allocated for PGLOB, GLOB_NOSPACE is returned.
|
184 |
|
|
Otherwise, `glob' returns zero. */
|
185 |
|
|
#if _FILE_OFFSET_BITS != 64 || __GNUC__ < 2
|
186 |
|
|
extern int glob __P ((__const char *__restrict __pattern, int __flags,
|
187 |
|
|
int (*__errfunc) (__const char *, int),
|
188 |
|
|
glob_t *__restrict __pglob));
|
189 |
|
|
|
190 |
|
|
/* Free storage allocated in PGLOB by a previous `glob' call. */
|
191 |
|
|
extern void globfree __P ((glob_t *__pglob));
|
192 |
|
|
#else
|
193 |
|
|
extern int glob __P ((__const char *__restrict __pattern, int __flags,
|
194 |
|
|
int (*__errfunc) (__const char *, int),
|
195 |
|
|
glob_t *__restrict __pglob)) __asm__ ("glob64");
|
196 |
|
|
|
197 |
|
|
extern void globfree __P ((glob_t *__pglob)) __asm__ ("globfree64");
|
198 |
|
|
#endif
|
199 |
|
|
|
200 |
|
|
#ifdef _LARGEFILE64_SOURCE
|
201 |
|
|
extern int glob64 __P ((__const char *__restrict __pattern, int __flags,
|
202 |
|
|
int (*__errfunc) (__const char *, int),
|
203 |
|
|
glob64_t *__restrict __pglob));
|
204 |
|
|
|
205 |
|
|
extern void globfree64 __P ((glob64_t *__pglob));
|
206 |
|
|
#endif
|
207 |
|
|
|
208 |
|
|
|
209 |
|
|
#ifdef _GNU_SOURCE
|
210 |
|
|
/* Return nonzero if PATTERN contains any metacharacters.
|
211 |
|
|
Metacharacters can be quoted with backslashes if QUOTE is nonzero.
|
212 |
|
|
|
213 |
|
|
This function is not part of the interface specified by POSIX.2
|
214 |
|
|
but several programs want to use it. */
|
215 |
|
|
extern int glob_pattern_p __P ((__const char *__pattern, int __quote));
|
216 |
|
|
#endif
|
217 |
|
|
|
218 |
|
|
#ifdef __cplusplus
|
219 |
|
|
}
|
220 |
|
|
#endif
|
221 |
|
|
|
222 |
|
|
#endif /* glob.h */
|