|GETVFSBYNAME(3)||FreeBSD Library Functions Manual||GETVFSBYNAME(3)|
NAMEgetvfsbyname — get information about a file system
LIBRARYStandard C Library (libc, -lc)
SYNOPSIS#include < sys/param.h>
#include < sys/mount.h>
getvfsbyname( const char *name, struct xvfsconf *vfc);
DESCRIPTIONThe 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:
- the name of the file system
- the file system type number assigned by the kernel
- the number of active mount points using the file system
- flag bits, as described below
The flags are defined as follows:
- statically compiled into kernel
- may get data over the network
- writes are not implemented
- data does not represent real files
- aliases some other mounted FS
- stores file names as Unicode
- can be mounted from within a jail if security.jail.mount_allowed sysctl is set to 1
- supports delegated administration if vfs.usermount sysctl is set to 1
RETURN VALUESThe 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.
ERRORSThe 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.
HISTORYA variant of the getvfsbyname() function first appeared in FreeBSD 2.0.
|April 5, 2007||FreeBSD|