Man Linux: Main Page and Category List

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)