2
* Copyright (c) 2008, 2010 Todd C. Miller <Todd.Miller@courtesan.com>
3
* Copyright (c) 1989, 1993, 1994
4
* The Regents of the University of California. All rights reserved.
6
* This code is derived from software contributed to Berkeley by
1
/* $OpenBSD: fnmatch.c,v 1.15 2011/02/10 21:31:59 stsp Exp $ */
3
/* Copyright (c) 2011, VMware, Inc.
9
6
* Redistribution and use in source and binary forms, with or without
10
* modification, are permitted provided that the following conditions
12
* 1. Redistributions of source code must retain the above copyright
13
* notice, this list of conditions and the following disclaimer.
14
* 2. Redistributions in binary form must reproduce the above copyright
15
* notice, this list of conditions and the following disclaimer in the
16
* documentation and/or other materials provided with the distribution.
17
* 3. Neither the name of the University nor the names of its contributors
18
* may be used to endorse or promote products derived from this software
19
* without specific prior written permission.
21
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
7
* modification, are permitted provided that the following conditions are met:
8
* * Redistributions of source code must retain the above copyright
9
* notice, this list of conditions and the following disclaimer.
10
* * Redistributions in binary form must reproduce the above copyright
11
* notice, this list of conditions and the following disclaimer in the
12
* documentation and/or other materials provided with the distribution.
13
* * Neither the name of the VMware, Inc. nor the names of its contributors
14
* may be used to endorse or promote products derived from this software
15
* without specific prior written permission.
17
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
18
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23
19
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
20
* ARE DISCLAIMED. IN NO EVENT SHALL VMWARE, INC. OR CONTRIBUTORS BE LIABLE FOR
21
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
24
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35
* Function fnmatch() as specified in POSIX 1003.2-1992, section B.6.
36
* Compares a filename or pathname to a pattern.
29
/* Authored by William A. Rowe Jr. <wrowe; apache.org, vmware.com>, April 2011
31
* Derived from The Open Group Base Specifications Issue 7, IEEE Std 1003.1-2008
33
* http://pubs.opengroup.org/onlinepubs/9699919799/functions/fnmatch.html
35
* Filename pattern matches defined in section 2.13, "Pattern Matching Notation"
36
* from chapter 2. "Shell Command Language"
37
* http://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_13
38
* where; 1. A bracket expression starting with an unquoted <circumflex> '^'
39
* character CONTINUES to specify a non-matching list; 2. an explicit <period> '.'
40
* in a bracket expression matching list, e.g. "[.abc]" does NOT match a leading
41
* <period> in a filename; 3. a <left-square-bracket> '[' which does not introduce
42
* a valid bracket expression is treated as an ordinary character; 4. a differing
43
* number of consecutive slashes within pattern and string will NOT match;
44
* 5. a trailing '\' in FNM_ESCAPE mode is treated as an ordinary '\' character.
46
* Bracket expansion defined in section 9.3.5, "RE Bracket Expression",
47
* from chapter 9, "Regular Expressions"
48
* http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_03_05
49
* with no support for collating symbols, equivalence class expressions or
50
* character class expressions. A partial range expression with a leading
51
* hyphen following a valid range expression will match only the ordinary
52
* <hyphen> and the ending character (e.g. "[a-m-z]" will match characters
53
* 'a' through 'm', a <hyphen> '-', or a 'z').
55
* Supports BSD extensions FNM_LEADING_DIR to match pattern to the end of one
56
* path segment of string, and FNM_CASEFOLD to ignore alpha case.
58
* NOTE: Only POSIX/C single byte locales are correctly supported at this time.
59
* Notably, non-POSIX locales with FNM_CASEFOLD produce undefined results,
60
* particularly in ranges of mixed case (e.g. "[A-z]") or spanning alpha and
61
* nonalpha characters within a range.
63
* XXX comments below indicate porting required for multi-byte character sets
64
* and non-POSIX locale collation orders; requires mbr* APIs to track shift
65
* state of pattern and string (rewinding pattern and string repeatedly).
67
* Certain parts of the code assume 0x00-0x3F are unique with any MBCS (e.g.
68
* UTF-8, SHIFT-JIS, etc). Any implementation allowing '\' as an alternate
69
* path delimiter must be aware that 0x5C is NOT unique within SHIFT-JIS.
39
72
#include <config.h>
48
81
#ifdef HAVE_STRINGS_H
49
82
# include <strings.h>
50
83
#endif /* HAVE_STRINGS_H */
52
86
#include "missing.h"
53
87
#include "compat/charclass.h"
54
88
#include "compat/fnmatch.h"
59
90
#define RANGE_MATCH 1
60
91
#define RANGE_NOMATCH 0
61
92
#define RANGE_ERROR (-1)
63
#if defined(LIBC_SCCS) && !defined(lint)
64
__unused static const char rcsid[] = "$OpenBSD: fnmatch.c,v 1.6 1998/03/19 00:29:59 millert Exp $";
65
#endif /* LIBC_SCCS and not lint */
67
static int rangematch(const char *, int, int, char **);
68
static int classmatch(const char *, int, int, const char **);
71
rpl_fnmatch(const char *pattern, const char *string, int flags)
73
const char *stringstart;
77
for (stringstart = string;;)
78
switch (c = *pattern++) {
80
if (ISSET(flags, FNM_LEADING_DIR) && *string == '/')
82
return *string == EOS ? 0 : FNM_NOMATCH;
86
if (*string == '/' && ISSET(flags, FNM_PATHNAME))
88
if (*string == '.' && ISSET(flags, FNM_PERIOD) &&
89
(string == stringstart ||
90
(ISSET(flags, FNM_PATHNAME) && *(string - 1) == '/')))
96
/* Collapse multiple stars. */
100
if (*string == '.' && ISSET(flags, FNM_PERIOD) &&
101
(string == stringstart ||
102
(ISSET(flags, FNM_PATHNAME) && *(string - 1) == '/')))
105
/* Optimize for pattern with * at end or before /. */
107
if (ISSET(flags, FNM_PATHNAME))
108
return (ISSET(flags, FNM_LEADING_DIR) ||
109
strchr(string, '/') == NULL ?
113
} else if (c == '/' && ISSET(flags, FNM_PATHNAME)) {
114
if ((string = strchr(string, '/')) == NULL)
119
/* General case, use recursion. */
120
while ((test = *string) != EOS) {
121
if (!fnmatch(pattern, string, flags & ~FNM_PERIOD))
123
if (test == '/' && ISSET(flags, FNM_PATHNAME))
131
if (*string == '/' && ISSET(flags, FNM_PATHNAME))
133
if (*string == '.' && ISSET(flags, FNM_PERIOD) &&
134
(string == stringstart ||
135
(ISSET(flags, FNM_PATHNAME) && *(string - 1) == '/')))
138
switch (rangematch(pattern, *string, flags, &newp)) {
140
/* not a good range, treat as normal text */
151
if (!ISSET(flags, FNM_NOESCAPE)) {
152
if ((c = *pattern++) == EOS) {
160
if (c != *string && !(ISSET(flags, FNM_CASEFOLD) &&
161
(tolower((unsigned char)c) ==
162
tolower((unsigned char)*string))))
171
rangematch(const char *pattern, int test, int flags, char **newp)
177
* A bracket expression starting with an unquoted circumflex
178
* character produces unspecified results (IEEE 1003.2-1992,
179
* 3.13.2). This implementation treats it like '!', for
180
* consistency with the regular expression syntax.
181
* J.T. Conklin (conklin@ngai.kaleida.com)
183
if ((negate = (*pattern == '!' || *pattern == '^')))
186
if (ISSET(flags, FNM_CASEFOLD))
187
test = tolower(test);
190
* A right bracket shall lose its special meaning and represent
191
* itself in a bracket expression if it occurs first in the list.
197
if (c == '[' && *pattern == ':') {
199
rv = classmatch(pattern + 1, test,
200
(flags & FNM_CASEFOLD), &pattern);
201
if (rv == RANGE_MATCH)
204
} while (rv != RANGE_ERROR && c == '[' && *pattern == ':');
208
if (c == '\\' && !ISSET(flags, FNM_NOESCAPE))
212
if (c == '/' && ISSET(flags, FNM_PATHNAME))
213
return RANGE_NOMATCH;
214
if (ISSET(flags, FNM_CASEFOLD))
215
c = tolower((unsigned char)c);
217
&& (c2 = *(pattern+1)) != EOS && c2 != ']') {
219
if (c2 == '\\' && !ISSET(flags, FNM_NOESCAPE))
223
if (ISSET(flags, FNM_CASEFOLD))
224
c2 = tolower((unsigned char)c2);
225
if (c <= test && test <= c2)
227
} else if (c == test)
229
} while ((c = *pattern++) != ']');
231
*newp = (char *)pattern;
232
return ok == negate ? RANGE_NOMATCH : RANGE_MATCH;
236
classmatch(const char *pattern, int test, int foldcase, const char **ep)
95
classmatch(const char *pattern, char test, int foldcase, const char **ep)
97
const char * const mismatch = pattern;
238
99
struct cclass *cc;
100
int rval = RANGE_NOMATCH;
241
int rval = RANGE_NOMATCH;
103
if (pattern[0] != '[' || pattern[1] != ':') {
243
109
if ((colon = strchr(pattern, ':')) == NULL || colon[1] != ']') {
245
111
return RANGE_ERROR;
251
117
pattern = "lower:]";
252
118
for (cc = cclasses; cc->name != NULL; cc++) {
253
119
if (!strncmp(pattern, cc->name, len) && cc->name[len] == '\0') {
254
if (cc->isctype(test))
120
if (cc->isctype((unsigned char)test))
255
121
rval = RANGE_MATCH;
259
125
if (cc->name == NULL) {
260
/* invalid character class, return EOS */
261
*ep = colon + strlen(colon);
126
/* invalid character class, treat as normal text */
262
128
rval = RANGE_ERROR;
133
/* Most MBCS/collation/case issues handled here. Wildcard '*' is not handled.
134
* EOS '\0' and the FNM_PATHNAME '/' delimiters are not advanced over,
135
* however the "\/" sequence is advanced to '/'.
137
* Both pattern and string are **char to support pointer increment of arbitrary
138
* multibyte characters for the given locale, in a later iteration of this code
140
static int fnmatch_ch(const char **pattern, const char **string, int flags)
142
const char * const mismatch = *pattern;
143
const int nocase = !!(flags & FNM_CASEFOLD);
144
const int escape = !(flags & FNM_NOESCAPE);
145
const int slash = !!(flags & FNM_PATHNAME);
146
int result = FNM_NOMATCH;
150
if (**pattern == '[')
154
/* Handle negation, either leading ! or ^ operators (never both) */
155
negate = ((**pattern == '!') || (**pattern == '^'));
159
/* ']' is an ordinary character at the start of the range pattern */
160
if (**pattern == ']')
161
goto leadingclosebrace;
165
if (**pattern == ']') {
167
/* XXX: Fix for MBCS character width */
169
return (result ^ negate);
172
if (escape && (**pattern == '\\')) {
175
/* Patterns must be terminated with ']', not EOS */
180
/* Patterns must be terminated with ']' not '/' */
181
if (slash && (**pattern == '/'))
184
/* Match character classes. */
185
if (classmatch(*pattern, **string, nocase, pattern)
192
/* Look at only well-formed range patterns;
193
* "x-]" is not allowed unless escaped ("x-\]")
194
* XXX: Fix for locale/MBCS character width
196
if (((*pattern)[1] == '-') && ((*pattern)[2] != ']'))
199
*pattern += (escape && ((*pattern)[2] == '\\')) ? 3 : 2;
201
/* NOT a properly balanced [expr] pattern, EOS terminated
202
* or ranges containing a slash in FNM_PATHNAME mode pattern
203
* fall out to to the rewind and test '[' literal code path
205
if (!**pattern || (slash && (**pattern == '/')))
208
/* XXX: handle locale/MBCS comparison, advance by MBCS char width */
209
if ((**string >= *startch) && (**string <= **pattern))
211
else if (nocase && (isupper((unsigned char)**string) ||
212
isupper((unsigned char)*startch) ||
213
isupper((unsigned char)**pattern))
214
&& (tolower((unsigned char)**string) >= tolower((unsigned char)*startch))
215
&& (tolower((unsigned char)**string) <= tolower((unsigned char)**pattern)))
222
/* XXX: handle locale/MBCS comparison, advance by MBCS char width */
223
if ((**string == **pattern))
225
else if (nocase && (isupper((unsigned char)**string) ||
226
isupper((unsigned char)**pattern))
227
&& (tolower((unsigned char)**string) == tolower((unsigned char)**pattern)))
233
/* NOT a properly balanced [expr] pattern; Rewind
234
* and reset result to test '[' literal
237
result = FNM_NOMATCH;
239
else if (**pattern == '?') {
240
/* Optimize '?' match before unescaping **pattern */
241
if (!**string || (slash && (**string == '/')))
244
goto fnmatch_ch_success;
246
else if (escape && (**pattern == '\\') && (*pattern)[1]) {
250
/* XXX: handle locale/MBCS comparison, advance by the MBCS char width */
251
if (**string == **pattern)
253
else if (nocase && (isupper((unsigned char)**string) || isupper((unsigned char)**pattern))
254
&& (tolower((unsigned char)**string) == tolower((unsigned char)**pattern)))
257
/* Refuse to advance over trailing slash or nulls
259
if (!**string || !**pattern || (slash && ((**string == '/') || (**pattern == '/'))))
268
int rpl_fnmatch(const char *pattern, const char *string, int flags)
270
static const char dummystring[2] = {' ', 0};
271
const int escape = !(flags & FNM_NOESCAPE);
272
const int slash = !!(flags & FNM_PATHNAME);
273
const int leading_dir = !!(flags & FNM_LEADING_DIR);
274
const char *strendseg;
275
const char *dummyptr;
276
const char *matchptr;
278
/* For '*' wild processing only; surpress 'used before initialization'
279
* warnings with dummy initialization values;
281
const char *strstartseg = NULL;
282
const char *mismatch = NULL;
285
if (strlen(pattern) > PATH_MAX || strlen(string) > PATH_MAX)
291
while (*pattern && *string)
293
/* Pre-decode "\/" which has no special significance, and
294
* match balanced slashes, starting a new segment pattern
296
if (slash && escape && (*pattern == '\\') && (pattern[1] == '/'))
298
if (slash && (*pattern == '/') && (*string == '/')) {
304
/* At the beginning of each segment, validate leading period behavior.
306
if ((flags & FNM_PERIOD) && (*string == '.'))
310
else if (escape && (*pattern == '\\') && (pattern[1] == '.'))
317
/* Determine the end of string segment
319
* Presumes '/' character is unique, not composite in any MBCS encoding
322
strendseg = strchr(string, '/');
324
strendseg = strchr(string, '\0');
327
strendseg = strchr(string, '\0');
330
/* Allow pattern '*' to be consumed even with no remaining string to match
334
if ((string > strendseg)
335
|| ((string == strendseg) && (*pattern != '*')))
338
if (slash && ((*pattern == '/')
339
|| (escape && (*pattern == '\\')
340
&& (pattern[1] == '/'))))
343
/* Reduce groups of '*' and '?' to n '?' matches
344
* followed by one '*' test for simplicity
346
for (wild = 0; ((*pattern == '*') || (*pattern == '?')); ++pattern)
348
if (*pattern == '*') {
351
else if (string < strendseg) { /* && (*pattern == '?') */
352
/* XXX: Advance 1 char for MBCS locale */
355
else { /* (string >= strendseg) && (*pattern == '?') */
362
strstartseg = string;
365
/* Count fixed (non '*') char matches remaining in pattern
366
* excluding '/' (or "\/") and '*'
368
for (matchptr = pattern, matchlen = 0; 1; ++matchlen)
370
if ((*matchptr == '\0')
371
|| (slash && ((*matchptr == '/')
372
|| (escape && (*matchptr == '\\')
373
&& (matchptr[1] == '/')))))
375
/* Compare precisely this many trailing string chars,
376
* the resulting match needs no wildcard loop
378
/* XXX: Adjust for MBCS */
379
if (string + matchlen > strendseg)
382
string = strendseg - matchlen;
387
if (*matchptr == '*')
389
/* Ensure at least this many trailing string chars remain
390
* for the first comparison
392
/* XXX: Adjust for MBCS */
393
if (string + matchlen > strendseg)
396
/* Begin first wild comparison at the current position */
400
/* Skip forward in pattern by a single character match
401
* Use a dummy fnmatch_ch() test to count one "[range]" escape
403
/* XXX: Adjust for MBCS */
404
if (escape && (*matchptr == '\\') && matchptr[1]) {
407
else if (*matchptr == '[') {
408
dummyptr = dummystring;
409
fnmatch_ch(&matchptr, &dummyptr, flags);
417
/* Incrementally match string against the pattern
419
while (*pattern && (string < strendseg))
421
/* Success; begin a new wild pattern search
426
if (slash && ((*string == '/')
428
|| (escape && (*pattern == '\\')
429
&& (pattern[1] == '/'))))
432
/* Compare ch's (the pattern is advanced over "\/" to the '/',
433
* but slashes will mismatch, and are not consumed)
435
if (!fnmatch_ch(&pattern, &string, flags))
438
/* Failed to match, loop against next char offset of string segment
439
* until not enough string chars remain to match the fixed pattern
442
/* XXX: Advance 1 char for MBCS locale */
443
string = ++strstartseg;
444
if (string + matchlen > strendseg)
455
if (*string && !((slash || leading_dir) && (*string == '/')))
458
if (*pattern && !(slash && ((*pattern == '/')
459
|| (escape && (*pattern == '\\')
460
&& (pattern[1] == '/')))))
463
if (leading_dir && !*pattern && *string == '/')
467
/* Where both pattern and string are at EOS, declare success
469
if (!*string && !*pattern)
472
/* pattern didn't match to the end of string */