]> code.delx.au - pulseaudio/blob - man/padsp.1.xml.in
pactl: Stop parsing option when the first non-option is encountered
[pulseaudio] / man / padsp.1.xml.in
1 <?xml version="1.0"?><!--*-nxml-*-->
2 <!DOCTYPE manpage SYSTEM "xmltoman.dtd">
3 <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
4
5 <!--
6 This file is part of PulseAudio.
7
8 PulseAudio is free software; you can redistribute it and/or modify it
9 under the terms of the GNU Lesser General Public License as
10 published by the Free Software Foundation; either version 2.1 of the
11 License, or (at your option) any later version.
12
13 PulseAudio is distributed in the hope that it will be useful, but WITHOUT
14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
15 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
16 Public License for more details.
17
18 You should have received a copy of the GNU Lesser General Public
19 License along with PulseAudio; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
21 USA.
22 -->
23
24 <manpage name="padsp" section="1" desc="PulseAudio OSS Wrapper">
25
26 <synopsis>
27 <cmd>padsp [<arg>options</arg>] <arg>PROGRAM</arg> [<arg>ARGUMENTS ...</arg>]</cmd>
28 <cmd>padsp <opt>-h</opt></cmd>
29 </synopsis>
30
31 <description>
32 <p><file>padsp</file> starts the specified program and
33 redirects its access to OSS compatible audio devices
34 (<file>/dev/dsp</file> and auxiliary devices) to a PulseAudio
35 sound server.</p>
36
37 <p><file>padsp</file> uses the $LD_PRELOAD environment variable
38 that is interpreted by <manref name="ld.so" section="8"/> and thus
39 does not work for SUID binaries and statically built
40 executables.</p>
41
42 <p>Equivalent to using <file>padsp</file> is starting an
43 application with $LD_PRELOAD set to
44 <file>libpulsedsp.so</file></p>
45 </description>
46
47 <options>
48
49 <option>
50 <p><opt>-h | --help</opt></p>
51
52 <optdesc><p>Show help.</p></optdesc>
53 </option>
54
55
56 <option>
57 <p><opt>-s</opt> <arg>SERVER</arg></p>
58
59 <optdesc><p>Set the PulseAudio server to connect to.</p></optdesc>
60 </option>
61
62 <option>
63 <p><opt>-n</opt> <arg>NAME</arg></p>
64
65 <optdesc><p>The client application name that shall be passed to the server when connecting.</p></optdesc>
66 </option>
67
68 <option>
69 <p><opt>-m</opt> <arg>NAME</arg></p>
70
71 <optdesc><p>The stream name that shall be passed to the server when creating a stream.</p></optdesc>
72 </option>
73
74 <option>
75 <p><opt>-M</opt></p>
76
77 <optdesc><p>Disable <file>/dev/mixer</file> emulation.</p></optdesc>
78 </option>
79
80 <option>
81 <p><opt>-S</opt></p>
82
83 <optdesc><p>Disable <file>/dev/sndstat</file> emulation.</p></optdesc>
84 </option>
85
86 <option>
87 <p><opt>-D</opt></p>
88
89 <optdesc><p>Disable <file>/dev/dsp</file> emulation.</p></optdesc>
90 </option>
91
92 <option>
93 <p><opt>-d</opt></p>
94
95 <optdesc><p>Enable debug output.</p></optdesc>
96 </option>
97
98 </options>
99
100 <section name="Authors">
101 <p>The PulseAudio Developers &lt;@PACKAGE_BUGREPORT@&gt;; PulseAudio is available from <url href="@PACKAGE_URL@"/></p>
102 </section>
103
104 <section name="See also">
105 <p>
106 <manref name="pulseaudio" section="1"/>, <manref name="pasuspender" section="1"/>, <manref name="ld.so" section="8"/>
107 </p>
108 </section>
109
110 </manpage>