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

FreeBSD Manual Pages

  
 
  

home | help
VFS_FHTOVP(9)		    Kernel Developer's Manual		   VFS_FHTOVP(9)

NAME
     VFS_FHTOVP -- turn an NFS filehandle into a vnode

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

     int
     VFS_FHTOVP(struct mount *mp, struct fid *fhp, int flags,
	 struct vnode **vpp);

DESCRIPTION
     The  VFS_FHTOVP() macro is used by the NFS server to turn an NFS filehandle
     into a vnode.

     The arguments it expects are:

     mp     The file system.

     fhp    The filehandle to convert.

     flags  Additional locking flags to pass through to vget(9).   File  systems
	    are allowed to ignore flags and use LK_EXCLUSIVE instead.

     vpp    Return parameter for the new locked vnode.

     The  contents  of the filehandle are defined by the file system and are not
     examined by any other part of the system.	It should contain enough  infor-
     mation to uniquely identify a file within the file system as well as notic-
     ing  when	a  file has been removed and the file system resources have been
     reused for a new file.  For instance, UFS file system stores the inode num-
     ber and inode generation counter in its filehandle.

     A call to VFS_FHTOVP() should generally be preceded by a call to VFS_CHECK-
     EXP(9) to check if the file is accessible to the client.

RETURN VALUES
     The locked vnode for the file will be returned in *vpp.

SEE ALSO
     VFS(9), VFS_CHECKEXP(9), vnode(9), VOP_VPTOFH(9)

AUTHORS
     This manual page was written by Doug Rabson.

FreeBSD ports 15.quarterly	  May 19, 2019			   VFS_FHTOVP(9)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=VFS_FHTOVP&sektion=9&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help