gfal_stat(3) - Linux man page
Name
gfal_stat - get information about a file or directorySynopsis
int gfal_stat (const char *filename, struct stat *statbuf);
int gfal_lstat (const char *filename, struct stat *statbuf);
Under Linux, for large files:
#define _LARGEFILE64_SOURCE
#include "gfal_api.h"
int gfal_stat64 (const char *filename, struct stat64 *statbuf);
int gfal_stat64 (const char *filename, struct stat64 *statbuf);
For large files, under other systems:
#include "gfal_api.h"
int gfal_stat64 (const char *filename, struct stat64 *statbuf);
int gfal_lstat64 (const char *filename, struct stat64 *statbuf);
Description
gfal_stat gets information about a file or directory. gfal_lstat is identical to gfal_stat except for symbolic links. In this case, the link itself is statted and not followed.- filename
- specifies the file name: either a logical file name, a guid, an SURL or a TURL.
The 64 bits functions must be used for large files. They have the same syntax as the normal stat functions except that they use a stat64 structure.
Return Value
This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case, errno is set appropriately.Errors
- ENOENT
- The named file/directory does not exist.
- EACCES
- Search permission is denied on a component of the filename prefix.
- EFAULT
- filename is a NULL pointer.
- ENOTDIR
- A component of filename prefix is not a directory.
- EINVAL
- filename has an invalid syntax.
- ECOMM
- Communication error.
- EPROTONOSUPPORT
- Access method not supported.