statfs(2)                                               statfs(2)



NAME
     statfs - gets file-system statistics

SYNOPSIS
     #include <sys/types.h>
     #include <sys/vfs.h>

     int statfs(path, buf)
     char *path;
     struct statfs *buf;

     int fstatfs(fildes, buf)
     int fildes;
     struct statfs *buf;

DESCRIPTION
     statfs returns information about a mounted file system.
     This system call should be used in place of the obsolete
     ustat system call.

     Replace path with the pathname of any file within the
     mounted file system and replace buf with a pointer to a
     statfs structure defined as follows:

        typedef long fsid_t[2];

        struct statfs {
           long  f_type;    /* type of info, zero
                                  for now */
           long  f_bsize;   /* fundamental file system
                                  block size */
           long  f_blocks;  /* total blocks in file
                                  system */
           long  f_bfree;   /* free blocks */
           long  f_bavail;  /* free blocks available to
                                  nonsuperuser */
           long  f_files;   /* total file nodes in
                                  file system */
           long  f_ffree;   /* free file nodes in fs */
           fsid_t  f_fsid;  /* file system ID */
           long  f_spare[7];     /* spare for later */
        };

     Fields that are undefined for a particular file system are
     set to -1.  fstatfs returns the same information about an
     open file referenced by the descriptor fildes.

STATUS MESSAGES AND VALUES
     On successful completion, a value of 0 is returned.
     Otherwise, -1 is returned and the global variable errno is
     set to indicate the error.  Here are the possible values of
     errno:



January 1992                                                    1

statfs(2)                                               statfs(2)



     EINVAL
          dev is not the device number of a device containing a
          mounted file system.

     EFAULT
          buf points outside the process's allocated address
          space.

SEE ALSO
     stat(2), ustat(2)













































2                                                    January 1992