gfal_stat(3) - Linux man page

Name

gfal_stat - get information about a file or directory

Synopsis

#include "gfal_api.h"

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.

See Also

gfal(3)