vfs_getvfs(9)

vfs_getvfs9

Returns a mount point given its file system identifier

Usage

#include <sys/param.h>

#include <sys/mount.h>

struct mount *

vfs_getvfs(fsid_t *fsid);

Overview

The vfs_getvfs() function returns the mount point structure for a file system given its file system identifier. The file system ID should have been allocated by calling vfs_getnewfsid(9); otherwise, it will not be found.

A major user of vfs_getvfs() is NFS, which uses the fsid as part of file handles in order to determine the file system a given RPC is for. If vfs_getvfs() fails to find the mount point related to fsid, the file system is considered stale.

Return values

If fsid is found, the mount point for the ID is returned; otherwise, NULL is returned.

Pseudocode

if ((mp = vfs_getvfs(&fhp->fh_fsid)) == NULL) {
	error = ESTALE;
	goto out;
}

Authors

This manual page was written by Chad David ⟨[email protected]⟩.

From freebsd-manpages 6.0-5 in Debian 4.0 (Etch). Parsed by carta from the page's mdoc source.