share/man/man4/pad.4

   1 .\" $NetBSD: pad.4,v 1.2 2009/05/18 12:06:01 wiz 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 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .Dd November 11, 2007
  28 .Dt PAD 4
  29 .Os
  30 .Sh NAME
  31 .Nm pad
  32 .Nd Pseudo audio device driver
  33 .Sh SYNOPSIS
  34 .Cd "pseudo-device pad"
  35 .Cd "audio* at audiobus?"
  36 .Sh DESCRIPTION
  37 .Nm
  38 is a pseudo-device driver which provides support for feeding back PCM data
  39 from a consumer of the
  40 .Xr audio 4
  41 API to userland.
  42 .Sh FILES
  43 The
  44 .Nm
  45 pseudo-device driver receives data from
  46 .Pa /dev/soundN
  47 and feeds the raw PCM output to
  48 .Pa /dev/padN .
  49 .Bl -item
  50 .It
  51 .Pa /dev/soundN
  52 .It
  53 .Pa /dev/padN
  54 .El
  55 .Sh EXAMPLES
  56 The following example streams an MP3 to an Apple AirTunes compatible device:
  57 .Bd -literal -offset indent
  58 $ rtunes - \*[Lt] /dev/pad0 \*[Am]
  59 $ mpg123 -a /dev/sound1 mozart.mp3
  60 .Ed
  61 .Sh SEE ALSO
  62 .Xr audio 4
  63 .Sh HISTORY
  64 The
  65 .Nm
  66 driver
  67 appeared in
  68 .Nx 5.0 .
  69 .Sh AUTHORS
  70 .An Jared D. McNeill Aq jmcneill@invisible.ca