mirror of
https://github.com/adulau/aha.git
synced 2024-12-29 04:06:22 +00:00
nfsd: update fh_verify description
Signed-off-by: J. Bruce Fields <bfields@citi.umich.edu>
This commit is contained in:
parent
238c6d5483
commit
b3d47676d4
1 changed files with 24 additions and 6 deletions
|
@ -258,14 +258,32 @@ out:
|
|||
return error;
|
||||
}
|
||||
|
||||
/*
|
||||
* Perform sanity checks on the dentry in a client's file handle.
|
||||
/**
|
||||
* fh_verify - filehandle lookup and access checking
|
||||
* @rqstp: pointer to current rpc request
|
||||
* @fhp: filehandle to be verified
|
||||
* @type: expected type of object pointed to by filehandle
|
||||
* @access: type of access needed to object
|
||||
*
|
||||
* Note that the file handle dentry may need to be freed even after
|
||||
* an error return.
|
||||
* Look up a dentry from the on-the-wire filehandle, check the client's
|
||||
* access to the export, and set the current task's credentials.
|
||||
*
|
||||
* This is only called at the start of an nfsproc call, so fhp points to
|
||||
* a svc_fh which is all 0 except for the over-the-wire file handle.
|
||||
* Regardless of success or failure of fh_verify(), fh_put() should be
|
||||
* called on @fhp when the caller is finished with the filehandle.
|
||||
*
|
||||
* fh_verify() may be called multiple times on a given filehandle, for
|
||||
* example, when processing an NFSv4 compound. The first call will look
|
||||
* up a dentry using the on-the-wire filehandle. Subsequent calls will
|
||||
* skip the lookup and just perform the other checks and possibly change
|
||||
* the current task's credentials.
|
||||
*
|
||||
* @type specifies the type of object expected using one of the S_IF*
|
||||
* constants defined in include/linux/stat.h. The caller may use zero
|
||||
* to indicate that it doesn't care, or a negative integer to indicate
|
||||
* that it expects something not of the given type.
|
||||
*
|
||||
* @access is formed from the NFSD_MAY_* constants defined in
|
||||
* include/linux/nfsd/nfsd.h.
|
||||
*/
|
||||
__be32
|
||||
fh_verify(struct svc_rqst *rqstp, struct svc_fh *fhp, int type, int access)
|
||||
|
|
Loading…
Reference in a new issue