GETMNTINFO(3)	    UNIX Programmer's Manual	    GETMNTINFO(3)



NAME
     getmntinfo - get information about mounted file systems

SYNOPSIS
     #include <sys/param.h>
     #include <sys/mount.h>

     _i_n_t
     getmntinfo(mntbufp,flags)
     _s_t_r_u_c_t _s_t_a_t_f_s **_m_n_t_b_u_f_p;
     _i_n_t _f_l_a_g_s

DESCRIPTION
     The getmntinfo() function returns an array of _s_t_a_t_f_s struc-
     tures describing each currently mounted file system (see
     statfs(2).

     The getmntinfo() function passes its _f_l_a_g_s parameter tran-
     sparently to getfsstat(2).

RETURN VALUES
     On successful completion, getmntinfo() returns a count of
     the number of elements in the array.  The pointer to the
     array is stored into _m_n_t_b_u_f_p.

     If an error occurs, zero is returned and the external vari-
     able _e_r_r_n_o is set to indicate the error.  Although the
     pointer _m_n_t_b_u_f_p will be unmodified, any information previ-
     ously returned by getmntinfo() will be lost.

ERRORS
     The getmntinfo() function may fail and set errno for any of
     the errors specified for the library routines getfsstat(2)
     or malloc(3).

SEE ALSO
     getfsstat(2), statfs(2), mount(2), mount(8)

HISTORY
     The getmntinfo() function first appeared in 4.4BSD.

BUGS
     The getmntinfo() function writes the array of structures to
     an internal static object and returns a pointer to that
     object. Subsequent calls to getmntinfo() will modify the
     same object.

     The memory allocated by getmntinfo() cannot be free(2)'d by
     the application.






Printed 11/26/99	December 26, 1995			1