source: multimedia/libdriv/pulseaudio.xml@ 98e2adf

10.0 10.1 11.0 7.10 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 98e2adf was 98e2adf, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

Fix URL: avahi, libasyncns (at pulseaudio page), libatasmart, libcanberra, libdaemon and mod_dnssd.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@13938 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 13.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY pulseaudio-download-http
8 "http://freedesktop.org/software/pulseaudio/releases/pulseaudio-&pulseaudio-version;.tar.xz">
9 <!ENTITY pulseaudio-download-ftp " ">
10 <!ENTITY pulseaudio-md5sum "c43749838612f4860465e83ed62ca38e">
11 <!ENTITY pulseaudio-size "1.4 MB">
12 <!ENTITY pulseaudio-buildsize "82 MB">
13 <!ENTITY pulseaudio-time "1.0 SBU">
14]>
15
16<sect1 id="pulseaudio" xreflabel="PulseAudio-&pulseaudio-version;">
17 <?dbhtml filename="pulseaudio.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>PulseAudio-&pulseaudio-version;</title>
25
26 <indexterm zone="pulseaudio">
27 <primary sortas="a-PulseAudio">PulseAudio</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to PulseAudio</title>
32
33 <para>
34 <application>PulseAudio</application> is a sound system for POSIX OSes,
35 meaning that it is a proxy for sound applications. It allows you to do
36 advanced operations on your sound data as it passes between your application
37 and your hardware. Things like transferring the audio to a different machine,
38 changing the sample format or channel count and mixing several sounds into
39 one are easily achieved using a sound server.
40 </para>
41
42 &lfs75_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&pulseaudio-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&pulseaudio-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &pulseaudio-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &pulseaudio-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &pulseaudio-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &pulseaudio-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">PulseAudio Dependencies</bridgehead>
79
80 <bridgehead renderas="sect4">Required</bridgehead>
81 <para role="required">
82 <xref linkend="json-c"/> and
83 <xref linkend="libsndfile"/>
84 </para>
85
86 <bridgehead renderas="sect4">Recommended</bridgehead>
87 <para role="recommended">
88 <xref linkend="alsa-lib"/>,
89 <xref linkend="dbus"/>,
90 <xref linkend="glib2"/>,
91 <xref linkend="libcap-pam"/>,
92 <xref linkend="openssl"/>,
93 <xref linkend="speex"/> and
94 <xref linkend="xorg7-lib"/>
95 </para>
96
97 <bridgehead renderas="sect4">Optional</bridgehead>
98 <para role="optional">
99 <xref linkend="avahi"/>,
100 <xref linkend="bluez"/> (runtime),
101 <xref linkend="check"/>,
102 <xref linkend="GConf"/>,
103 <xref linkend="gtk3"/>,
104 <xref linkend="libsamplerate"/>,
105 <xref linkend="sbc"/> (Bluetooth support),
106 <xref linkend="valgrind"/>,
107 <ulink url="http://www.fftw.org/">FFTW</ulink>,
108 <ulink url="http://www.jackaudio.org/">JACK</ulink>,
109<!-- <ulink url="http://0pointer.de/lennart/projects/libasyncns/">libasyncns</ulink>,-->
110 <ulink url="&fedora-http-repo;/libasyncns/">libasyncns</ulink>,
111 <ulink url="http://www.lirc.org/">LIRC</ulink>,
112 <ulink url="http://code.entropywave.com/projects/orc/">ORC</ulink>,
113 <ulink url="http://tdb.samba.org/">TDB</ulink>,
114 <ulink url="http://freedesktop.org/software/pulseaudio/webrtc-audio-processing/">
115 WebRTC AudioProcessing</ulink> and
116 <ulink url="http://www.xen.org/">XEN</ulink>
117 </para>
118
119 <para condition="html" role="usernotes">User Notes:
120 <ulink url="&blfs-wiki;/pulseaudio"/>
121 </para>
122 </sect2>
123
124 <sect2 role="installation">
125 <title>Installation of PulseAudio</title>
126
127 <para>
128 Install <application>PulseAudio</application> by running the following
129 commands:
130 </para>
131
132<screen><userinput>find . -name "Makefile.in" | xargs sed -i "s|(libdir)/@PACKAGE@|(libdir)/pulse|" &amp;&amp;
133./configure --prefix=/usr \
134 --sysconfdir=/etc \
135 --localstatedir=/var \
136 --disable-bluez4 \
137 --disable-rpath \
138 --with-module-dir=/usr/lib/pulse/modules &amp;&amp;
139make</userinput></screen>
140
141 <para>
142 To test the results, issue: <command>make check</command>.
143 </para>
144
145 <para>
146 Now, as the <systemitem class="username">root</systemitem> user:
147 </para>
148
149<screen role="root"><userinput>make install</userinput></screen>
150
151 <!-- http://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/SystemWide/ -->
152 <para>
153 While still as the <systemitem class="username">root</systemitem>
154 user, remove the <application>D-Bus</application> configuration file
155 for the system wide daemon to avoid creating unnecessary system
156 users and groups:
157 </para>
158
159<screen role="root"><userinput>rm /etc/dbus-1/system.d/pulseaudio-system.conf</userinput></screen>
160
161 </sect2>
162
163 <sect2 role="commands">
164 <title>Command Explanations</title>
165
166 <para>
167 <command>find . -name Makefile.in ...</command>: This sed changes
168 the build system to install <application>PulseAudio</application>
169 private libraries into
170 <filename class="directory">/usr/lib/pulse</filename> instead of
171 <filename class="directory">/usr/lib/pulseaudio</filename>.
172 </para>
173
174 <para>
175 <parameter>--disable-bluez4</parameter>: This switch disables
176 support for <application>BlueZ</application> version 4 in favour
177 of <application>BlueZ</application> version 5 since the latter
178 also installs compatibility library for the earlier version.
179 </para>
180
181 <para>
182 <parameter>--disable-rpath</parameter>: This switch prevents
183 linker from adding a hardcoded runtime path to the installed
184 programs and libraries.
185 </para>
186
187 <para>
188 <parameter>--with-module-dir=/usr/lib/pulse/modules</parameter>:
189 This parameter ensures that <application>PulseAudio</application>
190 modules are installed in <filename class="directory">/usr/lib/pulse/modules
191 </filename> instead of <filename class="directory">
192 /usr/lib/pulse-&pulseaudio-major-version;/modules</filename>.
193 </para>
194
195 </sect2>
196
197 <sect2 role="content">
198 <title>Contents</title>
199
200 <segmentedlist>
201 <segtitle>Installed Programs</segtitle>
202 <segtitle>Installed Libraries</segtitle>
203 <segtitle>Installed Directories</segtitle>
204
205 <seglistitem>
206 <seg>
207 esdcompat, pacat, pacmd, pactl, padsp, pamon (symlink),
208 paplay (symlink), parec (symlink), parecord (symlink), pasuspender,
209 pax11publish, pulseaudio, qpaeq,
210 start-pulseaudio-kde and start-pulseaudio-x11
211 </seg>
212 <seg>
213 libpulsecore-&pulseaudio-major-version;.so, libpulse-mainloop-glib.so,
214 libpulse-simple.so and libpulse.so
215 </seg>
216 <seg>
217 /etc/pulse,
218 /usr/include/pulse,
219 /usr/lib/cmake/PulseAudio,
220 /usr/lib/pulse,
221 /usr/libexec/pulse and
222 /usr/share/pulseaudio
223 </seg>
224 </seglistitem>
225 </segmentedlist>
226
227 <variablelist>
228 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
229 <?dbfo list-presentation="list"?>
230 <?dbhtml list-presentation="table"?>
231
232 <varlistentry id="esdcompat">
233 <term><command>esdcompat</command></term>
234 <listitem>
235 <para>
236 is the <application>PulseAudio</application> ESD wrapper script.
237 </para>
238 <indexterm zone="pulseaudio esdcompat">
239 <primary sortas="b-esdcompat">esdcompat</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="pacat">
245 <term><command>pacat</command></term>
246 <listitem>
247 <para>
248 Plays back or records raw or encoded audio streams on a
249 <application>PulseAudio</application> sound server.
250 </para>
251 <indexterm zone="pulseaudio pacat">
252 <primary sortas="b-pacat">pacat</primary>
253 </indexterm>
254 </listitem>
255 </varlistentry>
256
257 <varlistentry id="pacmd">
258 <term><command>pacmd</command></term>
259 <listitem>
260 <para>
261 is a tool used to reconfigure a <application>PulseAudio</application>
262 sound server during runtime.
263 </para>
264 <indexterm zone="pulseaudio pacmd">
265 <primary sortas="b-pacmd">pacmd</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="pactl">
271 <term><command>pactl</command></term>
272 <listitem>
273 <para>
274 is used to control a running <application>PulseAudio</application>
275 sound server.
276 </para>
277 <indexterm zone="pulseaudio pactl">
278 <primary sortas="b-pactl">pactl</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="padsp">
284 <term><command>padsp</command></term>
285 <listitem>
286 <para>
287 is the <application>PulseAudio</application> OSS Wrapper.
288 </para>
289 <indexterm zone="pulseaudio padsp">
290 <primary sortas="b-padsp">padsp</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 <varlistentry id="pamon">
296 <term><command>pamon</command></term>
297 <listitem>
298 <para>
299 is a symbolic link to <command>pacat</command>.
300 </para>
301 <indexterm zone="pulseaudio pamon">
302 <primary sortas="b-pamon">pamon</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 <varlistentry id="paplay">
308 <term><command>paplay</command></term>
309 <listitem>
310 <para>
311 is used to play audio files on a
312 <application>PulseAudio</application> sound server.
313 </para>
314 <indexterm zone="pulseaudio paplay">
315 <primary sortas="b-paplay">paplay</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 <varlistentry id="parec">
321 <term><command>parec</command></term>
322 <listitem>
323 <para>
324 is a symbolic link to <command>pacat</command>.
325 </para>
326 <indexterm zone="pulseaudio parec">
327 <primary sortas="b-parec">parec</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="parecord">
333 <term><command>parecord</command></term>
334 <listitem>
335 <para>
336 is a symbolic link to <command>pacat</command>.
337 </para>
338 <indexterm zone="pulseaudio parecord">
339 <primary sortas="b-parecord">parecord</primary>
340 </indexterm>
341 </listitem>
342 </varlistentry>
343
344 <varlistentry id="pasuspender">
345 <term><command>pasuspender</command></term>
346 <listitem>
347 <para>
348 is a tool that can be used to tell a local
349 <application>PulseAudio</application> sound server to temporarily
350 suspend access to the audio devices, to allow other applications
351 to access them directly.
352 </para>
353 <indexterm zone="pulseaudio pasuspender">
354 <primary sortas="b-pasuspender">pasuspender</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="pax11publish">
360 <term><command>pax11publish</command></term>
361 <listitem>
362 <para>
363 is the <application>PulseAudio</application>
364 X11 Credential Utility.
365 </para>
366 <indexterm zone="pulseaudio pax11publish">
367 <primary sortas="b-pax11publish">pax11publish</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="pulseaudio-prog">
373 <term><command>pulseaudio</command></term>
374 <listitem>
375 <para>
376 is a networked low-latency sound server for Linux.
377 </para>
378 <indexterm zone="pulseaudio pulseaudio-prog">
379 <primary sortas="b-pulseaudio">pulseaudio</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="qpaeq">
385 <term><command>qpaeq</command></term>
386 <listitem>
387 <para>
388 is an equalizer interface for
389 <application>PulseAudio</application> equalizer sinks.
390 </para>
391 <indexterm zone="pulseaudio qpaeq">
392 <primary sortas="b-qpaeq">qpaeq</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="start-pulseaudio-kde">
398 <term><command>start-pulseaudio-kde</command></term>
399 <listitem>
400 <para>
401 Starts <application>PulseAudio</application> and loads
402 module-device-manager to use KDE routing policies.
403 </para>
404 <indexterm zone="pulseaudio start-pulseaudio-kde">
405 <primary sortas="b-start-pulseaudio-kde">start-pulseaudio-kde</primary>
406 </indexterm>
407 </listitem>
408 </varlistentry>
409
410 <varlistentry id="start-pulseaudio-x11">
411 <term><command>start-pulseaudio-x11</command></term>
412 <listitem>
413 <para>
414 Starts <application>PulseAudio</application> and registers it to
415 the X11 session manager.
416 </para>
417 <indexterm zone="pulseaudio start-pulseaudio-x11">
418 <primary sortas="b-start-pulseaudio-x11">start-pulseaudio-x11</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 </variablelist>
424
425 </sect2>
426
427</sect1>
Note: See TracBrowser for help on using the repository browser.