Document the 'fdidx' argument of VOP_OPEN(9).

PR:          	56911
Noticed by: 	Jun Su <junsu@m-net.arbornet.org>
This commit is contained in:
Hiten Pandya 2004-05-10 23:17:09 +00:00
parent fffbf07a36
commit 2b55fc2e9c
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=129107

View file

@ -39,7 +39,7 @@
.In sys/param.h
.In sys/vnode.h
.Ft int
.Fn VOP_OPEN "struct vnode *vp" "int mode" "struct ucred *cred" "struct thread *td"
.Fn VOP_OPEN "struct vnode *vp" "int mode" "struct ucred *cred" "struct thread *td" "int fdidx"
.Ft int
.Fn VOP_CLOSE "struct vnode *vp" "int mode" "struct ucred *cred" "struct thread *td"
.Sh DESCRIPTION
@ -59,6 +59,13 @@ the access mode required by the calling process
the thread which is accessing the file
.El
.Pp
Additionally,
.Fn VOP_OPEN
can accept a file descriptor number in
.Fa fdidx ;
this is useful for file systems which require such information, e.g.
.Xr fdesc 5 .
.Pp
The access mode is a set of flags, including
.Dv FREAD ,
.Dv FWRITE ,
@ -78,6 +85,14 @@ Note that
.Fa vn_close
expects an unlocked, referenced vnode and will dereference the vnode prior
to returning.
.Sh IMPLEMENTATION NOTES
The
.Fa fdidx
argument to
.Fn VOP_OPEN
is currently unused, use
.Ql \-1
for the meantime; however, this will change in future.
.Sh RETURN VALUES
Zero is returned on success, otherwise an error code is returned.
.Sh PSEUDOCODE