BSD 4_4_Lite2 development
[unix-history] / usr / share / man / cat3 / kvm_getvfsbyname.0
KVM_GETVFSBYNAME(3) BSD Programmer's Manual KVM_GETVFSBYNAME(3)
N\bNA\bAM\bME\bE
k\bkv\bvm\bm_\b_g\bge\bet\btv\bvf\bfs\bsb\bby\byn\bna\bam\bme\be - get information about a filesystem
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<s\bsy\bys\bs/\b/t\bty\byp\bpe\bes\bs.\b.h\bh>\b>
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<s\bsy\bys\bs/\b/m\bmo\bou\bun\bnt\bt.\b.h\bh>\b>
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<k\bkv\bvm\bm.\b.h\bh>\b>
_\bi_\bn_\bt
k\bkv\bvm\bm_\b_g\bge\bet\btv\bvf\bfs\bsb\bby\byn\bna\bam\bme\be(_\bc_\bo_\bn_\bs_\bt _\bc_\bh_\ba_\br _\b*_\bn_\ba_\bm_\be, _\bs_\bt_\br_\bu_\bc_\bt _\bv_\bf_\bs_\bc_\bo_\bn_\bf _\b*_\bv_\bf_\bc);
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
The k\bkv\bvm\bm_\b_g\bge\bet\btv\bvf\bfs\bsb\bby\byn\bna\bam\bme\be() function provides access to information about a
filesystem module that is configured in the kernel. If successful, the
requested filesystem _\bv_\bf_\bs_\bc_\bo_\bn_\bf is returned in the location pointed to by
v\bvf\bfc\bc. The fields in a ``struct vfsconf'' are defined as follows:
vfc_name the name of the filesystem
vfc_index the filesystem type number assigned by the kernel
vfc_refcount the number of active mount points using the filesystem
vfc_flags flag bits that are used to initialize a new mount point us-
ing the filesystem
R\bRE\bET\bTU\bUR\bRN\bN V\bVA\bAL\bLU\bUE\bES\bS
If the call to g\bge\bet\btv\bvf\bfs\bsb\bby\byn\bna\bam\bme\be is successful, 0 is returned. Otherwise -1
is returned and _\be_\br_\br_\bn_\bo is set appropriately.
E\bER\bRR\bRO\bOR\bRS\bS
The following errors may be reported:
[EFAULT] The _\bv_\bf_\bc pointer contains an invalid address.
[ENOENT] The _\bn_\ba_\bm_\be specifies a filesystem that is unknown or not con-
figured in the kernel.
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
sysctl(1), mount(2), sysctl(3), mount(8)
H\bHI\bIS\bST\bTO\bOR\bRY\bY
A variant of the g\bge\bet\btv\bvf\bfs\bsb\bby\byn\bna\bam\bme\be() function first appeared in FreeBSD 2.0.
4.4BSD April 3, 1995 1