[src/trunk]: src/share/man/man9 Describe some of the expected return codes fr...

[dyoung <dyoung%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a5256b7d94b8
branches:  trunk
changeset: 767093:a5256b7d94b8
user:      dyoung <dyoung%NetBSD.org@localhost>
date:      Fri Jul 08 22:38:08 2011 +0000

description:
Describe some of the expected return codes from bus_dmamap_load(9).

diffstat:

 share/man/man9/bus_dma.9 |  15 +++++++++++++--
 1 files changed, 13 insertions(+), 2 deletions(-)

diffs (36 lines):

diff -r 5c52bf981fc1 -r a5256b7d94b8 share/man/man9/bus_dma.9
--- a/share/man/man9/bus_dma.9  Fri Jul 08 20:59:53 2011 +0000
+++ b/share/man/man9/bus_dma.9  Fri Jul 08 22:38:08 2011 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: bus_dma.9,v 1.55 2011/07/01 22:06:19 dyoung Exp $
+.\" $NetBSD: bus_dma.9,v 1.56 2011/07/08 22:38:08 dyoung Exp $
 .\"
 .\" Copyright (c) 1996, 1997, 1998, 2001, 2005, 2006 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -28,7 +28,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd July 1, 2011
+.Dd July 8, 2011
 .Dt BUS_DMA 9
 .Os
 .Sh NAME
@@ -327,6 +327,17 @@
 .Fn bus_dmamap_load .
 .Pp
 Returns 0 on success, or an error code to indicate mode of failure.
+Possible error codes include the following:
+.Pp
+.Bl -tag -width dmam -compact
+.It Er EINVAL
+.Fa buflen
+is too large for the DMA map. 
+.It Er EFBIG
+Too many segments.
+.It Er ENOMEM
+Could not allocate memory for, e.g., a bounce buffer.
+.El
 .It Fn bus_dmamap_load_mbuf "tag" "dmam" "chain" "flags"
 This is a variation of
 .Fn bus_dmamap_load