---
name: "getmntinfo"
section: "3"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd", "macos"]
url: "https://new.carta.tech/getmntinfo"
---

# getmntinfo(3)

get information about mounted file systems

## NAME

**getmntinfo** – get information about mounted file systems

## LIBRARY

Standard C Library (libc, -lc)

## SYNOPSIS

**#include \<sys/param.h\>**

**#include \<sys/ucred.h\>**

**#include \<sys/mount.h\>**

*int*\

**getmntinfo**(*struct statfs \*\*mntbufp*, *int mode*);

## DESCRIPTION

The **getmntinfo**() function returns an array of **statfs**() structures describing each currently mounted file system (see [statfs(2)](/statfs/2.md)).

The **getmntinfo**() function passes its *mode* argument transparently to [getfsstat(2)](/getfsstat/2.md).

## 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)](/getfsstat/2.md) or [malloc(3)](/malloc/3.md).

## SEE ALSO

[getfsstat(2)](/getfsstat/2.md), [mount(2)](/mount/2.md), [statfs(2)](/statfs/2.md), [mount(8)](/mount/8.md)

## 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(3)](/free/3.md)'d by the application.