source: multimedia/libdriv/pulseaudio.xml@ 5d45eda

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 5d45eda was 5d45eda, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Fix an md5sum and a build time

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

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