GETVFSBYNAME(3)

NAME
getvfsbyname - get information about a file system

LIBRARY
libc

SYNOPSIS
#include <sys/param.h>
#include <sys/mount.h>
int
getvfsbyname(const char *name, struct xvfsconf *vfc);

DESCRIPTION
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 security.jail.mount_allowed sysctl is set to 1
VFCF_DELEGADMIN
    supports delegated administration if vfs.usermount sysctl is set to 1

RETURN VALUES

ERRORS
The following errors may be reported:

[EFAULT]
    The vfc argument points to an invalid address.

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

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

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