VFS_FHTOVP (9)

Leading comments

Copyright (c) 1996 Doug Rabson

All rights reserved.

This program is free software.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in...

(The comments found at the beginning of the groff file "man9/VFS_FHTOVP.9freebsd".)

NAME

VFS_FHTOVP - turn an NFS filehandle into a vnode

SYNOPSIS

In sys/param.h In sys/mount.h In sys/vnode.h Ft int Fn VFS_FHTOVP struct mount *mp struct fid *fhp struct vnode **vpp

DESCRIPTION

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

The arguments it expects are:

Fa mp

The file system.

Fa fhp

The filehandle to convert.

Fa 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 Fn VFS_FHTOVP should generally be preceded by a call to VFS_CHECKEXP9 to check if the file is accessible to the client.

RETURN VALUES

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

SEE ALSO

VFS(9), VFS_CHECKEXP9, VOP_VPTOFH9, vnode(9)

AUTHORS

This manual page was written by An Doug Rabson .