X-Git-Url: http://git.meshlink.io/?a=blobdiff_plain;f=docs%2FINSTALL;h=419ac3e69858be9d9021168f3580c8597a5fe23d;hb=47b7bd98bbdb0df6471fb40b084bb5f255c91237;hp=d6b134e45e93287799535197547b3a88e2ae6d23;hpb=e2bd3f23a80ac9f59e406688e92a36ca843d364a;p=catta diff --git a/docs/INSTALL b/docs/INSTALL index d6b134e..419ac3e 100644 --- a/docs/INSTALL +++ b/docs/INSTALL @@ -1,36 +1,53 @@ -*** Quick install instructions (tested on debian/ubuntu only!) *** +*** Quick install instructions (tested on Debian/Ubuntu only!) *** -While "make" and "boostrap.sh" may be run as normal users all other commands -need to be run is root. +While "configure" and "make" may be run as normal user all other commands +need to be run as root. -$ ./bootstrap.sh - (this will run autoconf/automake) +Configure the build system: + $ ./configure --sysconfdir=/etc --localstatedir=/var -$ ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var +Some configure options available: -Extra configure options available: - - --enable-gtk use GTK+ (default=yes) - --enable-dbus use DBus (default=yes) + --disable-gtk disable GTK+ tools (default: enabled) + --disable-dbus disable DBUS support (default: enabled) + --disable-python disable building python modules (default: enabled) --with-dbus-sys= where D-BUS system.d directory is --with-distro= the target Linux distribution (one of redhat, suse, gentoo, debian or slackware) --with-avahi-user= User for running the Avahi daemon (avahi) --with-avahi-group= Group for Avahi (avahi) -$ make -# make install + Please note that by disabling DBUS you lose the ability to publish and browse + services from local applications. + + Please note that Avahi currently ships with a init scripts for only a few + distributions. if yours is not supported right now, YMMV. Patches welcome. + + $ make + # make install + # ldconfig + +Add a user an a group for avahi. (Debian specific) + # addgroup --system avahi + # adduser --system --no-create-home --ingroup avahi avahi + +Ask DBUS to re-read its policies: + # kill -HUP `cat /var/run/dbus/pid` + +Now start the Avahi daemon: + # /etc/init.d/avahi-daemon start -# addgroup --system avahi -# adduser --system --no-create-home --ingroup avahi avahi - (These commands are Debian specific and may be different on other - distributions) +Optionally start the unicast DNS configuration daemon: + # /etc/init.d/avahi-dnsconfd start -# kill -HUP `cat /var/run/dbus/pid` - (This will ask DBUS to re-read its policies) -# /etc/dbus-1/event.d/75avahi-daemon start +To start the two daemons at boot time on Debian based distributions: + with DBUS support: + # ln -s /etc/init.d/avahi-daemon /etc/dbus-1/event.d/75avahi-daemon + # ln -s /etc/init.d/avahi-dnsconfd /etc/dbus-1/event.d/76avahi-dnsconfd -- To automatically start avahi-dnsconfd on Debian based distro: -# update-rc.d avahi-dnsconfd defaults 25 15 + without DBUS support: + # update-rc.d avahi-daemon defaults 25 15 + # update-rc.d avahi-dnsconfd defaults 26 14 -$Id$ +If you plan to use avahi-autoipd you have to create the user/group +"avahi-autoipd" much the same way as "avahi".