2 * Copyright (c) 1989, 1993
3 * The Regents of the University of California. All rights reserved.
5 * This code is derived from software contributed to Berkeley by
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
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.
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
33 #if defined(LIBC_SCCS) && !defined(lint)
34 static char sccsid[] = "@(#)glob.c 8.3 (Berkeley) 10/13/93";
35 /* most changes between the version above and the one below have been ported:
36 static char sscsid[]= "$OpenBSD: glob.c,v 1.8.10.1 2001/04/10 jason Exp $";
38 #endif /* LIBC_SCCS and not lint */
41 * glob(3) -- a superset of the one defined in POSIX 1003.2.
43 * The [!...] convention to negate a range is supported (SysV, Posix, ksh).
45 * Optional extra services, controlled by flags not defined by POSIX:
48 * Escaping convention: \ inhibits any special meaning the following
49 * character might have (except \ at end of string is retained).
51 * Set in gl_flags if pattern contained a globbing character.
53 * Same as GLOB_NOCHECK, but it will only append pattern if it did
54 * not contain any magic characters. [Used in csh style globbing]
56 * Use alternately specified directory access functions.
58 * expand ~user/foo to the /home/dir/of/user/foo
60 * expand {1,2}{a,b} to 1a 1b 2a 2b
62 * Number of matches in the current invocation of glob.
64 * sort alphabetically like csh (case doesn't matter) instead of in ASCII
77 struct passwd *getpwnam(char *);
78 struct passwd *getpwuid(Uid_t);
84 # define MAXPATHLEN PATH_MAX
85 # ifdef MACOS_TRADITIONAL
86 # define MAXPATHLEN 255
88 # define MAXPATHLEN 1024
99 # define ARG_MAX (sysconf(_SC_ARG_MAX))
101 # ifdef _POSIX_ARG_MAX
102 # define ARG_MAX _POSIX_ARG_MAX
105 # define ARG_MAX 14500 /* from VC's limits.h */
107 # define ARG_MAX 4096 /* from POSIX, be conservative */
113 #define BG_DOLLAR '$'
116 #define BG_LBRACKET '['
118 #define BG_QUESTION '?'
119 #define BG_QUOTE '\\'
121 #define BG_RBRACKET ']'
122 #ifdef MACOS_TRADITIONAL
132 #define BG_UNDERSCORE '_'
133 #define BG_LBRACE '{'
134 #define BG_RBRACE '}'
140 #define M_QUOTE 0x8000
141 #define M_PROTECT 0x4000
142 #define M_MASK 0xffff
143 #define M_ASCII 0x00ff
150 #define M_PROTECT 0x40
156 #endif /* !GLOB_DEBUG */
159 #define CHAR(c) ((Char)((c)&M_ASCII))
160 #define META(c) ((Char)((c)|M_QUOTE))
161 #define M_ALL META('*')
162 #define M_END META(']')
163 #define M_NOT META('!')
164 #define M_ONE META('?')
165 #define M_RNG META('-')
166 #define M_SET META('[')
167 #define ismeta(c) (((c)&M_QUOTE) != 0)
170 static int compare(const void *, const void *);
171 static int ci_compare(const void *, const void *);
172 static int g_Ctoc(const Char *, char *, STRLEN);
173 static int g_lstat(Char *, Stat_t *, glob_t *);
174 static DIR *g_opendir(Char *, glob_t *);
175 static Char *g_strchr(Char *, int);
176 static int g_stat(Char *, Stat_t *, glob_t *);
177 static int glob0(const Char *, glob_t *);
178 static int glob1(Char *, Char *, glob_t *, size_t *);
179 static int glob2(Char *, Char *, Char *, Char *, Char *, Char *,
181 static int glob3(Char *, Char *, Char *, Char *, Char *, Char *,
182 Char *, Char *, glob_t *, size_t *);
183 static int globextend(const Char *, glob_t *, size_t *);
185 globtilde(const Char *, Char *, size_t, glob_t *);
186 static int globexp1(const Char *, glob_t *);
187 static int globexp2(const Char *, const Char *, glob_t *, int *);
188 static int match(Char *, Char *, Char *, int);
190 static void qprintf(const char *, Char *);
191 #endif /* GLOB_DEBUG */
193 #ifdef PERL_IMPLICIT_CONTEXT
194 static Direntry_t * my_readdir(DIR*);
199 return PerlDir_read(d);
202 #define my_readdir readdir
206 bsd_glob(const char *pattern, int flags,
207 int (*errfunc)(const char *, int), glob_t *pglob)
211 Char *bufnext, *bufend, patbuf[MAXPATHLEN];
213 patnext = (U8 *) pattern;
214 if (!(flags & GLOB_APPEND)) {
216 pglob->gl_pathv = NULL;
217 if (!(flags & GLOB_DOOFFS))
220 pglob->gl_flags = flags & ~GLOB_MAGCHAR;
221 pglob->gl_errfunc = errfunc;
222 pglob->gl_matchc = 0;
225 bufend = bufnext + MAXPATHLEN - 1;
227 /* Nasty hack to treat patterns like "C:*" correctly. In this
228 * case, the * should match any file in the current directory
229 * on the C: drive. However, the glob code does not treat the
230 * colon specially, so it looks for files beginning "C:" in
231 * the current directory. To fix this, change the pattern to
232 * add an explicit "./" at the start (just after the drive
233 * letter and colon - ie change to "C:./*").
235 if (isalpha(pattern[0]) && pattern[1] == ':' &&
236 pattern[2] != BG_SEP && pattern[2] != BG_SEP2 &&
237 bufend - bufnext > 4) {
238 *bufnext++ = pattern[0];
245 if (flags & GLOB_QUOTE) {
246 /* Protect the quoted characters. */
247 while (bufnext < bufend && (c = *patnext++) != BG_EOS)
250 /* To avoid backslashitis on Win32,
251 * we only treat \ as a quoting character
252 * if it precedes one of the
253 * metacharacters []-{}~\
255 if ((c = *patnext++) != '[' && c != ']' &&
256 c != '-' && c != '{' && c != '}' &&
257 c != '~' && c != '\\') {
259 if ((c = *patnext++) == BG_EOS) {
264 *bufnext++ = c | M_PROTECT;
268 while (bufnext < bufend && (c = *patnext++) != BG_EOS)
272 if (flags & GLOB_BRACE)
273 return globexp1(patbuf, pglob);
275 return glob0(patbuf, pglob);
279 * Expand recursively a glob {} pattern. When there is no more expansion
280 * invoke the standard globbing routine to glob the rest of the magic
284 globexp1(const Char *pattern, glob_t *pglob)
286 const Char* ptr = pattern;
289 /* Protect a single {}, for find(1), like csh */
290 if (pattern[0] == BG_LBRACE && pattern[1] == BG_RBRACE && pattern[2] == BG_EOS)
291 return glob0(pattern, pglob);
293 while ((ptr = (const Char *) g_strchr((Char *) ptr, BG_LBRACE)) != NULL)
294 if (!globexp2(ptr, pattern, pglob, &rv))
297 return glob0(pattern, pglob);
302 * Recursive brace globbing helper. Tries to expand a single brace.
303 * If it succeeds then it invokes globexp1 with the new pattern.
304 * If it fails then it tries to glob the rest of the pattern and returns.
307 globexp2(const Char *ptr, const Char *pattern,
308 glob_t *pglob, int *rv)
312 const Char *pe, *pm, *pl;
313 Char patbuf[MAXPATHLEN];
315 /* copy part up to the brace */
316 for (lm = patbuf, pm = pattern; pm != ptr; *lm++ = *pm++)
321 /* Find the balanced brace */
322 for (i = 0, pe = ++ptr; *pe; pe++)
323 if (*pe == BG_LBRACKET) {
324 /* Ignore everything between [] */
325 for (pm = pe++; *pe != BG_RBRACKET && *pe != BG_EOS; pe++)
329 * We could not find a matching BG_RBRACKET.
330 * Ignore and just look for BG_RBRACE
334 } else if (*pe == BG_LBRACE)
336 else if (*pe == BG_RBRACE) {
342 /* Non matching braces; just glob the pattern */
343 if (i != 0 || *pe == BG_EOS) {
344 *rv = glob0(patbuf, pglob);
348 for (i = 0, pl = pm = ptr; pm <= pe; pm++) {
351 /* Ignore everything between [] */
352 for (pl = pm++; *pm != BG_RBRACKET && *pm != BG_EOS; pm++)
356 * We could not find a matching BG_RBRACKET.
357 * Ignore and just look for BG_RBRACE
374 if (i && *pm == BG_COMMA)
377 /* Append the current string */
378 for (lm = ls; (pl < pm); *lm++ = *pl++)
382 * Append the rest of the pattern after the
385 for (pl = pe + 1; (*lm++ = *pl++) != BG_EOS; )
388 /* Expand the current pattern */
390 qprintf("globexp2:", patbuf);
391 #endif /* GLOB_DEBUG */
392 *rv = globexp1(patbuf, pglob);
394 /* move after the comma, to the next string */
410 * expand tilde from the passwd file.
413 globtilde(const Char *pattern, Char *patbuf, size_t patbuf_len, glob_t *pglob)
420 if (*pattern != BG_TILDE || !(pglob->gl_flags & GLOB_TILDE))
423 /* Copy up to the end of the string or / */
424 eb = &patbuf[patbuf_len - 1];
425 for (p = pattern + 1, h = (char *) patbuf;
426 h < (char*)eb && *p && *p != BG_SLASH; *h++ = *p++)
436 if (((char *) patbuf)[0] == BG_EOS) {
438 * handle a plain ~ or ~/ by expanding $HOME
439 * first and then trying the password file
441 if ((h = getenv("HOME")) == NULL) {
443 if ((pwd = getpwuid(getuid())) == NULL)
456 if ((pwd = getpwnam((char*) patbuf)) == NULL)
465 /* Copy the home directory */
466 for (b = patbuf; b < eb && *h; *b++ = *h++)
469 /* Append the rest of the pattern */
470 while (b < eb && (*b++ = *p++) != BG_EOS)
479 * The main glob() routine: compiles the pattern (optionally processing
480 * quotes), calls glob1() to do the real pattern matching, and finally
481 * sorts the list (unless unsorted operation is requested). Returns 0
482 * if things went well, nonzero if errors occurred. It is not an error
483 * to find no matches.
486 glob0(const Char *pattern, glob_t *pglob)
488 const Char *qpat, *qpatnext;
489 int c, err, oldflags, oldpathc;
490 Char *bufnext, patbuf[MAXPATHLEN];
493 #ifdef MACOS_TRADITIONAL
494 if ( (*pattern == BG_TILDE) && (pglob->gl_flags & GLOB_TILDE) ) {
495 return(globextend(pattern, pglob));
499 qpat = globtilde(pattern, patbuf, MAXPATHLEN, pglob);
501 oldflags = pglob->gl_flags;
502 oldpathc = pglob->gl_pathc;
505 /* We don't need to check for buffer overflow any more. */
506 while ((c = *qpatnext++) != BG_EOS) {
512 if (*qpatnext == BG_EOS ||
513 g_strchr((Char *) qpatnext+1, BG_RBRACKET) == NULL) {
514 *bufnext++ = BG_LBRACKET;
524 *bufnext++ = CHAR(c);
525 if (*qpatnext == BG_RANGE &&
526 (c = qpatnext[1]) != BG_RBRACKET) {
528 *bufnext++ = CHAR(c);
531 } while ((c = *qpatnext++) != BG_RBRACKET);
532 pglob->gl_flags |= GLOB_MAGCHAR;
536 pglob->gl_flags |= GLOB_MAGCHAR;
540 pglob->gl_flags |= GLOB_MAGCHAR;
541 /* collapse adjacent stars to one,
542 * to avoid exponential behavior
544 if (bufnext == patbuf || bufnext[-1] != M_ALL)
548 *bufnext++ = CHAR(c);
554 qprintf("glob0:", patbuf);
555 #endif /* GLOB_DEBUG */
557 if ((err = glob1(patbuf, patbuf+MAXPATHLEN-1, pglob, &limit)) != 0) {
558 pglob->gl_flags = oldflags;
563 * If there was no match we are going to append the pattern
564 * if GLOB_NOCHECK was specified or if GLOB_NOMAGIC was specified
565 * and the pattern did not contain any magic characters
566 * GLOB_NOMAGIC is there just for compatibility with csh.
568 if (pglob->gl_pathc == oldpathc &&
569 ((pglob->gl_flags & GLOB_NOCHECK) ||
570 ((pglob->gl_flags & GLOB_NOMAGIC) &&
571 !(pglob->gl_flags & GLOB_MAGCHAR))))
574 printf("calling globextend from glob0\n");
575 #endif /* GLOB_DEBUG */
576 pglob->gl_flags = oldflags;
577 return(globextend(qpat, pglob, &limit));
579 else if (!(pglob->gl_flags & GLOB_NOSORT))
580 qsort(pglob->gl_pathv + pglob->gl_offs + oldpathc,
581 pglob->gl_pathc - oldpathc, sizeof(char *),
582 (pglob->gl_flags & (GLOB_ALPHASORT|GLOB_NOCASE))
583 ? ci_compare : compare);
584 pglob->gl_flags = oldflags;
589 ci_compare(const void *p, const void *q)
591 const char *pp = *(const char **)p;
592 const char *qq = *(const char **)q;
595 if (tolower(*pp) != tolower(*qq))
600 ci = tolower(*pp) - tolower(*qq);
602 return compare(p, q);
607 compare(const void *p, const void *q)
609 return(strcmp(*(char **)p, *(char **)q));
613 glob1(Char *pattern, Char *pattern_last, glob_t *pglob, size_t *limitp)
615 Char pathbuf[MAXPATHLEN];
617 /* A null pathname is invalid -- POSIX 1003.1 sect. 2.4. */
618 if (*pattern == BG_EOS)
620 return(glob2(pathbuf, pathbuf+MAXPATHLEN-1,
621 pathbuf, pathbuf+MAXPATHLEN-1,
622 pattern, pattern_last, pglob, limitp));
626 * The functions glob2 and glob3 are mutually recursive; there is one level
627 * of recursion for each segment in the pattern that contains one or more
631 glob2(Char *pathbuf, Char *pathbuf_last, Char *pathend, Char *pathend_last,
632 Char *pattern, Char *pattern_last, glob_t *pglob, size_t *limitp)
639 * Loop over pattern segments until end of pattern or until
640 * segment with meta character found.
642 for (anymeta = 0;;) {
643 if (*pattern == BG_EOS) { /* End of pattern? */
645 if (g_lstat(pathbuf, &sb, pglob))
648 if (((pglob->gl_flags & GLOB_MARK) &&
649 pathend[-1] != BG_SEP
651 && pathend[-1] != BG_SEP2
653 ) && (S_ISDIR(sb.st_mode) ||
654 (S_ISLNK(sb.st_mode) &&
655 (g_stat(pathbuf, &sb, pglob) == 0) &&
656 S_ISDIR(sb.st_mode)))) {
657 if (pathend+1 > pathend_last)
664 printf("calling globextend from glob2\n");
665 #endif /* GLOB_DEBUG */
666 return(globextend(pathbuf, pglob, limitp));
669 /* Find end of next segment, copy tentatively to pathend. */
672 while (*p != BG_EOS && *p != BG_SEP
679 if (q+1 > pathend_last)
684 if (!anymeta) { /* No expansion, do next segment. */
687 while (*pattern == BG_SEP
689 || *pattern == BG_SEP2
692 if (pathend+1 > pathend_last)
694 *pathend++ = *pattern++;
697 /* Need expansion, recurse. */
698 return(glob3(pathbuf, pathbuf_last, pathend,
699 pathend_last, pattern, pattern_last,
700 p, pattern_last, pglob, limitp));
706 glob3(Char *pathbuf, Char *pathbuf_last, Char *pathend, Char *pathend_last,
707 Char *pattern, Char *pattern_last,
708 Char *restpattern, Char *restpattern_last, glob_t *pglob, size_t *limitp)
710 register Direntry_t *dp;
714 char buf[MAXPATHLEN];
717 * The readdirfunc declaration can't be prototyped, because it is
718 * assigned, below, to two functions which are prototyped in glob.h
719 * and dirent.h as taking pointers to differently typed opaque
722 Direntry_t *(*readdirfunc)(DIR*);
724 if (pathend > pathend_last)
732 if (q - pathbuf > 5) {
735 tolower(q[1]) == 'd' && tolower(q[2]) == 'i' &&
736 tolower(q[3]) == 'r' && q[4] == '/')
745 if ((dirp = g_opendir(pathbuf, pglob)) == NULL) {
746 /* TODO: don't call for ENOENT or ENOTDIR? */
747 if (pglob->gl_errfunc) {
748 if (g_Ctoc(pathbuf, buf, sizeof(buf)))
750 if (pglob->gl_errfunc(buf, errno) ||
751 (pglob->gl_flags & GLOB_ERR))
758 nocase = ((pglob->gl_flags & GLOB_NOCASE) != 0);
760 /* Search directory for matching names. */
761 if (pglob->gl_flags & GLOB_ALTDIRFUNC)
762 readdirfunc = (Direntry_t *(*)(DIR *))pglob->gl_readdir;
764 readdirfunc = my_readdir;
765 while ((dp = (*readdirfunc)(dirp))) {
769 /* Initial BG_DOT must be matched literally. */
770 if (dp->d_name[0] == BG_DOT && *pattern != BG_DOT)
773 sc = (U8 *) dp->d_name;
774 while (dc < pathend_last && (*dc++ = *sc++) != BG_EOS)
776 if (dc >= pathend_last) {
782 if (!match(pathend, pattern, restpattern, nocase)) {
786 err = glob2(pathbuf, pathbuf_last, --dc, pathend_last,
787 restpattern, restpattern_last, pglob, limitp);
792 if (pglob->gl_flags & GLOB_ALTDIRFUNC)
793 (*pglob->gl_closedir)(dirp);
801 * Extend the gl_pathv member of a glob_t structure to accomodate a new item,
802 * add the new item, and update gl_pathc.
804 * This assumes the BSD realloc, which only copies the block when its size
805 * crosses a power-of-two boundary; for v7 realloc, this would cause quadratic
808 * Return 0 if new item added, error code if memory couldn't be allocated.
810 * Invariant of the glob_t structure:
811 * Either gl_pathc is zero and gl_pathv is NULL; or gl_pathc > 0 and
812 * gl_pathv points to (gl_offs + gl_pathc + 1) items.
815 globextend(const Char *path, glob_t *pglob, size_t *limitp)
817 register char **pathv;
825 for (p = path; *p; p++)
826 (void)printf("%c", CHAR(*p));
828 #endif /* GLOB_DEBUG */
830 newsize = sizeof(*pathv) * (2 + pglob->gl_pathc + pglob->gl_offs);
832 pathv = Renew(pglob->gl_pathv,newsize,char*);
834 New(0,pathv,newsize,char*);
836 if (pglob->gl_pathv) {
837 Safefree(pglob->gl_pathv);
838 pglob->gl_pathv = NULL;
840 return(GLOB_NOSPACE);
843 if (pglob->gl_pathv == NULL && pglob->gl_offs > 0) {
844 /* first time around -- clear initial gl_offs items */
845 pathv += pglob->gl_offs;
846 for (i = pglob->gl_offs; --i >= 0; )
849 pglob->gl_pathv = pathv;
851 for (p = path; *p++;)
853 len = (STRLEN)(p - path);
855 New(0, copy, p-path, char);
857 if (g_Ctoc(path, copy, len)) {
859 return(GLOB_NOSPACE);
861 pathv[pglob->gl_offs + pglob->gl_pathc++] = copy;
863 pathv[pglob->gl_offs + pglob->gl_pathc] = NULL;
865 if ((pglob->gl_flags & GLOB_LIMIT) &&
866 newsize + *limitp >= ARG_MAX) {
868 return(GLOB_NOSPACE);
871 return(copy == NULL ? GLOB_NOSPACE : 0);
876 * pattern matching function for filenames. Each occurrence of the *
877 * pattern causes a recursion level.
880 match(register Char *name, register Char *pat, register Char *patend, int nocase)
882 int ok, negate_range;
885 while (pat < patend) {
887 switch (c & M_MASK) {
892 if (match(name, pat, patend, nocase))
894 while (*name++ != BG_EOS)
898 if (*name++ == BG_EOS)
903 if ((k = *name++) == BG_EOS)
905 if ((negate_range = ((*pat & M_MASK) == M_NOT)) != BG_EOS)
907 while (((c = *pat++) & M_MASK) != M_END)
908 if ((*pat & M_MASK) == M_RNG) {
910 if (tolower(c) <= tolower(k) && tolower(k) <= tolower(pat[1]))
913 if (c <= k && k <= pat[1])
917 } else if (nocase ? (tolower(c) == tolower(k)) : (c == k))
919 if (ok == negate_range)
924 if (nocase ? (tolower(k) != tolower(c)) : (k != c))
929 return(*name == BG_EOS);
932 /* Free allocated data belonging to a glob_t structure. */
934 bsd_globfree(glob_t *pglob)
939 if (pglob->gl_pathv != NULL) {
940 pp = pglob->gl_pathv + pglob->gl_offs;
941 for (i = pglob->gl_pathc; i--; ++pp)
944 Safefree(pglob->gl_pathv);
945 pglob->gl_pathv = NULL;
950 g_opendir(register Char *str, glob_t *pglob)
952 char buf[MAXPATHLEN];
955 #ifdef MACOS_TRADITIONAL
961 if (g_Ctoc(str, buf, sizeof(buf)))
965 if (pglob->gl_flags & GLOB_ALTDIRFUNC)
966 return((*pglob->gl_opendir)(buf));
968 return(PerlDir_open(buf));
972 g_lstat(register Char *fn, Stat_t *sb, glob_t *pglob)
974 char buf[MAXPATHLEN];
976 if (g_Ctoc(fn, buf, sizeof(buf)))
978 if (pglob->gl_flags & GLOB_ALTDIRFUNC)
979 return((*pglob->gl_lstat)(buf, sb));
981 return(PerlLIO_lstat(buf, sb));
983 return(PerlLIO_stat(buf, sb));
984 #endif /* HAS_LSTAT */
988 g_stat(register Char *fn, Stat_t *sb, glob_t *pglob)
990 char buf[MAXPATHLEN];
992 if (g_Ctoc(fn, buf, sizeof(buf)))
994 if (pglob->gl_flags & GLOB_ALTDIRFUNC)
995 return((*pglob->gl_stat)(buf, sb));
996 return(PerlLIO_stat(buf, sb));
1000 g_strchr(Char *str, int ch)
1010 g_Ctoc(register const Char *str, char *buf, STRLEN len)
1013 if ((*buf++ = *str++) == BG_EOS)
1021 qprintf(const char *str, register Char *s)
1025 (void)printf("%s:\n", str);
1026 for (p = s; *p; p++)
1027 (void)printf("%c", CHAR(*p));
1029 for (p = s; *p; p++)
1030 (void)printf("%c", *p & M_PROTECT ? '"' : ' ');
1032 for (p = s; *p; p++)
1033 (void)printf("%c", ismeta(*p) ? '_' : ' ');
1036 #endif /* GLOB_DEBUG */