getvfsbyname(3)

NAME

getvfsbyname - get information about a file system

LIBRARY

Standard C Library (libc, -lc)

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 success

ful, 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

RETURN VALUES

The getvfsbyname() function returns the value 0 if success

ful; 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 argument points to an invalid ad

dress.

[ENOENT] The name argument specifies a file system

that is

unknown or not configured in the kernel.

SEE ALSO

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

HISTORY

A variant of the getvfsbyname() function first appeared in

FreeBSD 2.0.

BSD May 4, 1995

BSD