source: networking/netutils/avahi.xml@ 7ded7e3

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 7ded7e3 was 7ded7e3, checked in by Krejzi <krejzi@…>, 12 years ago

Gnome 3.4.2 (See changelog for which components were upgraded/added). Converted all of Gnome XML files to the 'new xml format'. Sorted 'Postlfs' and 'General' section packages in some kind of order. Moved Colord into 'System Utilities' and SpiderMonkey into 'General Utilities'. Fixed Avahi dependencies as reported last night. Fixed several typos and dependencies in other packages. Sorted general.ent according to other packages.

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

  • Property mode set to 100644
File size: 19.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 avahi-download-http "http://avahi.org/download/avahi-&avahi-version;.tar.gz">
8 <!ENTITY avahi-download-ftp " ">
9 <!ENTITY avahi-md5sum "2f22745b8f7368ad5a0a3fddac343f2d">
10 <!ENTITY avahi-size "1.3 MB">
11 <!ENTITY avahi-buildsize "23 MB">
12 <!ENTITY avahi-time "0.4 SBU">
13]>
14
15<sect1 id="avahi" xreflabel="Avahi-&avahi-version;">
16 <?dbhtml filename="avahi.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Avahi-&avahi-version;</title>
24
25 <indexterm zone="avahi">
26 <primary sortas="a-Avahi">Avahi</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Avahi</title>
31
32 <para>
33 The <application>Avahi</application> package is a system which
34 facilitates service discovery on a local network.
35 </para>
36
37 &lfs70_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&avahi-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&avahi-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &avahi-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &avahi-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &avahi-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &avahi-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Avahi Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <xref linkend="intltool"/> and
78 <xref linkend="pkgconfig"/>
79 </para>
80
81 <bridgehead renderas="sect4">Recommended</bridgehead>
82 <para role="optional">
83 <xref linkend="dbus-python"/>,
84 <xref linkend="gobject-introspection"/>,
85 <xref linkend="gtk2"/>,
86 <xref linkend="gtk3"/>,
87 <xref linkend="libdaemon"/> and
88 <xref linkend="libglade"/>
89 </para>
90
91 <bridgehead renderas="sect4">Optional</bridgehead>
92 <para role="optional">
93 <xref linkend="qt4"/>
94 </para>
95
96 <para condition="html" role="usernotes">User Notes:
97 <ulink url="&blfs-wiki;/avahi"/>
98 </para>
99 </sect2>
100
101 <sect2 role="installation">
102 <title>Installation of Avahi</title>
103
104 <para>
105 There should be a dedicated user and group to take control
106 of the <command>avahi-daemon</command> daemon after it is
107 started. Issue the following commands as the
108 <systemitem class="username">root</systemitem> user:
109 </para>
110
111<screen role="root"><userinput>groupadd -fg 84 avahi &amp;&amp;
112useradd -c "Avahi Daemon Owner" -d /var/run/avahi-daemon -u 84 \
113 -g avahi -s /bin/false avahi</userinput></screen>
114
115 <para>
116 There should also be a dedicated priviliged access group for
117 <application>Avahi</application> clients. Issue the following command as
118 the <systemitem class="username">root</systemitem> user:
119 </para>
120
121<screen role="root"><userinput>groupadd -fg 86 netdev</userinput></screen>
122
123 <para>Install <application>Avahi</application> by running the following
124 commands:</para>
125
126<screen><userinput>
127./configure --prefix=/usr \
128 --sysconfdir=/etc \
129 --localstatedir=/var \
130 --disable-static \
131 --disable-mono \
132 --disable-monodoc \
133 --disable-python \
134 --disable-qt3 \
135 --disable-qt4 \
136 --enable-core-docs \
137 --with-distro=none &amp;&amp;
138make</userinput></screen>
139
140 <para>
141 This package does not come with a test suite.
142 </para>
143
144 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
145
146<screen role="root"><userinput>make install</userinput></screen>
147
148 </sect2>
149
150 <sect2 role="commands">
151 <title>Command Explanations</title>
152
153 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
154 href="../../xincludes/static-libraries.xml"/>
155
156 <para>
157 <option>--disable-mono</option>: This parameter disables the
158 <application>Mono</application> bindings.
159 </para>
160
161 <para>
162 <option>--disable-monodoc</option>: This parameter disables
163 documentation for the <application>Mono</application> bindings.
164 </para>
165
166 <para>
167 <option>--disable-python</option>: This parameter disables the
168 scripts that depend on <application>Python</application>. It also
169 allows a regular install to complete successfully.
170 </para>
171
172 <para>
173 <option>--disable-qt3</option>: This parameter disables the
174 building of <application>Qt3</application> mainloop integration.
175 </para>
176
177 <para>
178 <option>--disable-qt4</option>: This parameter disables the building
179 of <application>Qt4Core</application> mainloop integration. Omit
180 this if you have installed <application>Qt4</application>.
181 </para>
182
183 <para>
184 <option>--enable-core-docs</option>: This parameter enables the
185 building of documentation.
186 </para>
187
188 <para>
189 <parameter>--with-distro=none</parameter>: There is an obsolete
190 boot script in the distribution for LFS. This option disables it.
191 </para>
192
193 <para>
194 <option>--disable-dbus</option>: This parameter disables the use
195 of <application>D-Bus</application>.
196 </para>
197
198 <para>
199 <option>--disable-gtk</option>: This parameter disables the use
200 of <application>GTK+2</application>.
201 </para>
202
203 <para>
204 <option>--disable-gtk3</option>: This parameter disables the use
205 of <application>GTK+3</application>.
206 </para>
207
208 <para>
209 <option>--disable-libdaemon</option>: This parameter disables the use
210 of <application>libdaemon</application>. If you remove this option,
211 <command>avahi-daemon</command> won't be built.
212 </para>
213
214 <para>
215 <option>--enable-tests</option>: This option enables the building of
216 tests and examples.
217 </para>
218
219 <para>
220 <option>--enable-compat-howl</option>: This option enables the
221 compatibility layer for <application>HOWL</application>.
222 </para>
223
224 <para>
225 <option>--enable-compat-libdns_sd</option>: This option enables the
226 compatibility layer for <application>libdns_sd</application>.
227 </para>
228
229 </sect2>
230
231 <sect2 role="configuration">
232 <title>Configuring avahi</title>
233
234 <sect3 id="avahi-init">
235 <title>Boot Script</title>
236
237 <para>
238 To automatically start the <command>avahi-daemon</command>
239 when the system is rebooted, install the
240 <filename>/etc/rc.d/init.d/avahi</filename> bootscript from
241 the <xref linkend="bootscripts"/> package.
242 </para>
243
244 <indexterm zone="avahi avahi-init">
245 <primary sortas="f-avahi">avahi</primary>
246 </indexterm>
247
248<screen role="root"><userinput>make install-avahi</userinput></screen>
249
250 </sect3>
251
252 </sect2>
253
254 <sect2 role="content">
255 <title>Contents</title>
256
257 <segmentedlist>
258 <segtitle>Installed Programs</segtitle>
259 <segtitle>Installed Libraries</segtitle>
260 <segtitle>Installed Directories</segtitle>
261
262 <seglistitem>
263 <seg>avahi-autoipd, avahi-bookmarks, avahi-browse, avahi-browse-domains,
264 avahi-daemon, avahi-discover, avahi-discover-standalone, avahi-dnsconfd,
265 avahi-publish, avahi-publish-address, avahi-publish-service,
266 avahi-resolve, avahi-resolve-address, avahi-resolve-host-name,
267 avahi-set-host-name, bshell, bssh, and bvnc</seg>
268 <seg>libavahi-client.so, libavahi-common.so,
269 libavahi-core.so, libavahi-glib.so, libavahi-gobject.so,
270 libavahi-ui-gtk3.so,, libavahi-ui.so, libdns_sd.so, and
271 libhowl.so,</seg>
272 <seg>/etc/avahi/services, /usr/{include/{avahi-client,avahi-common,
273 avahi-compat-howl/{corby,discovery,rendezvous,salt},
274 avahi-compat-libdns_sd,avahi-core,avahi-glib,avahi-gobject,avahi-ui},
275 lib/{avahi,python&python2-majorver;/site-packages/{avahi,
276 avahi_discover}},share/{avahi/interfaces,locale/en_NZ/LC_MESSAGES}}</seg>
277 </seglistitem>
278 </segmentedlist>
279
280 <variablelist>
281 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
282 <?dbfo list-presentation="list"?>
283 <?dbhtml list-presentation="table"?>
284
285 <varlistentry id="avahi-autoipd">
286 <term><command>avahi-autoipd</command></term>
287 <listitem>
288 <para>is a IPv4LL network address configuration daemon.</para>
289 <indexterm zone="avahi avahi-autoipd">
290 <primary sortas="b-avahi-autoipd">avahi-autoipd</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 <varlistentry id="avahi-bookmarks">
296 <term><command>avahi-bookmarks</command></term>
297 <listitem>
298 <para>is a Web service showing mDNS/DNS-SD announced HTTP services
299 using the <application>Avahi</application> daemon.</para>
300 <indexterm zone="avahi avahi-bookmarks">
301 <primary sortas="b-avahi-bookmarks">avahi-bookmarks</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="avahi-browse">
307 <term><command>avahi-browse</command></term>
308 <listitem>
309 <para>browses for mDNS/DNS-SD services using the
310 <application>Avahi</application> daemon.</para>
311 <indexterm zone="avahi avahi-browse">
312 <primary sortas="b-avahi-browse">avahi-browse</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316
317 <varlistentry id="avahi-browse-domains">
318 <term><command>avahi-browse-domains</command></term>
319 <listitem>
320 <para>browses for mDNS/DNS-SD services using the
321 <application>Avahi</application> daemon.</para>
322 <indexterm zone="avahi avahi-browse-domains">
323 <primary sortas="b-avahi-browse-domains">avahi-browse-domains</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="avahi-daemon">
329 <term><command>avahi-daemon</command></term>
330 <listitem>
331 <para>is the <application>Avahi</application> mDNS/DNS-SD
332 daemon.</para>
333 <indexterm zone="avahi avahi-daemon">
334 <primary sortas="b-avahi-daemon">avahi-daemon</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 <varlistentry id="avahi-discover">
340 <term><command>avahi-discover</command></term>
341 <listitem>
342 <para>browses for mDNS/DNS-SD services using the
343 <application>Avahi</application> daemon.</para>
344 <indexterm zone="avahi avahi-discover">
345 <primary sortas="b-avahi-discover">avahi-discover</primary>
346 </indexterm>
347 </listitem>
348 </varlistentry>
349
350 <varlistentry id="avahi-discover-standalone">
351 <term><command>avahi-discover-standalone</command></term>
352 <listitem>
353 <para>browses for mDNS/DNS-SD services using the
354 <application>Avahi</application> daemon.</para>
355 <indexterm zone="avahi avahi-discover-standalone">
356 <primary sortas="b-avahi-discover-standalone">avahi-discover-standalone</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
361 <varlistentry id="avahi-dnsconfd">
362 <term><command>avahi-dnsconfd</command></term>
363 <listitem>
364 <para>is a Unicast DNS server from mDNS/DNS-SD configuration
365 daemon.</para>
366 <indexterm zone="avahi avahi-dnsconfd">
367 <primary sortas="b-avahi-dnsconfd">avahi-dnsconfd</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="avahi-publish">
373 <term><command>avahi-publish</command></term>
374 <listitem>
375 <para>registers a mDNS/DNS-SD service or host name or address mapping
376 using the <application>Avahi</application> daemon.</para>
377 <indexterm zone="avahi avahi-publish">
378 <primary sortas="b-avahi-publish">avahi-publish</primary>
379 </indexterm>
380 </listitem>
381 </varlistentry>
382
383 <varlistentry id="avahi-publish-address">
384 <term><command>avahi-publish-address</command></term>
385 <listitem>
386 <para>registers a mDNS/DNS-SD service or host name or address mapping
387 using the <application>Avahi</application> daemon.</para>
388 <indexterm zone="avahi avahi-publish-address">
389 <primary sortas="b-avahi-publish-address">avahi-publish-address</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="avahi-publish-service">
395 <term><command>avahi-publish-service</command></term>
396 <listitem>
397 <para>registers a mDNS/DNS-SD service or host name or address mapping
398 using the <application>Avahi</application> daemon.</para>
399 <indexterm zone="avahi avahi-publish-service">
400 <primary sortas="b-avahi-publish-service">avahi-publish-service</primary>
401 </indexterm>
402 </listitem>
403 </varlistentry>
404
405 <varlistentry id="avahi-resolve">
406 <term><command>avahi-resolve</command></term>
407 <listitem>
408 <para>resolves one or more mDNS/DNS host name(s) to IP address(es)
409 (and vice versa) using the <application>Avahi</application>
410 daemon.</para>
411 <indexterm zone="avahi avahi-resolve">
412 <primary sortas="b-avahi-resolve">avahi-resolve</primary>
413 </indexterm>
414 </listitem>
415 </varlistentry>
416
417 <varlistentry id="avahi-resolve-address">
418 <term><command>avahi-resolve-address</command></term>
419 <listitem>
420 <para>resolves one or more mDNS/DNS host name(s) to IP address(es)
421 (and vice versa) using the <application>Avahi</application>
422 daemon.</para>
423 <indexterm zone="avahi avahi-resolve-address">
424 <primary sortas="b-avahi-resolve-address">avahi-resolve-address</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 <varlistentry id="avahi-resolve-host-name">
430 <term><command>avahi-resolve-host-name</command></term>
431 <listitem>
432 <para>resolves one or more mDNS/DNS host name(s) to IP address(es)
433 (and vice versa) using the <application>Avahi</application>
434 daemon.</para>
435 <indexterm zone="avahi avahi-resolve-host-name">
436 <primary sortas="b-avahi-resolve-host-name">avahi-resolve-host-name</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="avahi-set-host-name">
442 <term><command>avahi-set-host-name</command></term>
443 <listitem>
444 <para>changes the mDNS host name.</para>
445 <indexterm zone="avahi avahi-set-host-name">
446 <primary sortas="b-avahi-set-host-name">avahi-set-host-name</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <!--<varlistentry id="bshell">
452 <term><command>bshell</command></term>
453 <listitem>
454 <para>does this .....</para>
455 <indexterm zone="avahi bshell">
456 <primary sortas="b-bshell">bshell</primary>
457 </indexterm>
458 </listitem>
459 </varlistentry>-->
460
461 <varlistentry id="bssh">
462 <term><command>bssh</command></term>
463 <listitem>
464 <para>browses for SSH servers on the local network.</para>
465 <indexterm zone="avahi bssh">
466 <primary sortas="b-bssh">bssh</primary>
467 </indexterm>
468 </listitem>
469 </varlistentry>
470
471 <varlistentry id="bvnc">
472 <term><command>bvnc</command></term>
473 <listitem>
474 <para>browses for VNC servers on the local network.</para>
475 <indexterm zone="avahi bvnc">
476 <primary sortas="b-bvnc">bvnc</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 <!--<varlistentry id="libavahi-client">
482 <term><filename class='libraryfile'>libavahi-client.{so,a}</filename></term>
483 <listitem>
484 <para>contains functions that .....</para>
485 <indexterm zone="avahi libavahi-client">
486 <primary sortas="c-libavahi-client">libavahi-client.{so,a}</primary>
487 </indexterm>
488 </listitem>
489 </varlistentry>
490
491 <varlistentry id="libavahi-common">
492 <term><filename class='libraryfile'>libavahi-common.{so,a}</filename></term>
493 <listitem>
494 <para>contains functions that .....</para>
495 <indexterm zone="avahi libavahi-common">
496 <primary sortas="c-libavahi-common">libavahi-common.{so,a}</primary>
497 </indexterm>
498 </listitem>
499 </varlistentry>
500
501 <varlistentry id="libavahi-core">
502 <term><filename class='libraryfile'>libavahi-core.{so,a}</filename></term>
503 <listitem>
504 <para>contains functions that .....</para>
505 <indexterm zone="avahi libavahi-core">
506 <primary sortas="c-libavahi-core">libavahi-core.{so,a}</primary>
507 </indexterm>
508 </listitem>
509 </varlistentry>
510
511 <varlistentry id="libavahi-glib">
512 <term><filename class='libraryfile'>libavahi-glib.{so,a}</filename></term>
513 <listitem>
514 <para>contains functions that .....</para>
515 <indexterm zone="avahi libavahi-glib">
516 <primary sortas="c-libavahi-glib">libavahi-glib.{so,a}</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520
521 <varlistentry id="libavahi-gobject">
522 <term><filename class='libraryfile'>libavahi-gobject.{so,a}</filename></term>
523 <listitem>
524 <para>contains functions that .....</para>
525 <indexterm zone="avahi libavahi-gobject">
526 <primary sortas="c-libavahi-gobject">libavahi-gobject.{so,a}</primary>
527 </indexterm>
528 </listitem>
529 </varlistentry>
530
531 <varlistentry id="libavahi-ui-gtk3">
532 <term><filename class='libraryfile'>libavahi-ui-gtk3.{so,a}</filename></term>
533 <listitem>
534 <para>contains functions that .....</para>
535 <indexterm zone="avahi libavahi-ui-gtk3">
536 <primary sortas="c-libavahi-ui-gtk3">libavahi-ui-gtk3.{so,a}</primary>
537 </indexterm>
538 </listitem>
539 </varlistentry>
540
541 <varlistentry id="libavahi-ui">
542 <term><filename class='libraryfile'>libavahi-ui.{so,a}</filename></term>
543 <listitem>
544 <para>contains functions that .....</para>
545 <indexterm zone="avahi libavahi-ui">
546 <primary sortas="c-libavahi-ui">libavahi-ui.{so,a}</primary>
547 </indexterm>
548 </listitem>
549 </varlistentry>
550
551 <varlistentry id="libdns_sd">
552 <term><filename class='libraryfile'>libdns_sd.{so,a}</filename></term>
553 <listitem>
554 <para>contains functions that .....</para>
555 <indexterm zone="avahi libdns_sd">
556 <primary sortas="c-libdns_sd">libdns_sd.{so,a}</primary>
557 </indexterm>
558 </listitem>
559 </varlistentry>
560
561 <varlistentry id="libhowl">
562 <term><filename class='libraryfile'>libhowl.{so,a}</filename></term>
563 <listitem>
564 <para>contains functions that .....</para>
565 <indexterm zone="avahi libhowl">
566 <primary sortas="c-libhowl">libhowl.{so,a}</primary>
567 </indexterm>
568 </listitem>
569 </varlistentry>-->
570
571 </variablelist>
572
573 </sect2>
574
575</sect1>
Note: See TracBrowser for help on using the repository browser.