[src/trunk]: src/share/man/man9 update audio(9) docs for audiomp changes

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

details:   https://anonhg.NetBSD.org/src/rev/f16562dc7387
branches:  trunk
changeset: 771505:f16562dc7387
user:      jmcneill <jmcneill%NetBSD.org@localhost>
date:      Wed Nov 23 23:11:56 2011 +0000

description:
update audio(9) docs for audiomp changes

diffstat:

 share/man/man9/audio.9 |  20 +++++---------------
 1 files changed, 5 insertions(+), 15 deletions(-)

diffs (48 lines):

diff -r bd153de94c11 -r f16562dc7387 share/man/man9/audio.9
--- a/share/man/man9/audio.9    Wed Nov 23 23:07:28 2011 +0000
+++ b/share/man/man9/audio.9    Wed Nov 23 23:11:56 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: audio.9,v 1.42 2008/04/30 13:10:58 martin Exp $
+.\"    $NetBSD: audio.9,v 1.43 2011/11/23 23:11:56 jmcneill Exp $
 .\"
 .\" Copyright (c) 1999, 2000 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 November 10, 2007
+.Dd November 23, 2011
 .Dt AUDIO 9
 .Os
 .Sh NAME
@@ -87,9 +87,7 @@
        int     (*trigger_input)(void *, void *, void *, int,
                    void (*)(void *), void *, const audio_params_t *);
        int     (*dev_ioctl)(void *, u_long, void *, int, struct lwp *);
-       int     (*powerstate)(void *, int);
-#define        AUDIOPOWER_ON   1
-#define        AUDIOPOWER_OFF  0
+       void    (*get_locks)(void *, kmutex_t **, kmutex_t **);
 };
 
 typedef struct audio_params {
@@ -505,16 +503,8 @@
 .Xr ioctl 2
 is not recognized by the generic audio driver.
 Return 0 on success, otherwise an error code.
-.It Dv int powerstate(void *hdl, int state)
-.Pp
-optional, is called on the first open and last close of the audio
-device.
-.Va state
-may be one of
-.Dv AUDIOPOWER_ON
-or
-.Dv AUDIOPOWER_OFF .
-Returns 0 on success, otherwise an error code.
+.It Dv void get_locks(void *hdl, kmutex_t **intr, kmutex_t **thread)
+Returns the interrupt and thread locks to the common audio layer.
 .El
 .Pp
 The