Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
GETVFSBYNAME(3)	       FreeBSD Library Functions Manual	       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 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
     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
     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.

FreeBSD	9.3			 April 5, 2007			   FreeBSD 9.3

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=getvfsbyname&sektion=3&manpath=FreeBSD+9.2-RELEASE>

home | help