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 information to uniquely identify a file within the file  system  as
       well  as  noticing  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  number  and  inode  generation  counter  in  its
       filehandle.

       A  call to VFS_FHTOVP() should generally be preceded by a call to VFS_CHECKEXP(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.

Debian                                            May 19, 2019                                     VFS_FHTOVP(9)