This manual page is for Mac OS X version 10.6.3

Reading manual pages

GETMNTINFO(3)                           BSD Library Functions Manual                           GETMNTINFO(3)

NAME
     getmntinfo -- get information about mounted file systems

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

     int
     getmntinfo(struct statfs **mntbufp, int flags);

TRANSITIIONAL SYNOPSIS (NOW DEPRECATED)
     int
     getmntinfo64(struct statfs64 **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 argument transparently to getfsstat(2).

     Like getfsstat(2), when the macro _DARWIN_FEATURE_64_BIT_INODE is defined, the ino_t type will be
     64-bits (force 64-bit inode mode by defining the _DARWIN_USE_64_BIT_INODE macro before including header
     files).  This will cause the symbol variant of getmntinfo(), with the $INODE64 suffixes, to be automat-ically automatically
     ically linked in.  In addition, the statfs structure will be the 64-bit inode version.  If
     _DARWIN_USE_64_BIT_INODE is not defined, both getmntinfo() and the statfs structure will refer to the
     32-bit inode versions.

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 rou-tines routines
     tines getfsstat(2) or malloc(3).

TRANSITIONAL DESCRIPTION (NOW DEPRECATED)
     The getmntinfo64() routine is equivalent to its corresponding non-64-suffixed routine, when 64-bit
     inodes are in effect.  It was added before there was support for the symbol variants, and so is now
     deprecated.  Instead of using it, set the _DARWIN_USE_64_BIT_INODE macro before including header files
     to force 64-bit inode support.

     The statfs64 structure used by this deprecated routine is the same as the statfs structure when 64-bit
     inodes are in effect.

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

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

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

     The memory allocated by getmntinfo() and getmntinfo64() cannot be free(3)'d by the application.

BSD                                             May 15, 2008                                             BSD