]> git.meshlink.io Git - catta/blob - docs/INSTALL
CVE-2009-0758: Reflector creates packet storm on legacy unicast traffic
[catta] / docs / INSTALL
1 *** Quick install instructions (tested on Debian/Ubuntu only!) ***
2
3 While "configure" and "make" may be run as normal user all other commands
4 need to be run as root.
5
6 Configure the build system:
7         $ ./configure --sysconfdir=/etc --localstatedir=/var
8
9 Some configure options available:
10
11     --disable-gtk            disable GTK+ tools                (default: enabled)
12     --disable-dbus           disable DBUS support              (default: enabled)
13     --disable-python         disable building python modules   (default: enabled)
14     --with-dbus-sys=<dir>    where D-BUS system.d directory is
15     --with-distro=<distro>   the target Linux distribution (one of redhat,
16                                     suse, gentoo, debian or slackware)
17     --with-avahi-user=<user> User for running the Avahi daemon (avahi)
18     --with-avahi-group=<grp> Group for Avahi (avahi)
19
20     Please note that by disabling DBUS you lose the ability to publish and browse
21     services from local applications.
22
23     Please note that Avahi currently ships with a init scripts for only a few
24     distributions. if yours is not supported right now, YMMV. Patches welcome.
25
26         $ make
27         # make install
28         # ldconfig
29
30 Add a user an a group for avahi. (Debian specific)
31         # addgroup --system avahi
32         # adduser --system --no-create-home --ingroup avahi avahi
33
34 Ask DBUS to re-read its policies:
35         # kill -HUP `cat /var/run/dbus/pid`
36
37 Now start the Avahi daemon:
38         # /etc/init.d/avahi-daemon start
39
40 Optionally start the unicast DNS configuration daemon:
41         # /etc/init.d/avahi-dnsconfd start
42
43 To start the two daemons at boot time on Debian based distributions:
44         with DBUS support:
45         # ln -s /etc/init.d/avahi-daemon /etc/dbus-1/event.d/75avahi-daemon
46         # ln -s /etc/init.d/avahi-dnsconfd /etc/dbus-1/event.d/76avahi-dnsconfd
47
48         without DBUS support:
49         # update-rc.d avahi-daemon defaults 25 15
50         # update-rc.d avahi-dnsconfd defaults 26 14
51
52 If you plan to use avahi-autoipd you have to create the user/group
53 "avahi-autoipd" much the same way as "avahi".
54
55 $Id$