Content-type: text/html Man page of GFAL_STAT

GFAL_STAT

Section: Library Functions (3)
Updated: $Date: 2003/11/19 12:56:29 $
Index Return to Main Contents
 

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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 14:16:32 GMT, July 14, 2009