Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/share/man/man9 Minor markup nits.
details: https://anonhg.NetBSD.org/src/rev/3f462188d701
branches: trunk
changeset: 753890:3f462188d701
user: jruoho <jruoho%NetBSD.org@localhost>
date: Tue Apr 13 10:06:43 2010 +0000
description:
Minor markup nits.
diffstat:
share/man/man9/physio.9 | 20 +++++++++++++-------
1 files changed, 13 insertions(+), 7 deletions(-)
diffs (67 lines):
diff -r 03ccb1b093b0 -r 3f462188d701 share/man/man9/physio.9
--- a/share/man/man9/physio.9 Tue Apr 13 09:57:05 2010 +0000
+++ b/share/man/man9/physio.9 Tue Apr 13 10:06:43 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: physio.9,v 1.10 2008/04/30 13:10:58 martin Exp $
+.\" $NetBSD: physio.9,v 1.11 2010/04/13 10:06:43 jruoho Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd June 15, 1996
+.Dd April 13, 2010
.Dt PHYSIO 9
.Os
.Sh NAME
@@ -47,7 +47,9 @@
The
.Fn physio
is a helper function typically called from character device read and write
-routines to start I/O on a user process buffer.
+routines to start
+.Tn I/O
+on a user process buffer.
It calls back on the provided
.Fa strategy
routine one or more times to complete the transfer described by
@@ -57,18 +59,21 @@
is determined by the
.Fa minphys
routine.
+.Pp
Since
.Fa uio
normally describes user space addresses,
.Fn physio
needs to lock the appropriate data area into memory before each transaction
with
-.Fa strategy ( see
+.Fa strategy
+(see
.Xr uvm_vslock 9
and
.Xr uvm_vsunlock 9 ) .
+The
.Fn physio
-always awaits the completion of the entire requested transfer before
+function always awaits the completion of the entire requested transfer before
returning, unless an error condition is detected earlier.
In all cases, the buffer passed in
.Fa bp
@@ -77,10 +82,11 @@
for the duration of the entire transfer.
.Pp
A break-down of the arguments follows:
-.Bl -tag -width indent
+.Bl -tag -width "strategy "
.It Fa strategy
The device strategy routine to call for each chunk of data to initiate
-device I/O.
+device
+.Tn I/O .
.It Fa bp
The buffer to use with the strategy routine.
The buffer flags will have
Home |
Main Index |
Thread Index |
Old Index