Manual Pages  — GETVFSBYNAME

getvfsbyname – get information about a file system

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES ERRORS SEE ALSO HISTORY

Standard C Library (libc, -lc)

#include <sys/param.h>

#include <sys/mount.h>

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

The getvfsbyname() 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:

VFCF_STATIC	statically compiled into kernel
VFCF_NETWORK	may get data over the network
VFCF_READONLY	writes are not implemented
VFCF_SYNTHETIC	data does not represent real files
VFCF_LOOPBACK	aliases some other mounted FS
VFCF_UNICODE	stores file names as Unicode
VFCF_JAIL	can be mounted from within a jail if allow.mount and allow.mount.<vfc_name> jail parameters are set
VFCF_DELEGADMIN
	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:

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

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