NAME

       rfio_statfs - get information about a mounted filesystem

SYNOPSIS

       #include <sys/types.h>
       #include "rfio_api.h"

       int rfio_statfs (const char *path, struct rfstatfs *statfsbuf);

       Under Linux, for large files:
       #define _LARGEFILE64_SOURCE
       #include <sys/types.h>
       #include "rfio_api.h"

       int rfio_statfs64 (const char *path, struct rfstatfs64 *statfsbuf);

       For large files, under other systems:
       #include <sys/types.h>
       #include "rfio_api.h"

       int rfio_statfs64 (const char *path, struct rfstatfs64 *statfsbuf);

DESCRIPTION

       rfio_statfs gets information about a mounted filesystem.

       path    specifies the logical pathname relative to the current directory or the full pathname of any file
               in this filesystem.

       statfsbuf
               is a pointer to a rfstatfs structure:
               struct rfstatfs {
                       long totblks  ;      /* Total number of blocks       */
                       long freeblks ;      /* Number of free blocks        */
                       long bsize    ;      /* Block size                   */
                       long totnods  ;      /* Total number of inodes       */
                       long freenods ;      /* Number of free inodes        */
               };
               struct rfstatfs64 {
                       signed64 totblks  ;  /* Total number of blocks       */
                       signed64 freeblks ;  /* Number of free blocks        */
                       long bsize        ;  /* Block size                   */
                       signed64 totnods  ;  /* Total number of inodes       */
                       signed64 freenods ;  /* Number of free inodes        */
               };

       The 64 bits function must be used for large filesystems. It has the same  syntax  as  the  normal  statfs
       function except that it uses a rfstatfs64 structure.

RETURN VALUE

       This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case,
       serrno is set appropriately.

ERRORS

       ENOENT       The named file/directory does not exist or is a null pathname.

       EACCES       Search permission is denied on a component of the path prefix.

       EFAULT       path or statfsbuf is a NULL pointer.

       ENOTDIR      A component of path prefix is not a directory.

       ENAMETOOLONG The length of path  exceeds  CA_MAXPATHLEN  or  the  length  of  a  path  component  exceeds
                    CA_MAXNAMELEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

SEE ALSO

       Castor_limits(4)

AUTHOR

       LCG Grid Deployment Team