[src/trunk]: src/share/man/man9 Document isa_drq_alloc/free.

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

details:   https://anonhg.NetBSD.org/src/rev/5542331adbce
branches:  trunk
changeset: 546958:5542331adbce
user:      fvdl <fvdl%NetBSD.org@localhost>
date:      Sat May 10 00:02:22 2003 +0000

description:
Document isa_drq_alloc/free.

diffstat:

 share/man/man9/isa.9 |  21 ++++++++++++++++++++-
 1 files changed, 20 insertions(+), 1 deletions(-)

diffs (49 lines):

diff -r f0e92c4e13fb -r 5542331adbce share/man/man9/isa.9
--- a/share/man/man9/isa.9      Fri May 09 23:51:25 2003 +0000
+++ b/share/man/man9/isa.9      Sat May 10 00:02:22 2003 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: isa.9,v 1.10 2003/04/16 13:35:29 wiz Exp $
+.\"     $NetBSD: isa.9,v 1.11 2003/05/10 00:02:22 fvdl Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -56,6 +56,8 @@
 .Nm isa_dmacount ,
 .Nm isa_dmadone ,
 .Nm isa_dmamaxsize ,
+.Nm isa_drq_alloc ,
+.Nm isa_drq_free ,
 .Nm isa_drq_isfree ,
 .Nm isa_dmacascade ,
 .Nm isa_mappage
@@ -110,6 +112,10 @@
 .Ft bus_size_t
 .Fn isa_dmamaxsize "isa_chipset_tag_t ic" "int chan"
 .Ft int
+.Fn isa_drq_alloc "isa_chipset_tag_t ic" "int chan"
+.Ft int
+.Fn isa_drq_free "isa_chipset_tag_t ic" "int chan"
+.Ft int
 .Fn isa_drq_isfree "isa_chipset_tag_t ic" "int chan"
 .Ft int
 .Fn isa_dmacascade "isa_chipset_tag_t ic" "int chan"
@@ -205,6 +211,19 @@
 .Fa ih .
 The handle was returned from
 .Fn isa_intr_establish .
+.It Fn isa_drq_alloc "ic" "chan"
+Reserves the DMA channel
+.Fa chan
+for future use.
+Normally, this call precedes an
+.Fn isa_dmamap_create
+call. It is an error to start DMA on a channel that has not been reserved
+with
+.Fn isa_drq_alloc .
+.It Fn isa_drq_free "ic" "chan"
+Marks the DMA channel
+.Fa chan
+as available again.
 .It Fn isa_dmamap_create "ic" "chan" "size" "flags"
 Creates a DMA map for channel
 .Fa chan .