getvfsbyname(3)

getvfsbyname3

Get information about a filesystem

Usage

#include <sys/param.h>

#include <sys/mount.h>

int

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

Library

Standard C Library (libc, -lc)

Overview

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.

Releases

155 releases since Mac OS X 10.2; the text changed 1 time.

  1. 10.2–10.4.11
  2. 10.5–26.5

History

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

From Libc 1752.120.2 in macOS 26.5. Parsed by carta from the page's mdoc source.