NAME    [Toc]    [Back]

     vfs_getvfs -- returns a mount point given its file system identifier

SYNOPSIS    [Toc]    [Back]

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

     struct mount *
     vfs_getvfs(fsid_t *fsid);

DESCRIPTION    [Toc]    [Back]

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

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

PSEUDOCODE    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

     vfs_getnewfsid(9)

AUTHORS    [Toc]    [Back]

     This manual page was written by Chad David <[email protected]>.


FreeBSD 5.2.1		       November 21, 2001		 FreeBSD 5.2.1