source: multimedia/libdriv/pulseaudio.xml@ b9b17d1b

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since b9b17d1b was b9b17d1b, checked in by Krejzi <krejzi@…>, 12 years ago

LFS 7.2 checked.

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