man.bsd.lv manual page server

Manual Page Search Parameters

GETVFSBYNAME(3) Library Functions Manual GETVFSBYNAME(3)

getvfsbynameget information about a file system

library “libc”

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

int
getvfsbyname(const char *name, struct xvfsconf *vfc);

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

vfc_name
the name of the file system
vfc_typenum
the file system type number assigned by the kernel
vfc_refcount
the number of active mount points using the file system
vfc_flags
flag bits, as described below

The flags are defined as follows:

statically compiled into kernel
may get data over the network
writes are not implemented
data does not represent real files
aliases some other mounted FS
stores file names as Unicode
can be mounted from within a jail if allow.mount and allow.mount.<vfc_name> jail parameters are set
supports delegated administration if vfs.usermount sysctl is set to 1

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.

The following errors may be reported:

[]
The name argument specifies a file system that is unknown or not configured in the kernel.

jail(2), mount(2), sysctl(3), jail(8), mount(8), sysctl(8)

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

August 16, 2018 FreeBSD-12.0