source: multimedia/libdriv/pulseaudio.xml@ eb1089d

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt 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 eb1089d was eb1089d, checked in by Bruce Dubbs <bdubbs@…>, 6 years ago

Update to qpdf-8.2.1.
Tags

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

  • Property mode set to 100644
File size: 18.1 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 "https://www.freedesktop.org/software/pulseaudio/releases/pulseaudio-&pulseaudio-version;.tar.xz">
9 <!ENTITY pulseaudio-download-ftp " ">
10 <!ENTITY pulseaudio-md5sum "c42f1f1465e8df9859d023dc184734bf">
11 <!ENTITY pulseaudio-size "1.6 MB">
12 <!ENTITY pulseaudio-buildsize "112 MB (add 2 MB for tests)">
13 <!ENTITY pulseaudio-time "1.2 SBU (add 0.7 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 &lfs83_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">Additional Downloads</bridgehead>
79 <itemizedlist spacing="compact">
80 <listitem>
81 <para>
82 Required patch if using glibc-2.27:
83 <ulink url="&patch-root;/pulseaudio-&pulseaudio-version;-glibc_2.27_fix-1.patch"/>
84 </para>
85 </listitem>
86 </itemizedlist>-->
87
88 <bridgehead renderas="sect3">PulseAudio Dependencies</bridgehead>
89
90 <bridgehead renderas="sect4">Required</bridgehead>
91 <para role="required">
92 <xref linkend="libsndfile"/>
93 </para>
94
95 <bridgehead renderas="sect4">Recommended</bridgehead>
96 <para role="recommended">
97 <xref linkend="alsa-lib"/>,
98 <xref linkend="dbus"/>,
99 <xref linkend="glib2"/>,
100 <xref linkend="libcap-pam"/>,
101 <xref linkend="speex"/> and
102 <xref linkend="xorg7-lib"/>
103 </para>
104
105 <bridgehead renderas="sect4">Optional</bridgehead>
106 <para role="optional">
107 <xref linkend="avahi"/>,
108 <xref linkend="bluez"/>,
109 <phrase revision="sysv">
110 <xref role="runtime" linkend="consolekit"/> (runtime),</phrase>
111 <xref linkend="fftw"/>,
112 <xref linkend="GConf"/>,
113 <xref linkend="gtk3"/>,
114 <xref linkend="libsamplerate"/>,
115 <xref linkend="sbc"/> (Bluetooth support),
116 <xref linkend="valgrind"/>,
117 <ulink url="http://www.jackaudio.org/">JACK</ulink>,
118 <ulink url="http://0pointer.de/lennart/projects/libasyncns/">libasyncns</ulink>,
119 <ulink url="http://www.lirc.org/">LIRC</ulink>,
120 <ulink url="http://gstreamer.freedesktop.org/src/orc/">ORC</ulink>,
121 <ulink url="https://sourceforge.net/projects/soxr/">soxr</ulink>,
122 <ulink url="http://tdb.samba.org/">TDB</ulink>,
123 <ulink url="http://freedesktop.org/software/pulseaudio/webrtc-audio-processing/">
124 WebRTC AudioProcessing</ulink> and
125 <ulink url="http://www.xenproject.org/">XEN</ulink>
126 </para>
127
128 <para condition="html" role="usernotes">User Notes:
129 <ulink url="&blfs-wiki;/pulseaudio"/>
130 </para>
131 </sect2>
132
133 <sect2 role="installation">
134 <title>Installation of PulseAudio</title>
135
136 <para>
137 Install <application>PulseAudio</application> by running the following
138 commands:
139 </para>
140
141<!--<screen><userinput>patch -Np1 -i ../pulseaudio-&pulseaudio-version;-glibc_2.27_fix-1.patch &amp;&amp;
142
143AUTOPOINT='intltoolize \-\-automake \-\-copy' autoreconf -fiv &amp;&amp;-->
144<screen><userinput>./configure --prefix=/usr \
145 --sysconfdir=/etc \
146 --localstatedir=/var \
147 --disable-bluez4 \
148 --disable-bluez5 \
149 --disable-rpath &amp;&amp;
150make</userinput></screen>
151
152 <para>
153 To test the results, issue: <command>make check</command>.
154 The volume-test may fail for unknown reasons.
155 <!-- apparently, the max deviation is higher than expected, i.e. assertion
156 failed, result of 280 > 253 : but it seems to work -->
157 </para>
158
159 <para>
160 Now, as the <systemitem class="username">root</systemitem> user:
161 </para>
162
163<screen role="root"><userinput>make install</userinput></screen>
164
165 <!-- http://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/SystemWide/ -->
166 <para>
167 While still as the <systemitem class="username">root</systemitem>
168 user, remove the <application>D-Bus</application> configuration file
169 for the system wide daemon to avoid creating unnecessary system
170 users and groups:
171 </para>
172
173<screen role="root"><userinput>rm -fv /etc/dbus-1/system.d/pulseaudio-system.conf</userinput></screen>
174
175 </sect2>
176
177 <sect2 role="commands">
178 <title>Command Explanations</title>
179
180 <para>
181 <command>patch -Np1 -i ...</command>: This patch fixes a name conflict
182 with glibc-2.27. It is usable with previous versions of glibc.
183 </para>
184
185 <para>
186 <command>AUTOPOINT='intltoolize ...</command>:
187 <command>autoreconf</command> needs ot be run after applying the
188 patch. Running <command>intltoolize</command> instead of
189 <command>autopoint</command> prevents an error when running
190 <command>configure</command> afterwards.
191 </para>
192
193 <para>
194 <parameter>--disable-bluez4</parameter>: This switch disables
195 support for <application>BlueZ</application> version 4 in favour
196 of <application>BlueZ</application> version 5 since the latter
197 also installs compatibility library for the earlier version.
198 </para>
199
200 <para>
201 <parameter>--disable-bluez5</parameter>: This switch prevents
202 a runtime error if <xref linkend="dbus"/> and <xref linkend="sbc"/>
203 are both installed but <xref linkend="bluez"/> is not installed.
204 Remove this if you have installed all three packages.
205 </para>
206
207 <para>
208 <parameter>--disable-rpath</parameter>: This switch prevents
209 linker from adding a hardcoded runtime path to the installed
210 programs and libraries.
211 </para>
212
213 </sect2>
214
215 <sect2 role="configuration">
216 <title>Configuring PulseAudio</title>
217
218 <sect3 id="pulseaudio-config">
219 <title>Config Files</title>
220 <para>
221 There are system wide configuration files:
222 <filename>/etc/pulse/daemon.conf</filename>,
223 <filename>/etc/pulse/client.conf</filename>,
224 <filename>/etc/pulse/default.pa</filename>, and user configuration
225 files with the same names in
226 <filename class="directory">~/.config/pulse</filename>. User
227 configuration files take precedence over system wide ones.
228 </para>
229
230 <indexterm zone="pulseaudio pulseaudio-config">
231 <primary sortas="e-AA.config-pulse">~/.config/pulse</primary>
232 </indexterm>
233
234 <indexterm zone="pulseaudio pulseaudio-config">
235 <primary
236 sortas="e-etc-pulse-daemon.conf">/etc/pulse/daemon.conf</primary>
237 </indexterm>
238
239 <indexterm zone="pulseaudio pulseaudio-config">
240 <primary
241 sortas="e-etc-pulse-client.conf">/etc/pulse/client.conf</primary>
242 </indexterm>
243
244 <indexterm zone="pulseaudio pulseaudio-config">
245 <primary
246 sortas="e-etc-pulse-default.pa">/etc/pulse/default.pa</primary>
247 </indexterm>
248 </sect3>
249
250 <sect3><title>Configuration Information</title>
251
252 <para>
253 The default configuration files allow setting up a working installation.
254 However, a reference to Console-Kit needs to be removed if it is
255 not installed. For example, issue the following command as the
256 <systemitem class="username">root</systemitem> user:
257 </para>
258
259<screen role="root"><userinput>sed -i '/load-module module-console-kit/s/^/#/' /etc/pulse/default.pa</userinput></screen>
260
261 <para>
262 You may also have to configure the audio system. You can start
263 <application>pulseaudio</application> in command line mode using
264 <command>pulseaudio -C</command> and then list various
265 information and change settings. See
266 <command>man pulse-cli-syntax</command>.
267 </para>
268
269 <para>
270 If <application>pulseaudio</application> was working but you no-longer
271 have sound, after checking for hardware issues (speakers or headphones
272 not connected, external amplifier not connected) you may need to fix it.
273 </para>
274
275 <para>
276 One suggestion is to close the application, such as
277 <application>firefox</application> where sound has stopped working, then
278 run: <command>pactl list short sinks</command> followed by:
279 <command>pacmd set-default-sink &lt;sink #&gt;</command> and then
280 restart the application.
281 </para>
282
283 <para>
284 If that does not work, a more drastic approach often works. After closing
285 the application, close pulseaudio, either using <command>pulseaudio
286 --kill</command> or, if that fails, <command>killall -KILL
287 pulseaudio</command> and then <command>rm -rf
288 ~/.config/pulse/*</command> (and perhaps also
289 <command>rm -rf ~/.pulse/*</command> if you have used a very old version
290 of pulse on this machine, then run <command>pulseaudio
291 --verbose</command> to restart it. If the daemon starts, restart the
292 application. See <command>man pulseaudio</command> for more options.
293 </para>
294
295 </sect3>
296 </sect2>
297
298 <sect2 role="content">
299 <title>Contents</title>
300
301 <segmentedlist>
302 <segtitle>Installed Programs</segtitle>
303 <segtitle>Installed Libraries</segtitle>
304 <segtitle>Installed Directories</segtitle>
305
306 <seglistitem>
307 <seg>
308 esdcompat, pacat, pacmd, pactl, padsp, pamon (symlink to pacat),
309 paplay (symlink to pacat), parec (symlink to pacat),
310 parecord (symlink to pacat), pasuspender,
311 pax11publish, pulseaudio, and
312 <!-- it looks like the equalizer needs FFTW: qpaeq, -->
313 start-pulseaudio-x11
314 </seg>
315 <seg>
316 libpulse.so
317 libpulse-mainloop-glib.so,
318 libpulse-simple.so,
319 libpulsecommon-&pulseaudio-major-version;.so,
320 libpulsecore-&pulseaudio-major-version;.so, and
321 libpulsedsp.so
322
323 </seg>
324 <seg>
325 /etc/pulse,
326 /usr/include/pulse,
327 /usr/lib/cmake/PulseAudio,
328 /usr/lib/{pulseaudio,pulse-&pulseaudio-major-version;},
329 /usr/libexec/pulse, and
330 /usr/share/pulseaudio
331 </seg>
332 </seglistitem>
333 </segmentedlist>
334
335 <variablelist>
336 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
337 <?dbfo list-presentation="list"?>
338 <?dbhtml list-presentation="table"?>
339
340 <varlistentry id="esdcompat">
341 <term><command>esdcompat</command></term>
342 <listitem>
343 <para>
344 is the <application>PulseAudio</application> ESD wrapper script.
345 </para>
346 <indexterm zone="pulseaudio esdcompat">
347 <primary sortas="b-esdcompat">esdcompat</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 <varlistentry id="pacat">
353 <term><command>pacat</command></term>
354 <listitem>
355 <para>
356 plays back or records raw or encoded audio streams on a
357 <application>PulseAudio</application> sound server.
358 </para>
359 <indexterm zone="pulseaudio pacat">
360 <primary sortas="b-pacat">pacat</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364
365 <varlistentry id="pacmd">
366 <term><command>pacmd</command></term>
367 <listitem>
368 <para>
369 is a tool used to reconfigure a <application>PulseAudio</application>
370 sound server during runtime.
371 </para>
372 <indexterm zone="pulseaudio pacmd">
373 <primary sortas="b-pacmd">pacmd</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377
378 <varlistentry id="pactl">
379 <term><command>pactl</command></term>
380 <listitem>
381 <para>
382 is used to control a running <application>PulseAudio</application>
383 sound server.
384 </para>
385 <indexterm zone="pulseaudio pactl">
386 <primary sortas="b-pactl">pactl</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="padsp">
392 <term><command>padsp</command></term>
393 <listitem>
394 <para>
395 is the <application>PulseAudio</application> OSS Wrapper.
396 </para>
397 <indexterm zone="pulseaudio padsp">
398 <primary sortas="b-padsp">padsp</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 <varlistentry id="pamon">
404 <term><command>pamon</command></term>
405 <listitem>
406 <para>
407 is a symbolic link to <command>pacat</command>.
408 </para>
409 <indexterm zone="pulseaudio pamon">
410 <primary sortas="b-pamon">pamon</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="paplay">
416 <term><command>paplay</command></term>
417 <listitem>
418 <para>
419 is used to play audio files on a
420 <application>PulseAudio</application> sound server.
421 </para>
422 <indexterm zone="pulseaudio paplay">
423 <primary sortas="b-paplay">paplay</primary>
424 </indexterm>
425 </listitem>
426 </varlistentry>
427
428 <varlistentry id="parec">
429 <term><command>parec</command></term>
430 <listitem>
431 <para>
432 is a symbolic link to <command>pacat</command>.
433 </para>
434 <indexterm zone="pulseaudio parec">
435 <primary sortas="b-parec">parec</primary>
436 </indexterm>
437 </listitem>
438 </varlistentry>
439
440 <varlistentry id="parecord">
441 <term><command>parecord</command></term>
442 <listitem>
443 <para>
444 is a symbolic link to <command>pacat</command>.
445 </para>
446 <indexterm zone="pulseaudio parecord">
447 <primary sortas="b-parecord">parecord</primary>
448 </indexterm>
449 </listitem>
450 </varlistentry>
451
452 <varlistentry id="pasuspender">
453 <term><command>pasuspender</command></term>
454 <listitem>
455 <para>
456 is a tool that can be used to tell a local
457 <application>PulseAudio</application> sound server to temporarily
458 suspend access to the audio devices, to allow other applications
459 to access them directly.
460 </para>
461 <indexterm zone="pulseaudio pasuspender">
462 <primary sortas="b-pasuspender">pasuspender</primary>
463 </indexterm>
464 </listitem>
465 </varlistentry>
466
467 <varlistentry id="pax11publish">
468 <term><command>pax11publish</command></term>
469 <listitem>
470 <para>
471 is the <application>PulseAudio</application>
472 X11 Credential Utility.
473 </para>
474 <indexterm zone="pulseaudio pax11publish">
475 <primary sortas="b-pax11publish">pax11publish</primary>
476 </indexterm>
477 </listitem>
478 </varlistentry>
479
480 <varlistentry id="pulseaudio-prog">
481 <term><command>pulseaudio</command></term>
482 <listitem>
483 <para>
484 is a networked low-latency sound server for Linux.
485 </para>
486 <indexterm zone="pulseaudio pulseaudio-prog">
487 <primary sortas="b-pulseaudio">pulseaudio</primary>
488 </indexterm>
489 </listitem>
490 </varlistentry>
491
492<!-- only installed if FFTW is present
493 <varlistentry id="qpaeq">
494 <term><command>qpaeq</command></term>
495 <listitem>
496 <para>
497 is an equalizer interface for
498 <application>PulseAudio</application> equalizer sinks.
499 </para>
500 <indexterm zone="pulseaudio qpaeq">
501 <primary sortas="b-qpaeq">qpaeq</primary>
502 </indexterm>
503 </listitem>
504 </varlistentry>
505-->
506<!-- Not found in PA 7.0
507 <varlistentry id="start-pulseaudio-kde">
508 <term><command>start-pulseaudio-kde</command></term>
509 <listitem>
510 <para>
511 Starts <application>PulseAudio</application> and loads
512 module-device-manager to use KDE routing policies.
513 </para>
514 <indexterm zone="pulseaudio start-pulseaudio-kde">
515 <primary sortas="b-start-pulseaudio-kde">start-pulseaudio-kde</primary>
516 </indexterm>
517 </listitem>
518 </varlistentry>
519-->
520 <varlistentry id="start-pulseaudio-x11">
521 <term><command>start-pulseaudio-x11</command></term>
522 <listitem>
523 <para>
524 starts <application>PulseAudio</application> and registers it to
525 the X11 session manager.
526 </para>
527 <indexterm zone="pulseaudio start-pulseaudio-x11">
528 <primary sortas="b-start-pulseaudio-x11">start-pulseaudio-x11</primary>
529 </indexterm>
530 </listitem>
531 </varlistentry>
532
533 </variablelist>
534
535 </sect2>
536
537</sect1>
Note: See TracBrowser for help on using the repository browser.