===============================================================================
 Link Monitor Applet installation instructions
===============================================================================

Index

	0. About this document
	1. Dependencies
	2. Instructions
	3. Configure options

0. About this document

	$Id: INSTALL,v 1.5 2006/06/20 09:01:52 jylefort Exp $

	Copyright (C) 2004-2006 Jean-Yves Lefort.

	This document is part of Link Monitor Applet. It may be
	distributed under the same terms as Link Monitor Applet.

1. Dependencies

	Mandatory:

		* GTK+ (version 2.8.0 or superior)
		  http://www.gtk.org/

		* GNOME (version 2.6.0 or superior)
		  http://www.gnome.org/

	Optional:

		* for country information support:

		  GeoIP
		  http://www.maxmind.com/geoip/

		  and a GTK+ SVG loader, for instance:

		  librsvg (version 2.0 or superior)
		  http://librsvg.sourceforge.net/

2. Instructions

	Link Monitor Applet uses the GNU build system. Hence, the
	following usual sequence will probably satisfy most users:

		$ ./configure
		$ make
		<get root privileges>
		$ make install

	IMPORTANT:

		* The install phase will enable the setuid bit on the
		  link-monitor-applet binary (root privileges are
		  needed to create the ICMP and ICMPv6 sockets upon
		  applet startup; they will be dropped after that
		  step), therefore you need to run the install phase
		  as root.

		* Due to a bug in bonobo-activation
		  (http://bugzilla.gnome.org/show_bug.cgi?id=151082),
		  your session must be restarted after installing Link
		  Monitor Applet.

	The configure script options which are specific to Link
	Monitor Applet are documented below.

3. Configure options

	--enable-ipv6 (default: yes)

		Enable IPv6 support.

	--enable-geoip (default: yes)

		Display country names and flags.

		Requirements: GeoIP and a GTK+ SVG loader.