4.3BSD-Reno/share/man/cat2/fstatfs.0

STATFS(2)		      1990			STATFS(2)



NNAAMMEE
     statfs - get file system statistics

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
     ##iinncclluuddee <<ssyyss//mmoouunntt..hh>>

     ssttaattffss((ppaatthh,, bbuuff))
     cchhaarr **ppaatthh;;
     ssttrruucctt ssttaattffss **bbuuff;;

     ffssttaattffss((ffdd,, bbuuff))
     iinntt ffdd;;
     ssttrruucctt ssttaattffss **bbuuff;;

DDEESSCCRRIIPPTTIIOONN
     _S_t_a_t_f_s returns information about a mounted file system.
     _p_a_t_h is the path name of any file within the mounted
     filesystem.  _B_u_f is a pointer to a _s_t_a_t_f_s structure defined
     as follows:


	  typedef quad fsid_t;

	  #define MNAMELEN 32			    /* length of buffer for returned name */

	  struct statfs {
		   short   f_type;		    /* type of filesystem (see below) */
		   short   f_flags;		    /* copy of mount flags */
		   long    f_fsize;		    /* fundamental file system block size */
		   long    f_bsize;		    /* optimal transfer block size */
		   long    f_blocks;		    /* total data blocks in file system */
		   long    f_bfree;		    /* free blocks in fs */
		   long    f_bavail;		    /* free blocks avail to non-superuser */
		   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[6];		    /* spare for later */
		   char    f_mntonname[MNAMELEN];   /* directory on which mounted */
		   char    f_mntfromname[MNAMELEN]; /* mounted filesystem */
	  };
	  /*
	   * File system types.
	   */
	  #define  MOUNT_UFS			    1
	  #define  MOUNT_NFS			    2
	  #define  MOUNT_MFS			    3
	  #define  MOUNT_PC			    4

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



Printed 7/27/90               June				1






STATFS(2)		      1990			STATFS(2)



RREETTUURRNN VVAALLUUEE
     Upon successful completion, a value of 0 is returned.  Oth-
     erwise, -1 is returned and the global variable _e_r_r_n_o is set
     to indicate the error.

EERRRROORRSS
     _S_t_a_t_f_s fails if one or more of the following are true:

     ENOTDIR	    A component of the path prefix of _p_a_t_h is not
		    a directory.

     EINVAL	    _p_a_t_h contains a character with the high-order
		    bit set.

     ENAMETOOLONG   The length of a component of _p_a_t_h exceeds 255
		    characters, or the length of _p_a_t_h exceeds
		    1023 characters.

     ENOENT	    The file referred to by _p_a_t_h does not exist.

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

     ELOOP	    Too many symbolic links were encountered in
		    translating _p_a_t_h.

     EFAULT	    _B_u_f or _p_a_t_h points to an invalid address.

     EIO	    An I/O error occurred while reading from or
		    writing to the file system.

     _F_s_t_a_t_f_s fails if one or both of the following are true:

     EBADF	    _f_d is not a valid open file descriptor.

     EFAULT	    _b_u_f points to an invalid address.

     EIO	    An I/O error occurred while reading from or
		    writing to the file system.
















Printed 7/27/90               June				2