NAME    [Toc]    [Back]

     getvfsbyname -- get information about a file system

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

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

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

DESCRIPTION    [Toc]    [Back]

     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

RETURN VALUES    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

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


FreeBSD 5.2.1			  May 4, 1995			 FreeBSD 5.2.1