summaryrefslogtreecommitdiff
path: root/share/man/man9
diff options
context:
space:
mode:
authorJason McIntyre <jmc@cvs.openbsd.org>2004-04-17 20:30:42 +0000
committerJason McIntyre <jmc@cvs.openbsd.org>2004-04-17 20:30:42 +0000
commitff87c603d773194f9e20b215a29b4b1a0cc19a78 (patch)
tree27e6eb716ea2f3a82e5309bfaaaf2ad74310876c /share/man/man9
parentc411842d2ce323e72aa3228f062fa891596e0aa7 (diff)
lots of fixes from jared yanovich;
Diffstat (limited to 'share/man/man9')
-rw-r--r--share/man/man9/vaccess.910
-rw-r--r--share/man/man9/vclean.915
-rw-r--r--share/man/man9/vcount.96
-rw-r--r--share/man/man9/vdevgone.912
-rw-r--r--share/man/man9/vfinddev.94
-rw-r--r--share/man/man9/vflush.98
-rw-r--r--share/man/man9/vget.914
-rw-r--r--share/man/man9/vgone.97
-rw-r--r--share/man/man9/vhold.913
-rw-r--r--share/man/man9/vinvalbuf.916
-rw-r--r--share/man/man9/vn_lock.923
-rw-r--r--share/man/man9/vput.915
-rw-r--r--share/man/man9/vrecycle.922
-rw-r--r--share/man/man9/vref.913
-rw-r--r--share/man/man9/vrele.917
-rw-r--r--share/man/man9/vwaitforio.927
16 files changed, 126 insertions, 96 deletions
diff --git a/share/man/man9/vaccess.9 b/share/man/man9/vaccess.9
index 7228e268aa6..176ced85234 100644
--- a/share/man/man9/vaccess.9
+++ b/share/man/man9/vaccess.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vaccess.9,v 1.4 2003/04/20 20:38:28 jmc Exp $
+.\" $OpenBSD: vaccess.9,v 1.5 2004/04/17 20:30:41 jmc Exp $
.\"-
.\" Copyright (c) 2001 Robert N. M. Watson
.\" All rights reserved.
@@ -30,7 +30,7 @@
.Dt VACCESS 9
.Sh NAME
.Nm vaccess
-.Nd check access permissions based vnode parameters
+.Nd check access permissions based on vnode parameters
.Sh SYNOPSIS
.Fd #include <sys/param.h>
.Fd #include <sys/vnode.h>
@@ -66,13 +66,13 @@ and
.Fa gid
arguments are the user id and group id representing the owner of the file.
.Fa acc_mode
-describes the operation wanted to be performed.
+describes the operation desired.
It should be one of
.Dv VREAD ,
-.Dv VWRITE
+.Dv VWRITE ,
or
.Dv VEXEC
-representing read, write and execute respectively.
+representing read, write, and execute, respectively.
.Sh RETURN VALUES
.Fn vaccess
will return 0 on success, or a non-zero error value on failure.
diff --git a/share/man/man9/vclean.9 b/share/man/man9/vclean.9
index c528a61d275..3c7e303233b 100644
--- a/share/man/man9/vclean.9
+++ b/share/man/man9/vclean.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vclean.9,v 1.5 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vclean.9,v 1.6 2004/04/17 20:30:41 jmc Exp $
.\"-
.\" Copyright (c) 2002 Peter Werner
.\" All rights reserved.
@@ -43,10 +43,11 @@
.Sh DESCRIPTION
The
.Fn vclean
-function clears any VM and buffer data associated with a vnode
+function clears any VM and buffer data associated with the vnode
.Fa vp
and reclaims it from the underlying file system.
-The arguments are:
+.Pp
+Its arguments are:
.Bl -tag -width ".Fa flags"
.It Fa vp
The vnode to be cleaned.
@@ -63,12 +64,14 @@ If the vnode is active, it will be closed and inactivated in the
underlying file system.
.El
.It Fa p
-The process associated with this operation.
+The process responsible for this call.
.El
.Pp
The vnode interlock is held on entry.
-On exit the v_tag field of the vnode will be set to
-.Dv VT_NON
+On exit, the
+.Va v_tag
+field of the vnode will be set to
+.Dv VT_NON ,
and if the vnode was active, it will be placed on the vnode free list.
.Sh SEE ALSO
.Xr vinvalbuf 9 ,
diff --git a/share/man/man9/vcount.9 b/share/man/man9/vcount.9
index 20e049efdbe..f43ebbcf16d 100644
--- a/share/man/man9/vcount.9
+++ b/share/man/man9/vcount.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vcount.9,v 1.2 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vcount.9,v 1.3 2004/04/17 20:30:41 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 2000 Andrew Stevenson
@@ -37,8 +37,8 @@
.Os
.Dt VCOUNT 9
.Sh NAME
-.Nm vcount ,
-.Nd "get total number of references to a device"
+.Nm vcount
+.Nd get total number of references to a device
.Sh SYNOPSIS
.Fd #include <sys/param.h>
.Fd #include <sys/time.h>
diff --git a/share/man/man9/vdevgone.9 b/share/man/man9/vdevgone.9
index 18a2932c860..2bccd61ab1d 100644
--- a/share/man/man9/vdevgone.9
+++ b/share/man/man9/vdevgone.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vdevgone.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vdevgone.9,v 1.4 2004/04/17 20:30:41 jmc Exp $
.\"-
.\" Copyright (c) 2002 Peter Werner
.\" All rights reserved.
@@ -49,6 +49,7 @@ number range for the device with a major number of
.Fa maj
and of type
.Fa type .
+.Pp
Its arguments are:
.Bl -tag -width ".Fa type"
.It Fa maj
@@ -58,11 +59,11 @@ The lowest minor number for the device to be revoked.
.It Fa minh
The highest minor number for the device to be revoked.
.It Fa type
-The type of the device; must be one of:
+The type of the device; this must be one of:
.Bl -tag -width ".Dv VBLK"
-.It VBLK
+.It Dv VBLK
Device is a block device
-.It VCHR
+.It Dv VCHR
Device is a character device
.El
.El
@@ -73,7 +74,8 @@ and
.Fa minh
are inclusive.
.Sh SEE ALSO
-.Xr vfinddev 9
+.Xr vfinddev 9 ,
+.Xr vnode 9
.Sh HISTORY
This man page was originally written for
.Ox .
diff --git a/share/man/man9/vfinddev.9 b/share/man/man9/vfinddev.9
index c108be42d4f..fbaccc865ff 100644
--- a/share/man/man9/vfinddev.9
+++ b/share/man/man9/vfinddev.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vfinddev.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vfinddev.9,v 1.4 2004/04/17 20:30:41 jmc Exp $
.\"-
.\" Copyright (c) 2002 Peter Werner
.\" All rights reserved.
@@ -52,7 +52,7 @@ in
.Fa vpp .
.Sh RETURN VALUES
.Fn vfinddev
-will return 1 if a corresponding vnode was found, 0 if otherwise.
+will return 1 if a corresponding vnode was found, 0 otherwise.
.Sh SEE ALSO
.Xr vnode 9
.Sh HISTORY
diff --git a/share/man/man9/vflush.9 b/share/man/man9/vflush.9
index 234c9d265a5..dd7201d51ff 100644
--- a/share/man/man9/vflush.9
+++ b/share/man/man9/vflush.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vflush.9,v 1.2 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vflush.9,v 1.3 2004/04/17 20:30:41 jmc Exp $
.\"
.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
.\"
@@ -32,7 +32,7 @@
.Os
.Sh NAME
.Nm vflush
-.Nd "flush vnodes for a mount point"
+.Nd flush vnodes for a mount point
.Sh SYNOPSIS
.Fd #include <sys/param.h>
.Fd #include <sys/vnode.h>
@@ -42,8 +42,7 @@
The
.Fn vflush
function removes any vnodes in the vnode table that belong to the given
-.Fa mount
-structure.
+mount structure.
.Pp
Its arguments are:
.Bl -tag -width ".Fa rootrefs"
@@ -71,6 +70,7 @@ will be returned.
.Sh SEE ALSO
.Xr vgone 9 ,
.Xr vgonel 9 ,
+.Xr vnode 9 ,
.Xr vrele 9
.Sh AUTHORS
This man page was originally written by
diff --git a/share/man/man9/vget.9 b/share/man/man9/vget.9
index 193e9339924..3fd86a851c3 100644
--- a/share/man/man9/vget.9
+++ b/share/man/man9/vget.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vget.9,v 1.5 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vget.9,v 1.6 2004/04/17 20:30:41 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 1996 Doug Rabson
@@ -42,11 +42,15 @@
.Fn vget "struct vnode *vp" "int flags" "struct proc *p"
.Sh DESCRIPTION
Get a vnode from the free list and increment its reference count.
+.Pp
+Its arguments are:
.Bl -tag -width flags
-.It Ar vp
-the vnode to remove from the free list
-.It Ar flags
-if non-zero, the vnode will also be locked
+.It Fa vp
+The vnode to remove from the free list.
+.It Fa flags
+If non-zero, the vnode will also be locked.
+.It Fa p
+The process responsible for this call.
.El
.Pp
When not in use, vnodes are kept on a free list.
diff --git a/share/man/man9/vgone.9 b/share/man/man9/vgone.9
index ce8a9a279ff..bd61a7c3239 100644
--- a/share/man/man9/vgone.9
+++ b/share/man/man9/vgone.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vgone.9,v 1.4 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vgone.9,v 1.5 2004/04/17 20:30:41 jmc Exp $
.\"
.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
.\"
@@ -31,8 +31,9 @@
.Dt VGONE 9
.Os
.Sh NAME
-.Nm vgone , vgonel
-.Nd "prepare a vnode for reuse"
+.Nm vgone ,
+.Nm vgonel
+.Nd prepare a vnode for reuse
.Sh SYNOPSIS
.Fd #include <sys/param.h>
.Fd #include <sys/vnode.h>
diff --git a/share/man/man9/vhold.9 b/share/man/man9/vhold.9
index de38f019a9e..d27fcb96d92 100644
--- a/share/man/man9/vhold.9
+++ b/share/man/man9/vhold.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vhold.9,v 1.3 2003/03/08 23:17:18 jmc Exp $
+.\" $OpenBSD: vhold.9,v 1.4 2004/04/17 20:30:41 jmc Exp $
.\"
.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
.\"
@@ -32,7 +32,7 @@
.Os
.Sh NAME
.Nm vhold
-.Nd "acquire a hold on a vnode"
+.Nd acquire a hold on a vnode
.Sh SYNOPSIS
.Fd #include <sys/param.h>
.Fd #include <sys/vnode.h>
@@ -44,9 +44,14 @@ The
function increments the
.Va v_holdcnt
of the given vnode.
-If the vnode has already been added to the free list and its v_holdcnt and
-v_usecount are both zero, it will be removed from the free list and
+If the vnode has already been added to the free list and its
+.Va v_holdcnt
+and
+.Va v_usecount
+are both zero, it will be removed from the free list and
added to the vnode hold list.
+.Sh SEE ALSO
+.Xr vnode 9
.Sh AUTHORS
This man page was orignally written by
.An Chad David Aq davidc@acns.ab.ca
diff --git a/share/man/man9/vinvalbuf.9 b/share/man/man9/vinvalbuf.9
index 140056fe74f..a46f5eba153 100644
--- a/share/man/man9/vinvalbuf.9
+++ b/share/man/man9/vinvalbuf.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vinvalbuf.9,v 1.5 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vinvalbuf.9,v 1.6 2004/04/17 20:30:41 jmc Exp $
.\"
.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
.\"
@@ -32,12 +32,13 @@
.Os
.Sh NAME
.Nm vinvalbuf
-.Nd "flushes and invalidates all buffers associated with a vnode"
+.Nd flush and invalidate all buffers associated with a vnode
.Sh SYNOPSIS
.Fd #include <sys/param.h>
.Fd #include <sys/vnode.h>
.Ft int
-.Fn vinvalbuf "struct vnode *vp" "int flags" "struct ucred *cred" "struct proc *p" "int slpflag" "int slptimeo"
+.Fn vinvalbuf "struct vnode *vp" "int flags" "struct ucred *cred" \
+ "struct proc *p" "int slpflag" "int slptimeo"
.Sh DESCRIPTION
The
.Fn vinvalbuf
@@ -52,7 +53,7 @@ If the
flag is set, indirect blocks will not be flushed.
.Pp
Its arguments are:
-.Bl -tag -width ".Fa spltimeo"
+.Bl -tag -width ".Fa slptimeo"
.It Fa vp
A pointer to the vnode whose buffers will be invalidated.
.It Fa flags
@@ -63,7 +64,7 @@ and
.Dv V_SAVE
indicates that dirty buffers should be synced with the disk.
.Dv V_SAVEMETA
-indicates the indirect blocks should not be flushed.
+indicates that indirect blocks should not be flushed.
.It Fa cred
The user credentials that are used to
.Xr VOP_FSYNC 9
@@ -81,7 +82,7 @@ The timeout for any sleeps in the function.
The vnode is assumed to be locked prior to the call and remains locked upon
return.
.Sh RETURN VALUES
-A 0 value is returned on success.
+A value of 0 is returned on success.
.Sh PSEUDOCODE
.Bd -literal -offset indent
vn_lock(devvp, LK_EXCLUSIVE | LK_RETRY, p);
@@ -118,7 +119,8 @@ set in
.Fa slpflag )
.El
.Sh SEE ALSO
-.Xr tsleep 9
+.Xr tsleep 9 ,
+.Xr vnode 9
.Sh AUTHORS
This man page was originally written by
.An Chad David Aq davidc@acns.ab.ca
diff --git a/share/man/man9/vn_lock.9 b/share/man/man9/vn_lock.9
index b684249578a..919dfbeded2 100644
--- a/share/man/man9/vn_lock.9
+++ b/share/man/man9/vn_lock.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vn_lock.9,v 1.6 2003/04/20 20:38:28 jmc Exp $
+.\" $OpenBSD: vn_lock.9,v 1.7 2004/04/17 20:30:41 jmc Exp $
.\"
.\" Copyright (c) 2001 Constantine Sapuntzakis
.\" All rights reserved.
@@ -54,7 +54,7 @@ function should be used.
.Pp
The
.Fa flags
-fields may contain the following flags:
+argument may contain the following flags:
.Bl -column LK_INTERLOCK -offset indent
.It Dv LK_RETRY Ta
Return the vnode even if it has been reclaimed.
@@ -63,7 +63,8 @@ Must be set if the caller owns the vnode interlock.
.It Dv LK_NOWAIT Ta
Don't wait if the vnode lock is held by someone else (may still
wait on reclamation lock on or interlock).
-Must not be used with LK_RETRY.
+Must not be used with
+.Dv LK_RETRY .
.It Dv LK_EXCLUSIVE Ta
Acquire an exclusive lock.
.It Dv LK_SHARED Ta
@@ -83,9 +84,15 @@ Otherwise, one of the following errors is returned.
.Bl -tag -width Er
.It Bq Er ENOENT
The vnode has been reclaimed and is dead.
-This error is only returned if the LK_RETRY flag is not passed.
+This error is only returned if the
+.Dv LK_RETRY
+flag is not passed.
.It Bq Er EBUSY
-The LK_NOWAIT flag was set and the vn_lock would have slept.
+The
+.Dv LK_NOWAIT
+flag was set and
+.Fn vn_lock
+would have slept.
.El
.Sh SEE ALSO
.Xr vnode 9
@@ -97,7 +104,7 @@ Discussions with Kirk McKusick indicate that locking
discipline evolved out of the pre-VFS way of doing inode locking.
In addition, the current locking discipline may actually save
lines of code, esp. if the number of file systems is fewer
-then the number of call sites.
+than the number of call sites.
However, the VFS interface would
require less wizardry if the locking discipline were simpler.
.Pp
@@ -112,6 +119,8 @@ The security checks can be moved into the individual file systems.
Each file system can have the responsibility of ensuring that vnode
operations are suitably atomic.
.Pp
-The LK_NOWAIT flag does prevent the caller from sleeping.
+The
+.Dv LK_NOWAIT
+flag does prevent the caller from sleeping.
.Pp
The locking discipline as it relates to shared locks has yet to be defined.
diff --git a/share/man/man9/vput.9 b/share/man/man9/vput.9
index 583d1c33e64..06f287e8cbb 100644
--- a/share/man/man9/vput.9
+++ b/share/man/man9/vput.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vput.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vput.9,v 1.4 2004/04/17 20:30:41 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 1996 Doug Rabson
@@ -34,7 +34,7 @@
.Dt VPUT 9
.Sh NAME
.Nm vput
-.Nd "decrement the use count for a vnode and unlock it"
+.Nd "decrement the reference count for a vnode and unlock it"
.Sh SYNOPSIS
.Fd #include <sys/param.h>
.Fd #include <sys/vnode.h>
@@ -42,18 +42,17 @@
.Fn vput "struct vnode *vp"
.Sh DESCRIPTION
Decrement the
-.Dv v_usecount
-field of a vnode and unlock the vnode
-.Bl -tag -width 2n
-.It Ar vp
-the vnode to decrement
-.El
+.Va v_usecount
+field of the vnode
+.Fa vp
+and unlock the vnode.
.Pp
This operation is functionally equivalent to calling
.Fn VOP_UNLOCK
followed by
.Xr vrele 9 .
.Sh SEE ALSO
+.Xr VOP_UNLOCK 9 ,
.Xr vnode 9 ,
.Xr vref 9 ,
.Xr vrele 9
diff --git a/share/man/man9/vrecycle.9 b/share/man/man9/vrecycle.9
index 98d02013ce4..0a57d08ed3e 100644
--- a/share/man/man9/vrecycle.9
+++ b/share/man/man9/vrecycle.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vrecycle.9,v 1.5 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vrecycle.9,v 1.6 2004/04/17 20:30:41 jmc Exp $
.\"-
.\" Copyright (c) 2002 Peter Werner
.\" All rights reserved.
@@ -30,7 +30,7 @@
.Dt VRECYCLE 9
.Sh NAME
.Nm vrecycle
-.Nd recycle a vnode if its usecount is zero
+.Nd recycle a vnode if its reference count is zero
.Sh SYNOPSIS
.Fd #include <sys/param.h>
.Fd #include <sys/vnode.h>
@@ -43,20 +43,26 @@
.Sh DESCRIPTION
The
.Fn vrecycle
-function places a vnode
+function places the vnode
.Fa vp
on the free list using
.Xr vgonel 9
-if its v_usecount field is zero.
-If the usecount is not zero it simply returns.
-If its usecount is zero and an interlock
+if its
+.Va v_usecount
+field is zero.
+If
+.Va v_usecount
+is non-zero, it simply returns.
+If
+.Va v_usecount
+is zero and an interlock
.Fa inter_lkp
-was passed, this will be unlocked before calling
+was passed, this interlock will be unlocked before calling
.Xr vgonel 9 .
.Sh RETURN VALUES
.Fn vrecycle
will return 1 if the vnode was placed on the free list.
-It will return 0 if the usecount was not zero, and any lock passed in
+It will return 0 if the reference count was non-zero, and any lock passed in
.Fa inter_lkp
will still be locked.
.Sh SEE ALSO
diff --git a/share/man/man9/vref.9 b/share/man/man9/vref.9
index f8496128d96..b4f13f08523 100644
--- a/share/man/man9/vref.9
+++ b/share/man/man9/vref.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vref.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vref.9,v 1.4 2004/04/17 20:30:41 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 1996 Doug Rabson
@@ -42,19 +42,16 @@
.Fn vref "struct vnode *vp"
.Sh DESCRIPTION
Increment the
-.Dv v_usecount
-field of a vnode.
-.Bl -tag -width 2n
-.It Ar vp
-the vnode to increment
-.El
+.Va v_usecount
+field of the vnode specified by
+.Fa vp .
.Pp
Each vnode maintains a reference count of how many parts of the system
are using the vnode.
This allows the system to detect when a vnode is
no longer being used and can be safely recycled for a different file.
.Pp
-Any code in the system which is using a vnode (e.g. during the
+Any code in the system which uses a vnode (e.g. during the
operation of some algorithm or to store in a data structure) should
call
.Fn vref .
diff --git a/share/man/man9/vrele.9 b/share/man/man9/vrele.9
index 4d843d88f53..b447ae06dbd 100644
--- a/share/man/man9/vrele.9
+++ b/share/man/man9/vrele.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vrele.9,v 1.3 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vrele.9,v 1.4 2004/04/17 20:30:41 jmc Exp $
.\" -*- nroff -*-
.\"
.\" Copyright (c) 1996 Doug Rabson
@@ -42,19 +42,16 @@
.Fn vrele "struct vnode *vp"
.Sh DESCRIPTION
Decrement the
-.Dv v_usecount
-field of a vnode.
-.Bl -tag -width 2n
-.It Ar vp
-the vnode to decrement
-.El
+.Fa v_usecount
+field of the vnode specified by
+.Fa vp .
.Pp
-Any code in the system which is using a vnode should call
+Any code in the system which uses a vnode should call
.Fn vrele
when it is finished with the vnode.
If the
-.Dv v_usecount
-field of the vnode reaches zero, then it will be placed on the free list.
+.Va v_usecount
+field of the vnode reaches zero, the vnode will be placed on the free list.
.Sh SEE ALSO
.Xr vget 9 ,
.Xr vnode 9 ,
diff --git a/share/man/man9/vwaitforio.9 b/share/man/man9/vwaitforio.9
index f0c7f06c883..d548c16c5f0 100644
--- a/share/man/man9/vwaitforio.9
+++ b/share/man/man9/vwaitforio.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: vwaitforio.9,v 1.9 2003/06/06 20:56:32 jmc Exp $
+.\" $OpenBSD: vwaitforio.9,v 1.10 2004/04/17 20:30:41 jmc Exp $
.\"
.\" Copyright (c) 2001 Constantine Sapuntzakis
.\" All rights reserved.
@@ -38,29 +38,34 @@
The
.Fn vwaitforio
call sleeps until all asynchronous writes associated with the vnode
-.Nm vp
+.Fa vp
finish.
This is used by functions that need to make sure
that the writes they initiated have completed.
.Pp
The
.Fn vwaitforio
-call sleeps at PRIBIO + 1.
+call sleeps at priority
+.Dv PRIBIO
++ 1 .
The
-.Nm slpflag ,
-.Nm wmesg
+.Fa slpflag ,
+.Fa wmesg ,
and
-.Nm slptimeo
-flags indicate flags to be passed to
+.Fa slptimeo
+arguments indicate flags to be passed to
.Xr tsleep 9 .
.Pp
-This function must be called at splbio().
+This function must be called at
+.Xr splbio 9 .
.Pp
It may be important to ensure that no other process submits asynchronous
writes while a process is waiting for I/O on this vnode.
-Otherwise, vwaitforio may never return.
-.Pp
-(Vnode interlock??)
+Otherwise,
+.Fn vwaitforio
+may never return.
+.\" .Pp
+.\" (Vnode interlock??)
.Sh RETURN VALUES
The
.Fn vwaitforio