statfs(2)                                               statfs(2)



     NAME
          statfs - get 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.  Re-
          place 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.

     RETURN VALUE
          On successful completion, a value of 0 is returned.  Other-
          wise, -1 is returned and the global variable errno is set to
          indicate the error.

     SEE ALSO
          stat(2), ustat(2).




     April, 1990                                                     1