---
name: "getvfsbyname"
section: "3"
platform: "macos"
package: "Libc"
version: "1752.120.2"
release: "macOS 26.5"
platforms: ["freebsd", "macos"]
url: "https://new.carta.tech/getvfsbyname"
---

# getvfsbyname(3)

get information about a filesystem

## NAME

**getvfsbyname** – get information about a filesystem

## LIBRARY

Standard C Library (libc, -lc)

## SYNOPSIS

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

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

*int*\

**getvfsbyname**(*const char \*name*, *struct vfsconf \*vfc*);

## DESCRIPTION

The **getvfsbyname**() function provides access to information about a filesystem module that is configured in the kernel. If successful, the requested filesystem *vfsconf* is returned in the location pointed to by *vfc*. The fields in a “struct vfsconf” are defined as follows:

- vfc\_name

  the name of the filesystem

- vfc\_typenum

  the filesystem type number assigned by the kernel

- vfc\_refcount

  the number of active mount points using the filesystem

## RETURN VALUES

The **getvfsbyname()** function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

## ERRORS

The following errors may be reported:

- \[EFAULT\]

  The *vfc* pointer contains an invalid address.

- \[ENOENT\]

  The *name* specifies a filesystem that is unknown or not configured in the kernel.

## SEE ALSO

[mount(2)](/mount/2.md), [sysctl(3)](/sysctl/3.md), [mount(8)](/mount/8.md), [sysctl(8)](/sysctl/8.md)

## HISTORY

A variant of the **getvfsbyname**() function first appeared in FreeBSD 2.0.