NAME

       gfs_glob - find path names matching a pattern

SYNOPSIS

       #include <gfarm/gfarm.h>

       char *gfs_glob (const char * pattern, gfarm_stringlist * paths, gfs_glob_t * types);

DESCRIPTION

       gfs_glob()  searches  for  all  the  path names matching pattern that may include a wildcard, and returns
       paths.

       The returned path names are accessed by gfarm_stringlist_length(3) and gfarm_stringlist_elem(3).

       It is necessary to allocate memory space dynamically pointed to by types  using  gfs_glob_init(3)  before
       calling gfs_glob(3).  The allocated memory space needs to be free'ed by gfs_glob_free(3).

RETURN VALUES

       NULL   The function terminated successfully.

       GFARM_ERR_NO_MEMORY
              Insufficient memory was available.

       GFARM_ERR_PATHNAME_TOO_LONG
              Too long pattern or path name to process.

       Others An error except the above occurred.  The reason is shown by its pointed strings.

SEE ALSO

       gfs_glob_init(3)        gfs_glob_free(3)        gfarm_stringlist_init(3)       gfarm_stringlist_length(3)
       gfarm_stringlist_elem(3) gfarm_stringlist_free(3) gfarm_stringlist_free_deeply(3)

Gfarm                                           30 September 2003                                    GFS_GLOB(3)