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

GETFSSTAT(2)		      1990		     GETFSSTAT(2)



NNAAMMEE
     getfsstat - get list of all mounted filesystems

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

     ggeettffssssttaatt((bbuuff,, bbuuffssiizzee,, ffllaaggss))
     ssttrruucctt ssttaattffss **bbuuff[[]];;
     lloonngg bbuuffssiizzee;;
     iinntt ffllaaggss;;

DDEESSCCRRIIPPTTIIOONN
     _G_e_t_f_s_s_t_a_t returns information about all mounted filesystems.
     _B_u_f is a pointer to an array of _s_t_a_t_f_s structures 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 filesystem block size */
		   long    f_bsize;		    /* optimal transfer block size */
		   long    f_blocks;		    /* total data blocks in filesystem */
		   long    f_bfree;		    /* free blocks in fs */
		   long    f_bavail;		    /* free blocks avail to non-superuser */
		   long    f_files;		    /* total file nodes in filesystem */
		   long    f_ffree;		    /* free file nodes in fs */
		   fsid_t  f_fsid;		    /* filesystem 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_PC			    3

     Fields that are undefined for a particular filesystem are
     set to -1.  The buffer is filled with an array of _f_s_s_t_a_t
     structures, one for each mounted filesystem up to the size
     specified by _b_u_f_s_i_z_e .

     If _b_u_f is given as zero, _g_e_t_f_s_s_t_a_t returns just the number
     of mounted filesystems.




Printed 7/27/90               June				1






GETFSSTAT(2)		      1990		     GETFSSTAT(2)



     Normally _f_l_a_g_s should be specified as MNT_WAIT.  If _f_l_a_g_s is
     set to MNT_NOWAIT, then _g_e_t_f_s_s_t_a_t will return the informa-
     tion it has available without requesting an update from each
     filesystem.  Thus, some of the information will be out of
     date, but _g_e_t_f_s_s_t_a_t will not block waiting for information
     from a filesystem that is unable to respond.

RREETTUURRNN VVAALLUUEE
     Upon successful completion, the number of _f_s_s_t_a_t structures
     is returned.  Otherwise, -1 is returned and the global vari-
     able _e_r_r_n_o is set to indicate the error.

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

     EFAULT	    _B_u_f points to an invalid address.

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

SSEEEE AALLSSOO
     statfs(2), fstab(5), mount(8)

































Printed 7/27/90               June				2