Linux Standard Base Core Specification 2.1
<<< PreviousNext >>>

glob64

Name

glob64 -- find pathnames matching a pattern (Large File Support)

Synopsis

#include <glob.h>

int glob64(const char * pattern, int flags, int (*errfunc) (const char *, int), glob64_t * pglob);

Description

The glob64() function is a large-file version of the glob() defined in ISO POSIX (2003). It shall search for pathnames matching pattern according to the rules used by the shell, /bin/sh. No tilde expansion or parameter substitution is done; see wordexp().

The results of a glob64() call are stored in the structure pointed to by pglob, which is a glob64_t declared in glob.h with the following members: 

typedef struct
{
  size_t gl_pathc;
  char **gl_pathv;
  size_t gl_offs;
  int gl_flags;
  void (*gl_closedir) (void *);
  struct dirent64 *(*gl_readdir64) (void *);
  void *(*gl_opendir) (const char *);
  int (*gl_lstat) (const char *, struct stat *);
  int (*gl_stat) (const char *, struct stat *);
}
glob64_t;

Structure members with the same name as corresponding members of a glob_t as defined in ISO POSIX (2003) shall have the same purpose.

Other members are defined as follows:

gl_flags

reserved for internal use

gl_closedir

pointer to a function capable of closing a directory opened by gl_opendir

gl_readdir64

pointer to a function capable of reading entries in a large directory

gl_opendir

pointer to a function capable of opening a large directory

gl_stat

pointer to a function capable of returning file status for a large file

gl_lstat

pointer to a function capable of returning file status information for a large file or symbolic link

A large file or large directory is one with a size which cannot be represented by a variable of type off_t.

Return Value

On success, 0 is returned. Other possible returns are:

GLOB_NOSPACE

out of memory

GLOB_ABORTED

read error

GLOB_NOMATCH

no match found

<<< PreviousHomeNext >>>
getutent_rUpglobfree64