NAME
getmntinfo,
getmntvinfo —
get information about mounted file
systems
LIBRARY
library “libc”
SYNOPSIS
#include
<sys/param.h>
#include <sys/ucred.h>
#include <sys/mount.h>
int
getmntinfo(struct
statfs **mntbufp, int
flags);
int
getmntvinfo(struct
statfs **mntbufp, struct
statvfs **mntvbufp, int
flags);
DESCRIPTION
Thegetmntinfo()
function returns an array of
statfs()
structures describing each currently mounted file system (see
statfs(2)).
The
getmntinfo()
function passes its flags argument transparently to
getfsstat(2).
The
getmntvinfo()
function returns an array of statfs and
statvfs structures describing each currently mounted
file system (see
statfs(2)), and otherwise works like
getmntinfo().
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.
The getmntvinfo() function additionally
stores the pointer to the statvfs array into
mntvbufp.
ERRORS
The getmntinfo() and
getmntvinfo() functions may fail and set
errno for any of the errors specified for the library
routines
getfsstat(2),
getvfsstat(2) or
malloc(3).
SEE ALSO
HISTORY
The getmntinfo() function first appeared
in 4.4BSD.
The getmntvinfo() function first appeared
in DragonFly 1.13.
BUGS
The getmntinfo() and
getmntvinfo() functions write the array of
structures to an internal static object and returns a pointer to that
object. Subsequent calls to getmntinfo() or
getmntvinfo() will modify the same object.
The memory allocated by getmntinfo() or
getmntvinfo() cannot be
free(3)'d by the application.