xref: /netbsd-src/share/man/man4/pad.4 (revision 274254cdae52594c1aa480a736aef78313d15c9c)
1.\" $NetBSD: pad.4,v 1.1 2007/11/11 17:45:19 jmcneill Exp $
2.\"
3.\" Copyright (c) 2007 Jared D. McNeill <jmcneill@invisible.ca>
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"        This product includes software developed by Jared D. McNeill.
17.\" 4. Neither the name of The NetBSD Foundation nor the names of its
18.\"    contributors may be used to endorse or promote products derived
19.\"    from this software without specific prior written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
22.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
23.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
25.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31.\" POSSIBILITY OF SUCH DAMAGE.
32.\"
33.Dd November 11, 2007
34.Dt PAD 4
35.Os
36.Sh NAME
37.Nm pad
38.Nd Pseudo audio device driver
39.Sh SYNOPSIS
40.Cd "pseudo-device pad"
41.Cd "audio* at audiobus?"
42.Sh DESCRIPTION
43.Nm
44is a pseudo-device driver which provides support for feeding back PCM data
45from a consumer of the
46.Xr audio 4
47API to userland.
48.Sh EXAMPLES
49The following example streams an MP3 to an Apple AirTunes compatible device:
50.Bd -literal -offset indent
51$ rtunes - < /dev/pad0 &
52$ mpg123 -a /dev/sound1 mozart.mp3
53.Ed
54.Sh FILES
55The
56.Nm
57pseudo-device driver receives data from
58.Pa /dev/soundN
59and feeds the raw PCM output to
60.Pa /dev/padN .
61.Bl -item
62.It
63.Pa /dev/soundN
64.It
65.Pa /dev/padN
66.El
67.Sh SEE ALSO
68.Xr audio 4
69.Sh HISTORY
70The
71.Nm
72driver
73appeared in
74.Nx 5.0 .
75.Sh AUTHORS
76.An Jared D. McNeill Aq jmcneill@invisible.ca
77