X-Git-Url: http://git.meshlink.io/?a=blobdiff_plain;f=docs%2FINSTALL;h=802ad45387cd35623aa4bf25637b8d25adbab817;hb=aed3b9ce083aac09ed91e293ff4bd30c92743ce7;hp=d6b134e45e93287799535197547b3a88e2ae6d23;hpb=e2bd3f23a80ac9f59e406688e92a36ca843d364a;p=catta diff --git a/docs/INSTALL b/docs/INSTALL index d6b134e..802ad45 100644 --- a/docs/INSTALL +++ b/docs/INSTALL @@ -1,36 +1,51 @@ -*** 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 only the Debian init script is currently up-to-date. + YMMV on other distributions. Patches welcome! + + $ make + # make install + +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$