source: multimedia/libdriv/pulseaudio.xml@ 209b020

10.0 10.1 11.0 11.1 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 209b020 was 209b020, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to pulseaudio-7.1.
Update to bluez-5.36.

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

  • Property mode set to 100644
File size: 15.5 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 "9d0a9817b632cac8e3f3834d7eb1c99d">
11 <!ENTITY pulseaudio-size "1.4 MB">
12 <!ENTITY pulseaudio-buildsize "91 MB (additional 20 MB for tests)">
13 <!ENTITY pulseaudio-time "1.7 SBU (additional 0.8 SBU for tests)">
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
37 application and your hardware. Things like transferring the audio to a
38 different machine, changing the sample format or channel count and mixing
39 several sounds into one are easily achieved using a sound server.
40 </para>
41
42 &lfs78_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="consolekit"/> (runtime),
103 <xref linkend="GConf"/>,
104 <xref linkend="gtk3"/>,
105 <xref linkend="libsamplerate"/>,
106 <xref linkend="sbc"/> (Bluetooth support),
107 <xref linkend="valgrind"/>,
108 <ulink url="http://www.fftw.org/">FFTW</ulink>,
109 <ulink url="http://www.jackaudio.org/">JACK</ulink>,
110 <ulink url="http://0pointer.de/lennart/projects/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 <note><para>The build procedure emits a lot of invalid warnings.
128 If desired, remove them with:</para>
129
130<screen><userinput>sed -i "/seems to be moved/s/^/#/" build-aux/ltmain.sh libtool</userinput></screen>
131 </note>
132
133 <para>
134 Install <application>PulseAudio</application> by running the following
135 commands:
136 </para>
137
138<screen><userinput>./configure --prefix=/usr \
139 --sysconfdir=/etc \
140 --localstatedir=/var \
141 --disable-bluez4 \
142 --disable-rpath &amp;&amp;
143make</userinput></screen>
144
145 <para>
146 To test the results, issue: <command>make check</command>.
147 </para>
148
149 <para>
150 Now, as the <systemitem class="username">root</systemitem> user:
151 </para>
152
153<screen role="root"><userinput>make install</userinput></screen>
154
155 <!-- http://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/SystemWide/ -->
156 <para>
157 While still as the <systemitem class="username">root</systemitem>
158 user, remove the <application>D-Bus</application> configuration file
159 for the system wide daemon to avoid creating unnecessary system
160 users and groups:
161 </para>
162
163<screen role="root"><userinput>rm /etc/dbus-1/system.d/pulseaudio-system.conf</userinput></screen>
164
165 </sect2>
166
167 <sect2 role="commands">
168 <title>Command Explanations</title>
169
170 <para>
171 <parameter>--disable-bluez4</parameter>: This switch disables
172 support for <application>BlueZ</application> version 4 in favour
173 of <application>BlueZ</application> version 5 since the latter
174 also installs compatibility library for the earlier version.
175 </para>
176
177 <para>
178 <parameter>--disable-rpath</parameter>: This switch prevents
179 linker from adding a hardcoded runtime path to the installed
180 programs and libraries.
181 </para>
182
183 </sect2>
184
185 <sect2 role="configuration">
186 <title>Configuring PulseAudio</title>
187
188 <sect3 id="pulseaudio-config">
189 <title>Config Files</title>
190 <para>
191 There are system wide configuration files:
192 <filename>/etc/pulse/daemon.conf</filename>,
193 <filename>/etc/pulse/client.conf</filename>,
194 <filename>/etc/pulse/default.pa</filename>, and user configuration
195 files with the same names in
196 <filename class="directory">~/.config/pulse</filename>. User
197 configuration files take precedence over system wide ones.
198 </para>
199
200 <indexterm zone="pulseaudio pulseaudio-config">
201 <primary sortas="e-AA.config-pulse">~/.config/pulse</primary>
202 </indexterm>
203
204 <indexterm zone="pulseaudio pulseaudio-config">
205 <primary
206 sortas="e-etc-pulse-daemon.conf">/etc/pulse/daemon.conf</primary>
207 </indexterm>
208
209 <indexterm zone="pulseaudio pulseaudio-config">
210 <primary
211 sortas="e-etc-pulse-client.conf">/etc/pulse/client.conf</primary>
212 </indexterm>
213
214 <indexterm zone="pulseaudio pulseaudio-config">
215 <primary
216 sortas="e-etc-pulse-default.pa">/etc/pulse/default.pa</primary>
217 </indexterm>
218 </sect3>
219
220 <sect3><title>Configuration Information</title>
221
222 <para>
223 The default configuration files allow setting up a working installation.
224 However, a reference to Console-Kit needs to be removed if it is
225 not installed. For example, issue the following command as the
226 <systemitem class="username">root</systemitem> user:
227 </para>
228
229<screen role="root"><userinput>sed -i '/load-module module-console-kit/s/^/#/' /etc/pulse/default.pa</userinput></screen>
230
231 <para>
232 You may also have to configure the audio system. You can start
233 <application>pulseaudio</application> in command line mode using
234 <command>pulseaudio -C</command> and then list various
235 information and change settings. See
236 <command>man pulse-cli-syntax</command>.
237 </para>
238 </sect3>
239 </sect2>
240
241 <sect2 role="content">
242 <title>Contents</title>
243
244 <segmentedlist>
245 <segtitle>Installed Programs</segtitle>
246 <segtitle>Installed Libraries</segtitle>
247 <segtitle>Installed Directories</segtitle>
248
249 <seglistitem>
250 <seg>
251 esdcompat, pacat, pacmd, pactl, padsp, pamon (symlink to pacat),
252 paplay (symlink to pacat), parec (symlink to pacat),
253 parecord (symlink to pacat), pasuspender,
254 pax11publish, pulseaudio, and
255 <!-- it looks like the equalizer needs FFTW: qpaeq, -->
256 start-pulseaudio-x11
257 </seg>
258 <seg>
259 libpulse.so,
260 libpulsecommon-7.0.so,
261 libpulsedsp.so,
262 libpulse-mainloop-glib.so,
263 libpulse-simple.so, and
264 libpulsecore-&pulseaudio-major-version;.so
265 </seg>
266 <seg>
267 /etc/pulse,
268 /usr/include/pulse,
269 /usr/lib/{pulseaudio,pulse-7.0},
270 /usr/lib/cmake/PulseAudio,
271 /usr/libexec/pulse, and
272 /usr/share/pulseaudio
273 </seg>
274 </seglistitem>
275 </segmentedlist>
276
277 <variablelist>
278 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
279 <?dbfo list-presentation="list"?>
280 <?dbhtml list-presentation="table"?>
281
282 <varlistentry id="esdcompat">
283 <term><command>esdcompat</command></term>
284 <listitem>
285 <para>
286 is the <application>PulseAudio</application> ESD wrapper script.
287 </para>
288 <indexterm zone="pulseaudio esdcompat">
289 <primary sortas="b-esdcompat">esdcompat</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="pacat">
295 <term><command>pacat</command></term>
296 <listitem>
297 <para>
298 plays back or records raw or encoded audio streams on a
299 <application>PulseAudio</application> sound server.
300 </para>
301 <indexterm zone="pulseaudio pacat">
302 <primary sortas="b-pacat">pacat</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 <varlistentry id="pacmd">
308 <term><command>pacmd</command></term>
309 <listitem>
310 <para>
311 is a tool used to reconfigure a <application>PulseAudio</application>
312 sound server during runtime.
313 </para>
314 <indexterm zone="pulseaudio pacmd">
315 <primary sortas="b-pacmd">pacmd</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 <varlistentry id="pactl">
321 <term><command>pactl</command></term>
322 <listitem>
323 <para>
324 is used to control a running <application>PulseAudio</application>
325 sound server.
326 </para>
327 <indexterm zone="pulseaudio pactl">
328 <primary sortas="b-pactl">pactl</primary>
329 </indexterm>
330 </listitem>
331 </varlistentry>
332
333 <varlistentry id="padsp">
334 <term><command>padsp</command></term>
335 <listitem>
336 <para>
337 is the <application>PulseAudio</application> OSS Wrapper.
338 </para>
339 <indexterm zone="pulseaudio padsp">
340 <primary sortas="b-padsp">padsp</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 <varlistentry id="pamon">
346 <term><command>pamon</command></term>
347 <listitem>
348 <para>
349 is a symbolic link to <command>pacat</command>.
350 </para>
351 <indexterm zone="pulseaudio pamon">
352 <primary sortas="b-pamon">pamon</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="paplay">
358 <term><command>paplay</command></term>
359 <listitem>
360 <para>
361 is used to play audio files on a
362 <application>PulseAudio</application> sound server.
363 </para>
364 <indexterm zone="pulseaudio paplay">
365 <primary sortas="b-paplay">paplay</primary>
366 </indexterm>
367 </listitem>
368 </varlistentry>
369
370 <varlistentry id="parec">
371 <term><command>parec</command></term>
372 <listitem>
373 <para>
374 is a symbolic link to <command>pacat</command>.
375 </para>
376 <indexterm zone="pulseaudio parec">
377 <primary sortas="b-parec">parec</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry id="parecord">
383 <term><command>parecord</command></term>
384 <listitem>
385 <para>
386 is a symbolic link to <command>pacat</command>.
387 </para>
388 <indexterm zone="pulseaudio parecord">
389 <primary sortas="b-parecord">parecord</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="pasuspender">
395 <term><command>pasuspender</command></term>
396 <listitem>
397 <para>
398 is a tool that can be used to tell a local
399 <application>PulseAudio</application> sound server to temporarily
400 suspend access to the audio devices, to allow other applications
401 to access them directly.
402 </para>
403 <indexterm zone="pulseaudio pasuspender">
404 <primary sortas="b-pasuspender">pasuspender</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="pax11publish">
410 <term><command>pax11publish</command></term>
411 <listitem>
412 <para>
413 is the <application>PulseAudio</application>
414 X11 Credential Utility.
415 </para>
416 <indexterm zone="pulseaudio pax11publish">
417 <primary sortas="b-pax11publish">pax11publish</primary>
418 </indexterm>
419 </listitem>
420 </varlistentry>
421
422 <varlistentry id="pulseaudio-prog">
423 <term><command>pulseaudio</command></term>
424 <listitem>
425 <para>
426 is a networked low-latency sound server for Linux.
427 </para>
428 <indexterm zone="pulseaudio pulseaudio-prog">
429 <primary sortas="b-pulseaudio">pulseaudio</primary>
430 </indexterm>
431 </listitem>
432 </varlistentry>
433
434<!-- only installed if FFTW is present
435 <varlistentry id="qpaeq">
436 <term><command>qpaeq</command></term>
437 <listitem>
438 <para>
439 is an equalizer interface for
440 <application>PulseAudio</application> equalizer sinks.
441 </para>
442 <indexterm zone="pulseaudio qpaeq">
443 <primary sortas="b-qpaeq">qpaeq</primary>
444 </indexterm>
445 </listitem>
446 </varlistentry>
447-->
448<!-- Not found in PA 7.0
449 <varlistentry id="start-pulseaudio-kde">
450 <term><command>start-pulseaudio-kde</command></term>
451 <listitem>
452 <para>
453 Starts <application>PulseAudio</application> and loads
454 module-device-manager to use KDE routing policies.
455 </para>
456 <indexterm zone="pulseaudio start-pulseaudio-kde">
457 <primary sortas="b-start-pulseaudio-kde">start-pulseaudio-kde</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461-->
462 <varlistentry id="start-pulseaudio-x11">
463 <term><command>start-pulseaudio-x11</command></term>
464 <listitem>
465 <para>
466 starts <application>PulseAudio</application> and registers it to
467 the X11 session manager.
468 </para>
469 <indexterm zone="pulseaudio start-pulseaudio-x11">
470 <primary sortas="b-start-pulseaudio-x11">start-pulseaudio-x11</primary>
471 </indexterm>
472 </listitem>
473 </varlistentry>
474
475 </variablelist>
476
477 </sect2>
478
479</sect1>
Note: See TracBrowser for help on using the repository browser.