NAME
getmntinfo
—
get information about mounted file
systems
SYNOPSIS
#include
<sys/types.h>
#include <sys/mount.h>
int
getmntinfo
(struct
statfs **mntbufp, int
flags);
DESCRIPTION
The
getmntinfo
()
function returns an array of statfs structures
describing each currently mounted file system (see
statfs(2)).
The
getmntinfo
()
function passes its flags parameter transparently 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 mntbufp.
If an error occurs, zero is returned and the external variable
errno is set to indicate the error. Although the
pointer mntbufp will be unmodified, any information
previously 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
HISTORY
The getmntinfo
() function first appeared
in 4.3BSD-Reno.
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(3)'d by the
application.