summaryrefslogtreecommitdiffstats
path: root/share/man/man9/physio.9
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>2000-03-03 14:05:08 +0000
committersheldonh <sheldonh@FreeBSD.org>2000-03-03 14:05:08 +0000
commit88dd9b4faa11f5f0aa21cbd43fb72503a67b4229 (patch)
tree69062af71195d869d2c940c1869ddf1621cbabfb /share/man/man9/physio.9
parent1b7dce690e9fb2a298fb1e3bedc8186e71b877a3 (diff)
downloadFreeBSD-src-88dd9b4faa11f5f0aa21cbd43fb72503a67b4229.zip
FreeBSD-src-88dd9b4faa11f5f0aa21cbd43fb72503a67b4229.tar.gz
Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
Diffstat (limited to 'share/man/man9/physio.9')
-rw-r--r--share/man/man9/physio.918
1 files changed, 12 insertions, 6 deletions
diff --git a/share/man/man9/physio.9 b/share/man/man9/physio.9
index 02114fa..27eb6d3 100644
--- a/share/man/man9/physio.9
+++ b/share/man/man9/physio.9
@@ -53,7 +53,8 @@
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. It calls back on the
+routines to start 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
@@ -62,7 +63,8 @@ The maximum amount of data to transfer with each call to
.Fa strategy
is determined by the
.Fa minphys
-routine. Since
+routine.
+Since
.Fa uio
normally describes user space addresses,
.Fn physio
@@ -71,7 +73,8 @@ needs to lock the process into memory. This is done by setting the
flag on the process.
.Fn physio
always awaits the completion of the entire requested transfer before
-returning, unless an error condition is detected earlier. In all cases,
+returning, unless an error condition is detected earlier.
+In all cases,
the buffer passed in
.Fa bp
is locked (marked as
@@ -84,11 +87,13 @@ A break-down of the arguments follows:
The device strategy routine to call for each chunk of data to initiate
device I/O.
.It Fa bp
-The buffer to use with the strategy routine. The buffer flags will have
+The buffer to use with the strategy routine.
+The buffer flags will have
.Dv B_BUSY ,
and
.Dv B_PHYS
-set when passed to the strategy routine. If
+set when passed to the strategy routine.
+If
.Dv NULL ,
a buffer is allocated from a system pool.
.It Fa dev
@@ -126,7 +131,8 @@ by examining the
.Dv B_ERROR
buffer flag and the
.Va b_error
-field. Note that the actual transfer size may be less than requested by
+field.
+Note that the actual transfer size may be less than requested by
.Fa uio
if the device signals an
.Dq end of file
OpenPOWER on IntegriCloud