summaryrefslogtreecommitdiff
path: root/man/padsp.1.xml.in
blob: 2ee1e117553c82f69b32b2ab7dcc78023f65ac47 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
<?xml version="1.0"?><!--*-nxml-*-->
<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>

<!--
This file is part of PulseAudio.

PulseAudio is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of the
License, or (at your option) any later version.

PulseAudio is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with PulseAudio; if not, see <http://www.gnu.org/licenses/>.
-->

<manpage name="padsp" section="1" desc="PulseAudio OSS Wrapper">

  <synopsis>
    <cmd>padsp [<arg>options</arg>] <arg>PROGRAM</arg> [<arg>ARGUMENTS ...</arg>]</cmd>
    <cmd>padsp <opt>-h</opt></cmd>
  </synopsis>

  <description>
    <p><file>padsp</file> starts the specified program and
    redirects its access to OSS compatible audio devices
    (<file>/dev/dsp</file> and auxiliary devices) to a PulseAudio
    sound server.</p>

    <p><file>padsp</file> uses the $LD_PRELOAD environment variable
    that is interpreted by <manref name="ld.so" section="8"/> and thus
    does not work for SUID binaries and statically built
    executables.</p>

    <p>Equivalent to using <file>padsp</file> is starting an
    application with $LD_PRELOAD set to
    <file>libpulsedsp.so</file></p>
  </description>

  <options>

    <option>
      <p><opt>-h | --help</opt></p>

      <optdesc><p>Show help.</p></optdesc>
    </option>


    <option>
      <p><opt>-s</opt> <arg>SERVER</arg></p>

      <optdesc><p>Set the PulseAudio server to connect to.</p></optdesc>
    </option>

    <option>
      <p><opt>-n</opt> <arg>NAME</arg></p>

      <optdesc><p>The client application name that shall be passed to the server when connecting.</p></optdesc>
    </option>

    <option>
      <p><opt>-m</opt> <arg>NAME</arg></p>

      <optdesc><p>The stream name that shall be passed to the server when creating a stream.</p></optdesc>
    </option>

    <option>
      <p><opt>-M</opt></p>

      <optdesc><p>Disable <file>/dev/mixer</file> emulation.</p></optdesc>
    </option>

    <option>
      <p><opt>-S</opt></p>

      <optdesc><p>Disable <file>/dev/sndstat</file> emulation.</p></optdesc>
    </option>

    <option>
      <p><opt>-D</opt></p>

      <optdesc><p>Disable <file>/dev/dsp</file> emulation.</p></optdesc>
    </option>

    <option>
      <p><opt>-d</opt></p>

      <optdesc><p>Enable debug output.</p></optdesc>
    </option>

  </options>

  <section name="Authors">
    <p>The PulseAudio Developers &lt;@PACKAGE_BUGREPORT@&gt;; PulseAudio is available from <url href="@PACKAGE_URL@"/></p>
  </section>

  <section name="See also">
    <p>
      <manref name="pulseaudio" section="1"/>, <manref name="pasuspender" section="1"/>, <manref name="ld.so" section="8"/>
    </p>
  </section>

</manpage>