source: multimedia/libdriv/pulseaudio.xml@ 0956cf1

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 0956cf1 was 0956cf1, checked in by Fernando de Oliveira <fernando@…>, 9 years ago

Update to pulseaudio-6.0.
LXDM-0.5.0 and ConsoleKit-0.4.6: s/option/parameter/.

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

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