NAME

glob.h - pathname pattern-matching types

SYNOPSIS

#include <glob.h>

DESCRIPTION

The <glob.h> header defines the structures and symbolic constants used by the glob() function.

The structure type contains at least the following members:

size_t   gl_pathc count of paths matched by pattern
char   **gl_pathv pointer to a list of matched pathnames
size_t   gl_offs  slots to reserve at the beginning of gl_pathv

The following constants are provided as values for the flags argument:

GLOB_APPEND

Append generated pathnames to those previously obtained.

GLOB_DOOFFS

Specify how many null pointers to add to the beginning of

GLOB_ERR

Cause glob() to return on error.

GLOB_MARK

Each pathname that is a directory that matches pattern has a slash appended.

GLOB_NOCHECK

If pattern does not match any pathname, then return a list consisting of only pattern.

GLOB_NOESCAPE

Disable backslash escaping.

GLOB_NOSORT

Do not sort the pathnames returned.

The following constants are defined as error return values:

GLOB_ABORTED

The scan was stopped because GLOB_ERR was set or returned non-zero.

GLOB_NOMATCH

The pattern does not match any existing pathname, and GLOB_NOCHECK was not set in flags.

GLOB_NOSPACE

An attempt to allocate memory failed.

GLOB_NOSYS

The implementation does not support this function.

The following are declared as functions and may also be declared as macros. Function prototypes must be provided for use with an ISO C compiler.

int  glob(const char *, int,
    int (*)(const char *, int), glob_t *);
void globfree (glob_t *);

The implementation may define additional macros or constants using names beginning with GLOB_.

APPLICATION USAGE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

glob(), the XCU specification.