summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAndrew Shadura <andrew.shadura@collabora.co.uk>2016-06-21 11:57:24 +0200
committerAndrew Shadura <andrew.shadura@collabora.co.uk>2016-06-21 11:57:24 +0200
commit0af3fe8aecc7ee52a6ee0eb926aab985513c4204 (patch)
tree1297533f6cec6790a4c11fab567c69a2dfc56369 /doc
Imported Upstream version 0.26
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile.am36
-rw-r--r--doc/Makefile.in305
-rw-r--r--doc/NEWS117
-rw-r--r--doc/README369
-rw-r--r--doc/README.SuSE15
-rw-r--r--doc/README.html344
-rw-r--r--doc/README.html.in344
-rw-r--r--doc/SUPPORTED_DRIVERS25
-rw-r--r--doc/style.css32
9 files changed, 1587 insertions, 0 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 0000000..cbd9bb3
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,36 @@
+# $Id: Makefile.am 88 2004-01-26 15:40:05Z lennart $
+
+# This file is part of ifplugd.
+#
+# ifplugd is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# ifplugd is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with ifplugd; if not, write to the Free Software Foundation,
+# Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
+
+noinst_DATA = README.html README
+EXTRA_DIST = $(noinst_DATA) style.css README.html.in SUPPORTED_DRIVERS NEWS README.SuSE
+
+MAINTAINERCLEANFILES = README README.html
+CLEANFILES =
+
+if USE_LYNX
+README: README.html
+ lynx --dump $^ | sed 's,file://localhost/.*/doc/README.html,README,' > $@
+
+CLEANFILES += README
+endif
+
+tidy: README.html
+ tidy -e < README.html
+
+.PHONY: tidy
+
diff --git a/doc/Makefile.in b/doc/Makefile.in
new file mode 100644
index 0000000..55755fc
--- /dev/null
+++ b/doc/Makefile.in
@@ -0,0 +1,305 @@
+# Makefile.in generated by automake 1.7.9 from Makefile.am.
+# @configure_input@
+
+# Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
+# Free Software Foundation, Inc.
+# This Makefile.in is free software; the Free Software Foundation
+# gives unlimited permission to copy and/or distribute it,
+# with or without modifications, as long as this notice is preserved.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
+# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+# PARTICULAR PURPOSE.
+
+@SET_MAKE@
+
+# $Id: Makefile.am 88 2004-01-26 15:40:05Z lennart $
+
+# This file is part of ifplugd.
+#
+# ifplugd is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# ifplugd is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with ifplugd; if not, write to the Free Software Foundation,
+# Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
+
+srcdir = @srcdir@
+top_srcdir = @top_srcdir@
+VPATH = @srcdir@
+pkgdatadir = $(datadir)/@PACKAGE@
+pkglibdir = $(libdir)/@PACKAGE@
+pkgincludedir = $(includedir)/@PACKAGE@
+top_builddir = ..
+
+am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
+INSTALL = @INSTALL@
+install_sh_DATA = $(install_sh) -c -m 644
+install_sh_PROGRAM = $(install_sh) -c
+install_sh_SCRIPT = $(install_sh) -c
+INSTALL_HEADER = $(INSTALL_DATA)
+transform = $(program_transform_name)
+NORMAL_INSTALL = :
+PRE_INSTALL = :
+POST_INSTALL = :
+NORMAL_UNINSTALL = :
+PRE_UNINSTALL = :
+POST_UNINSTALL = :
+@USE_LYNX_TRUE@am__append_1 = README
+ACLOCAL = @ACLOCAL@
+AMDEP_FALSE = @AMDEP_FALSE@
+AMDEP_TRUE = @AMDEP_TRUE@
+AMTAR = @AMTAR@
+AUTOCONF = @AUTOCONF@
+AUTOHEADER = @AUTOHEADER@
+AUTOMAKE = @AUTOMAKE@
+AWK = @AWK@
+CC = @CC@
+CCDEPMODE = @CCDEPMODE@
+CFLAGS = @CFLAGS@
+CPP = @CPP@
+CPPFLAGS = @CPPFLAGS@
+CXX = @CXX@
+CXXDEPMODE = @CXXDEPMODE@
+CXXFLAGS = @CXXFLAGS@
+CYGPATH_W = @CYGPATH_W@
+DEFS = @DEFS@
+DEPDIR = @DEPDIR@
+ECHO_C = @ECHO_C@
+ECHO_N = @ECHO_N@
+ECHO_T = @ECHO_T@
+EGREP = @EGREP@
+EXEEXT = @EXEEXT@
+INSTALL_DATA = @INSTALL_DATA@
+INSTALL_PROGRAM = @INSTALL_PROGRAM@
+INSTALL_SCRIPT = @INSTALL_SCRIPT@
+INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
+LDFLAGS = @LDFLAGS@
+LIBDAEMON_CFLAGS = @LIBDAEMON_CFLAGS@
+LIBDAEMON_LIBS = @LIBDAEMON_LIBS@
+LIBOBJS = @LIBOBJS@
+LIBS = @LIBS@
+LN_S = @LN_S@
+LTLIBOBJS = @LTLIBOBJS@
+MAKEINFO = @MAKEINFO@
+OBJEXT = @OBJEXT@
+PACKAGE = @PACKAGE@
+PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
+PACKAGE_NAME = @PACKAGE_NAME@
+PACKAGE_STRING = @PACKAGE_STRING@
+PACKAGE_TARNAME = @PACKAGE_TARNAME@
+PACKAGE_URL = @PACKAGE_URL@
+PACKAGE_VERSION = @PACKAGE_VERSION@
+PATH_SEPARATOR = @PATH_SEPARATOR@
+PKG_CONFIG = @PKG_CONFIG@
+SET_MAKE = @SET_MAKE@
+SHELL = @SHELL@
+STRIP = @STRIP@
+SYSINITDIR = @SYSINITDIR@
+USE_LYNX_FALSE = @USE_LYNX_FALSE@
+USE_LYNX_TRUE = @USE_LYNX_TRUE@
+USE_SUBVERSION_FALSE = @USE_SUBVERSION_FALSE@
+USE_SUBVERSION_TRUE = @USE_SUBVERSION_TRUE@
+USE_XMLTOMAN_FALSE = @USE_XMLTOMAN_FALSE@
+USE_XMLTOMAN_TRUE = @USE_XMLTOMAN_TRUE@
+VERSION = @VERSION@
+ac_ct_CC = @ac_ct_CC@
+ac_ct_CXX = @ac_ct_CXX@
+ac_ct_STRIP = @ac_ct_STRIP@
+am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
+am__fastdepCC_TRUE = @am__fastdepCC_TRUE@
+am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@
+am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@
+am__include = @am__include@
+am__leading_dot = @am__leading_dot@
+am__quote = @am__quote@
+bindir = @bindir@
+build_alias = @build_alias@
+datadir = @datadir@
+exec_prefix = @exec_prefix@
+have_lynx = @have_lynx@
+have_subversion = @have_subversion@
+have_xmltoman = @have_xmltoman@
+host_alias = @host_alias@
+includedir = @includedir@
+infodir = @infodir@
+install_sh = @install_sh@
+libdir = @libdir@
+libexecdir = @libexecdir@
+localstatedir = @localstatedir@
+mandir = @mandir@
+oldincludedir = @oldincludedir@
+prefix = @prefix@
+program_transform_name = @program_transform_name@
+sbindir = @sbindir@
+sharedstatedir = @sharedstatedir@
+sysconfdir = @sysconfdir@
+target_alias = @target_alias@
+
+noinst_DATA = README.html README
+EXTRA_DIST = $(noinst_DATA) style.css README.html.in SUPPORTED_DRIVERS NEWS README.SuSE
+
+MAINTAINERCLEANFILES = README README.html
+CLEANFILES = $(am__append_1)
+subdir = doc
+ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
+mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
+CONFIG_HEADER = $(top_builddir)/config.h
+CONFIG_CLEAN_FILES = README.html
+DIST_SOURCES =
+DATA = $(noinst_DATA)
+
+DIST_COMMON = README $(srcdir)/Makefile.in Makefile.am NEWS \
+ README.html.in
+all: all-am
+
+.SUFFIXES:
+$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/configure.ac $(ACLOCAL_M4)
+ cd $(top_srcdir) && \
+ $(AUTOMAKE) --foreign doc/Makefile
+Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
+ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)
+README.html: $(top_builddir)/config.status README.html.in
+ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
+uninstall-info-am:
+tags: TAGS
+TAGS:
+
+ctags: CTAGS
+CTAGS:
+
+DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
+
+top_distdir = ..
+distdir = $(top_distdir)/$(PACKAGE)-$(VERSION)
+
+distdir: $(DISTFILES)
+ @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \
+ topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \
+ list='$(DISTFILES)'; for file in $$list; do \
+ case $$file in \
+ $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \
+ $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \
+ esac; \
+ if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
+ dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \
+ if test "$$dir" != "$$file" && test "$$dir" != "."; then \
+ dir="/$$dir"; \
+ $(mkinstalldirs) "$(distdir)$$dir"; \
+ else \
+ dir=''; \
+ fi; \
+ if test -d $$d/$$file; then \
+ if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
+ cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \
+ fi; \
+ cp -pR $$d/$$file $(distdir)$$dir || exit 1; \
+ else \
+ test -f $(distdir)/$$file \
+ || cp -p $$d/$$file $(distdir)/$$file \
+ || exit 1; \
+ fi; \
+ done
+check-am: all-am
+check: check-am
+all-am: Makefile $(DATA)
+
+installdirs:
+install: install-am
+install-exec: install-exec-am
+install-data: install-data-am
+uninstall: uninstall-am
+
+install-am: all-am
+ @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
+
+installcheck: installcheck-am
+install-strip:
+ $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+ install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+ `test -z '$(STRIP)' || \
+ echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
+mostlyclean-generic:
+
+clean-generic:
+ -test -z "$(CLEANFILES)" || rm -f $(CLEANFILES)
+
+distclean-generic:
+ -rm -f $(CONFIG_CLEAN_FILES)
+
+maintainer-clean-generic:
+ @echo "This command is intended for maintainers to use"
+ @echo "it deletes files that may require special tools to rebuild."
+ -test -z "$(MAINTAINERCLEANFILES)" || rm -f $(MAINTAINERCLEANFILES)
+clean: clean-am
+
+clean-am: clean-generic mostlyclean-am
+
+distclean: distclean-am
+ -rm -f Makefile
+distclean-am: clean-am distclean-generic
+
+dvi: dvi-am
+
+dvi-am:
+
+info: info-am
+
+info-am:
+
+install-data-am:
+
+install-exec-am:
+
+install-info: install-info-am
+
+install-man:
+
+installcheck-am:
+
+maintainer-clean: maintainer-clean-am
+ -rm -f Makefile
+maintainer-clean-am: distclean-am maintainer-clean-generic
+
+mostlyclean: mostlyclean-am
+
+mostlyclean-am: mostlyclean-generic
+
+pdf: pdf-am
+
+pdf-am:
+
+ps: ps-am
+
+ps-am:
+
+uninstall-am: uninstall-info-am
+
+.PHONY: all all-am check check-am clean clean-generic distclean \
+ distclean-generic distdir dvi dvi-am info info-am install \
+ install-am install-data install-data-am install-exec \
+ install-exec-am install-info install-info-am install-man \
+ install-strip installcheck installcheck-am installdirs \
+ maintainer-clean maintainer-clean-generic mostlyclean \
+ mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \
+ uninstall-info-am
+
+
+@USE_LYNX_TRUE@README: README.html
+@USE_LYNX_TRUE@ lynx --dump $^ | sed 's,file://localhost/.*/doc/README.html,README,' > $@
+
+tidy: README.html
+ tidy -e < README.html
+
+.PHONY: tidy
+# Tell versions [3.59,3.63) of GNU make to not export all variables.
+# Otherwise a system limit (for SysV at least) may be exceeded.
+.NOEXPORT:
diff --git a/doc/NEWS b/doc/NEWS
new file mode 100644
index 0000000..f52dd1f
--- /dev/null
+++ b/doc/NEWS
@@ -0,0 +1,117 @@
+
+[[[ newer changes are recorded in the README file only ]]]
+
+
+0.20 :: 9 Nov 2003 :: SVN 71
+ Error output fix
+ Build system fix
+
+0.19 :: 20 Oct 2003 :: SVN 62
+ --wait-for-kill fix
+ minor documentation updates, other fixes
+
+0.18 :: 17 Oct 2003 :: SVN ??
+ Bugfixes
+
+0.17b :: 13 Sep 2003 :: SVN 48
+ Fixed some typos
+
+0.17 :: 13 Sep 2003 :: SVN 42
+ Init script update
+ compativility fix for gcc 2.95
+
+0.16 :: 13. Aug 2003 :: SVN 31
+ Spec file update
+ Build fixes
+ monitor mode
+ init script update
+
+0.15 :: 10. Jul 2003 :: SVN 16
+ umask fix
+ Documentation update
+
+0.14 :: 7. Jul 2003 :: SVN 9
+ Add WLAN support
+ Move to Autoconf
+ Add switch -F
+ Add suspend/resume
+ Modify logging
+ Depend on libdaemon
+
+0.13 :: 1. Feb 2003 :: PRCS 0.40
+ Add note about 3c59x on kernel 2.4.20 to SUPPORTED_DRIVERS
+ Add Suse/United Linux compatibility
+ Move Manpages from man/ to share/man/
+ Apply patch from Mandrake Linux regarding syslog, potential buffer overflow and more
+ Reduce stack usage
+ Remove -Werror from gcc command line
+ Small improvement to client program logging
+ Added option -c and adjustet init script accordingly
+
+0.12 :: 11. Jan 2003 :: PRCS 0.34
+ Fix to the specfile (thanks to Asgeir Nilsen)
+ chkonfig compatibility (the same)
+ RH6.2 compatibility (thanks to R. Steve McKown)
+ New option -x (as well)
+
+0.11 :: 24. Dec 2002 :: PRCS 0.25
+ added RPM specfile (thanks to Sean Reifschneider)
+ Extended SUPPORTED_DRIVERS
+
+0.10 :: 13. Nov 2002
+ Added the option -w
+ Portability fixes
+ Corrected daemonizing strategy
+ Removed PRCS residues from distribution
+
+0.9 :: 7. Nov 2002
+ Automatically remove all IP addresses from interface when doing "interface up" without -a
+ Add SUPPORTED_DRIVERS
+ Add patch for 8139too
+ Added trailing newline to version.h
+
+0.8 :: 25. Oct. 2002
+ Syslog spamming corrected
+ Makefile fixes
+ Manpage typos removed
+ Ignore-failure logic inverted, broken in 0.7
+
+0.7 :: 23. Oct. 2002
+ Introduced ifstatus
+ New manpages
+ Implemented support for SIOCPRIV
+ Fixed some bashisms and ashisms
+ Changed -m semantics
+ set -e in default action script
+ Created seperate module interface.c for link status detection functions
+ Documentation update
+ On request of Enrico Zini:
+ Environment variables are now exported to the action script
+ Network devices may be detected automatically
+
+0.6 :: 14. Oct. 2002
+ Documentation fixes
+ License fixes
+ Manpage added
+ New option -q
+
+0.5 :: n.n.
+ Workaround for kernel bug triggered by using tcpdump together with ifplugd
+
+0.4 :: n.n.
+ Link beat detection fixes
+
+0.3 :: n.n.
+ Link beat detection fixes
+ Syslog cleanup
+
+0.2 :: 30. Sept. 2002
+ New option -m
+ Command line parsing fixes
+ Documentation update
+ Installation script fixes
+
+0.1 :: 29. Sept. 2002
+ Initial version
+
+$Id: NEWS 109 2004-04-12 13:58:11Z lennart $
diff --git a/doc/README b/doc/README
new file mode 100644
index 0000000..e2ab81a
--- /dev/null
+++ b/doc/README
@@ -0,0 +1,369 @@
+
+ ifplugd 0.26
+
+ Copyright 2002-2004 Lennart Poettering <mzvscyhtq (at) 0pointer (dot)
+ de>
+ * [1]License
+ * [2]News
+ * [3]Overview
+ * [4]Status
+ * [5]Documentation
+ * [6]Requirements
+ * [7]Installation
+ * [8]Acknowledgements
+ * [9]Download
+
+License
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or (at
+ your option) any later version.
+
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+
+News
+
+ Sun Dec 19 2004:
+
+ [10]Version 0.26 released, changes include: changed MII code for
+ better compatibility with some 3COM Boomerang cards.
+
+ Mon May 10 2004:
+
+ [11]Version 0.25 released, changes include: Revert to more classic
+ link checking support. The new checking order is: ETHTOOL, MII, WLAN,
+ IFF. The obsolete API "PRIV" is no longer checked by the automatic API
+ detection code. However, you may enable it forcibly by passing -m priv
+ on the command line.
+
+ Mon Apr 12 2004:
+
+ [12]Version 0.24 released, changes include: add IFF_RUNNING link check
+ support and make it the default. This might break some setups. You may
+ workaround this by passing -m to the daemon for selecting a different
+ API. Please report breakages!
+
+ Wed Apr 7 2004:
+
+ [13]Version 0.23 released, changes include: don't make /dev/tty1 the
+ controlling TTY when beeping
+
+ Tue Feb 10 2004:
+
+ [14]Version 0.22 released, changes include: rename ifstatus to
+ ifplugstatus due to namespace collision, minor fixes
+
+ Mon Jan 26 2004:
+
+ [15]Version 0.21b released, added missing file.
+
+ Mon Jan 26 2004:
+
+ [16]Version 0.21 released, changes include: better compatibility with
+ wireless devices, compatibility with newer kernels
+
+ Sun Nov 9 2003:
+
+ [17]Version 0.20 released, changes include: fix wrong message, build
+ fix
+
+ Mon Oct 20 2003:
+
+ [18]Version 0.19 released, changes include: New option
+ --wait-for-kill, this requires [19]libdaemon 0.3
+
+ Fri Oct 17 2003:
+
+ [20]Version 0.18 released, changes include: Some bugs fixed
+
+ Fri Sep 13 2003:
+
+ [21]Version 0.17b released, changes include: typo and date fix
+
+ Fri Sep 13 2003:
+
+ [22]Version 0.17 released, changes include: documentation update,
+ better support for multiple interfaces, gcc 2.95 build fix
+
+ Thu Aug 13 2003:
+
+ [23]Version 0.16 released, changes include: RPM spec file added, build
+ fixes, WLAN improvements (including compatibility with the upcoming
+ waproamd, a WLAN roaming daemon), monitor mode for use in conjunction
+ with PCMCIA devices, better support for multiple interface setups,
+ SUPPORTED_DRIVERS returns
+
+ Thu July 10 2003:
+
+ [24]Version 0.15 released, changes include: bad umask fix,
+ documentation update
+
+ Mon July 7 2003:
+
+ [25]Version 0.14 released, changes include: autoconf usage, new
+ dependency [26]libdaemon, wireless LAN support, support for
+ suspending/resuming, many fixes
+
+Overview
+
+ ifplugd is a Linux daemon which will automatically configure your
+ ethernet device when a cable is plugged in and automatically
+ unconfigure it if the cable is pulled. This is useful on laptops with
+ onboard network adapters, since it will only configure the interface
+ when a cable is really connected.
+
+ ifplugd ifplugd interfaces with your distribution's native network
+ configuration utilities.
+
+ Some features:
+ * Uses your distribution's native ifup/ifdown programs.
+ * May beep when the cable is unplugged, plugged, the interface
+ configuration succeeded or failed.
+ * Supports the Linux SIOCETHTOOL (newer, aka ethtool API),
+ SIOCGMIIREG (older, aka mii-diag/mii-tool API) and SIOCDEVPRIVATE
+ (oldest, aka mii-tool API) ioctl()s for getting link status.
+ Release 0.24 introduces support for link detection with the
+ IFF_RUNNING interface flag.
+ * Syslog support
+ * Small program - the binary is just 25 KB (plus 16 KB for
+ libdaemon).
+ * Multiple ethernet interface support
+ * Can be configured to ignore short "unplugged" periods (-d option)
+ or short "plugged" periods(-u option)
+ * Support for wireless networking. Whenever an association to an AP
+ is detected the network is configured. Have a look on [27]waproamd
+ if you need a facility to configure WEP keys before AP
+ associations succeed.
+ * Compatibility mode for network devices which do not support cable
+ detection (-F option)
+
+Status
+
+ Version 0.26 is stable and has all the sensible features its users
+ could think of.
+
+Documentation
+
+ Have a look on the man pages [28]ifplugd(8), [29]ifplugstatus(8),
+ [30]ifplugd.conf(5). (An XSLT capable browser is required)
+
+ Configuration
+
+ Edit /etc/ifplugd/ifplugd.conf for configuration changes. This file is
+ a bourne shell script sourced by the init script and used to start
+ ifplugd with appropriate arguments. You may specify more than one
+ ethernet interface in INTERFACES. For each interface a seperate
+ instance of ifplugd is spawned. The arguments specified in ARGS are
+ append to ifplugd's command line. Have a look on ifplugd -h or man
+ ifplugd for further information about the available options.
+
+ The network interface which is controlled by ifplugd should not be
+ configured automatically by your distribution's network subsystem,
+ since ifplugd will do this for you if needed.
+
+ On Debian systems, any interfaces named in ifplugd's INTERFACES
+ environment variable should not also be listed in an "auto" stanza in
+ /etc/network/interfaces.
+
+ Troubleshooting
+
+ When you are using the hotplug subsystem (Debian package hotplug) you
+ may notice that the network device is configured even when it is not
+ listed on an auto line in /etc/network/interface. This may be due to
+ hotplug being configured to ifup the network interface when it becomes
+ available. This was the default behavior in the Debian hotplug package
+ prior to release 0.0.20030117-1, for example. To prevent this you
+ should either upgrade your hotplug package or comment out the ifup
+ call in /etc/hotplug/net.agent.
+
+ When using ifplugd together with APM (and probably ACPI) suspends,
+ strange things may happen: some network devices fail to detect the
+ network cable for a short period of time before and after the suspend.
+ When using the -f switch, this will be treated as "no link beat", thus
+ the network is shutdown after a timeout. During this timeout the
+ machine changes to suspended state. When it is resumed again, the
+ timeout period will have expired and so the network is deconfigured,
+ however, as the next cable detection succeeds, the network is
+ configured again immediately. To fix this problem, ifplugd should be
+ disabled before the APM suspend and enabled back after the suspend.
+ This may be done by using apmd and adding a script to
+ /etc/apm/{suspend,resume}.d which simply calls /etc/init.d/ifplugd
+ suspend, resp. /etc/init.d/ifplugd resume. It might even be a good
+ idea to shut down the network completely during suspend, this may be
+ achieved by calling /etc/init.d/ifplugd stop and /etc/init.d/ifplugd
+ start in the appropriate places. I strongly urge the packagers of this
+ software for the Linux distributions to add such scripts to their
+ packages.
+
+ FAQ
+
+ 1. Q: I want to use ifplugd with my PCMCIA device, but ifplugd quits
+ when it doesn't find eth0, when I have not inserted the card. What
+ can I do?
+ A: Use the -f switch. This is not very clean however, since
+ modprobe is called on each cable detection query of ifplugd to
+ load a module for the network device. This is suboptimal. You
+ should probably run ifplugd only when the card is really inserted.
+ 2. Q: I am using the -f switch, but the kernel logs are getting
+ filled with messages like "modprobe: modprobe: Can't locate module
+ eth0". What can I do?
+ A: Make sure you have a line like alias eth0 off in your
+ /etc/modules.conf
+ 3. Q: When the cable is unplugged and the interface shut down it is
+ still available with ifconfig and markes as UP. Why this?
+ A: ifplugd cannot detect the link beat with a shut down interface
+ on certain (most as of kernel 2.4.19) network drivers. Thus
+ ifplugd enables the interface before querying the link status.
+ This may be switched off with -a flag. You might want to use it if
+ you have a sane network driver (e.g. eepro100). The subdirectory
+ patches/ in the ifplugd distribution includes a patch for the
+ 8139too 0.9.26 driver, which makes the driver compatible with -a.
+ Don't ask me how to apply this patch. If you don't know, you won't
+ need it.
+ 4. Q: Does it work with anything else than plain ethernet or wireless
+ LAN?
+ A: Certainly not, since the MII and ETHTOOL ioctl()s and the
+ wireless extension don't exist on other network device types.
+ 5. Q: I have a Realtek 8139 based network card. Everytime ifplugd
+ starts on bootup my machine freezes. What can I do?
+ A: This is a bug in the 8139too driver 0.9.25 (at least) shipped
+ with Linux 2.4.19, please upgrade to 8139too 0.9.26 (Linux 2.4.20
+ or seperately at
+ [31]http://www.sourceforge.net/projects/gkernel/).
+ 6. Q: There are already laptop-net's ifd and miid, why did you write
+ your own daemon?
+ A: laptop-net was too integrated with its profile system and
+ didn't work on my hardware when I had a look on it. It seemed
+ easier to me to write a simple but feature complete replacement
+ than using laptop-net without most of the special features
+ disabled. I didn't know about miid when I wrote ifplugd, but in
+ any case ifplugd is much better than miid. For a comparison of
+ miid and ifplugd, have a look on
+ [32]http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=162763&repeat
+ merged=yes
+
+Requirements
+
+ A newer Linux Kernel (I think 2.2 is good enough, alltough I tested it
+ only with 2.4) with a compatible device driver and ethernet card. Most
+ modern cards and drivers are compatible, like mine which works with
+ the 8139too driver.
+
+ ifplugd was developed and tested on Debian GNU/Linux "testing" from
+ July 2003, it should work on most other Linux distributions (and maybe
+ Unix versions) since it uses GNU autoconf and GNU libtool for source
+ code configuration and shared library management.
+
+ The machine used was a Medion 9580-F laptop with a Realtek 8139
+ network card and a PRISM1 PCMCIA wireless LAN card.
+
+ ifplugd needs [33]libdaemon.
+
+Installation
+
+ As this package is made with the GNU autotools you should run
+ ./configure inside the distribution directory for configuring the
+ source tree. After that you should run make for compilation and make
+ install (as root) for installation of ifplugd.
+
+ The installation scripts create an init script in
+ ${sysconfdir}/init.d/ifplugd, however no /etc/rc?.d/ links are created
+ for it.
+
+ Extensive installation instructions for installation of ifplugd on
+ Fedora Core 1 are available at [34]Geoff Ericksson's web site.
+
+Acknowledgements
+
+ For the developers of mii-diag, ethtool and laptop-net, since I looked
+ on their source codes for learning how to use the link beat ioctls.
+
+ Oliver Kurth for packaging ifplugd for Debian and ifplugd's manpage
+
+ Thomas Hood, Asgeir Nilsen, Sean Reifschneider, R. Steve McKown, David
+ Mitchell, Norbert Preining, Herbert Graeber for patches
+
+ Frederic Lepied for integrating ifplugd into Mandrake Linux
+
+Download
+
+ The newest release is always available from
+ [35]http://0pointer.de/lennart/projects/ifplugd/
+
+ The current release is [36]0.26
+
+ Get ifplugd's development sources from the [37]Subversion
+ [38]repository ([39]viewcvs):
+svn checkout svn://seth.intheinter.net/ifplugd/trunk ifplugd
+
+ You may find an up to date Debian package of ifplugd on the [40]Debian
+ package repository.
+
+ Packages for Mandrake Linux may be found in the Cooker distribution;
+ Gentoo packages are available as well; [41]SuSE packages are available
+ courtesy of Herbert Graeber.
+
+ If you want to be notified whenever I release a new version of this
+ software use the subscription feature of [42]Freshmeat.
+
+ New! There is a joint ifplugd and waproamd [43]mailing list available.
+ _________________________________________________________________
+
+
+ Lennart Poettering <mzvscyhtq (at) 0pointer (dot) de>, December 2004
+
+ $Id: README.html.in 117 2004-12-19 00:30:39Z lennart $
+
+References
+
+ 1. README#license
+ 2. README#news
+ 3. README#overview
+ 4. README#status
+ 5. README#documentation
+ 6. README#requirements
+ 7. README#installation
+ 8. README#acks
+ 9. README#download
+ 10. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.26.tar.gz
+ 11. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.25.tar.gz
+ 12. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.24.tar.gz
+ 13. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.23.tar.gz
+ 14. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.22.tar.gz
+ 15. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.21b.tar.gz
+ 16. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.21.tar.gz
+ 17. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.20.tar.gz
+ 18. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.19.tar.gz
+ 19. http://0pointer.de/lennart/projects/libdaemon/
+ 20. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.18.tar.gz
+ 21. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.17b.tar.gz
+ 22. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.17.tar.gz
+ 23. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.16.tar.gz
+ 24. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.15.tar.gz
+ 25. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.14.tar.gz
+ 26. http://0pointer.de/lennart/projects/libdaemon/
+ 27. http://0pointer.de/lennart/projects/waproamd/
+ 28. http://0pointer.de/lennart/projects/ifplugd/ifplugd.8.xml
+ 29. http://0pointer.de/lennart/projects/ifplugd/ifplugstatus.8.xml
+ 30. http://0pointer.de/lennart/projects/ifplugd/ifplugd.conf.5.xml
+ 31. http://www.sourceforge.net/projects/gkernel/
+ 32. http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=162763&repeatmerged=yes
+ 33. http://0pointer.de/lennart/projects/libdaemon/
+ 34. http://www.acmc.uq.edu.au/~gbe/linux/installation_of_ifplugd.html
+ 35. http://0pointer.de/lennart/projects/ifplugd/
+ 36. http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.26.tar.gz
+ 37. http://subversion.tigris.org/
+ 38. svn://seth.intheinter.net/ifplugd
+ 39. http://0pointer.de/cgi-bin/viewcvs.cgi/?root=ifplugd
+ 40. http://packages.debian.org/ifplugd
+ 41. http://packman.links2linux.de/
+ 42. http://freshmeat.net/projects/ifplugd/
+ 43. https://seth.intheinter.net/mailman/listinfo/ifplugd-discuss
diff --git a/doc/README.SuSE b/doc/README.SuSE
new file mode 100644
index 0000000..0cdf8e4
--- /dev/null
+++ b/doc/README.SuSE
@@ -0,0 +1,15 @@
+To use ifplugd with SuSE Linux you have to change the start mode of all
+interfaces mentioned in ifplugd.conf to manual instead of onboot.
+Hotplug devices should specify hotplug as usual.
+
+For example:
+
+if /etc/ifplugd/ifplugd.conf contains
+
+ INTERFACES='eth0'
+
+your /etc/sysconfig/network/ifcfg-eth0 must contain
+
+ STARTMODE='manual'
+
+$Id: README.SuSE 86 2004-01-26 15:34:24Z lennart $
diff --git a/doc/README.html b/doc/README.html
new file mode 100644
index 0000000..e0cd5a2
--- /dev/null
+++ b/doc/README.html
@@ -0,0 +1,344 @@
+<?xml version="1.0" encoding="iso-8859-1"?> <!-- -*-html-helper-*- -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>ifplugd 0.26</title>
+<link rel="stylesheet" type="text/css" href="style.css" />
+</head>
+
+<body>
+<h1><a name="top">ifplugd 0.26</a></h1>
+
+<p><i>Copyright 2002-2004 Lennart Poettering &lt;mzvscyhtq (at) 0pointer (dot) de&gt;</i></p>
+
+<ul class="toc">
+ <li><a href="#license">License</a></li>
+ <li><a href="#news">News</a></li>
+ <li><a href="#overview">Overview</a></li>
+ <li><a href="#status">Status</a></li>
+ <li><a href="#documentation">Documentation</a></li>
+ <li><a href="#requirements">Requirements</a></li>
+ <li><a href="#installation">Installation</a></li>
+ <li><a href="#acks">Acknowledgements</a></li>
+ <li><a href="#download">Download</a></li>
+</ul>
+
+<h2><a name="license">License</a></h2>
+
+<p>This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License as
+published by the Free Software Foundation; either version 2 of the
+License, or (at your option) any later version.</p>
+
+<p>This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+General Public License for more details.</p>
+
+<p>You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</p>
+
+<h2><a name="news">News</a></h2>
+
+<div class="news-date">Sun Dec 19 2004: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.26.tar.gz">Version 0.26</a> released,
+changes include: changed MII code for better compatibility with some 3COM Boomerang cards.</p>
+
+<div class="news-date">Mon May 10 2004: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.25.tar.gz">Version 0.25</a> released,
+changes include: Revert to more classic link checking support. The new
+checking order is: ETHTOOL, MII, WLAN, IFF. The obsolete API "PRIV" is
+no longer checked by the automatic API detection code. However, you may enable
+it forcibly by passing <tt>-m priv</tt> on the command line.</p>
+
+<div class="news-date">Mon Apr 12 2004: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.24.tar.gz">Version
+0.24</a> released, changes include: add <tt>IFF_RUNNING</tt> link check support and make it the default. This might break some setups. You may workaround this by passing <tt>-m</tt> to the daemon for selecting a different API. Please report breakages!</p>
+
+<div class="news-date">Wed Apr 7 2004: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.23.tar.gz">Version
+0.23</a> released, changes include: don't make <tt>/dev/tty1</tt> the controlling TTY when beeping</p>
+
+<div class="news-date">Tue Feb 10 2004: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.22.tar.gz">Version
+0.22</a> released, changes include: rename <tt>ifstatus</tt> to <tt>ifplugstatus</tt> due to namespace collision, minor fixes</p>
+
+<div class="news-date">Mon Jan 26 2004: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.21b.tar.gz">Version
+0.21b</a> released, added missing file.</p>
+
+<div class="news-date">Mon Jan 26 2004: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.21.tar.gz">Version
+0.21</a> released, changes include: better compatibility with wireless devices, compatibility with newer kernels</p>
+
+<div class="news-date">Sun Nov 9 2003: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.20.tar.gz">Version
+0.20</a> released, changes include: fix wrong message, build fix</p>
+
+<div class="news-date">Mon Oct 20 2003: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.19.tar.gz">Version
+0.19</a> released, changes include: New option <tt>--wait-for-kill</tt>, this requires <a href="http://0pointer.de/lennart/projects/libdaemon/"><tt>libdaemon 0.3</tt></a></p>
+
+<div class="news-date">Fri Oct 17 2003: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.18.tar.gz">Version
+0.18</a> released, changes include: Some bugs fixed</p>
+
+<div class="news-date">Fri Sep 13 2003: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.17b.tar.gz">Version
+0.17b</a> released, changes include: typo and date fix</p>
+
+<div class="news-date">Fri Sep 13 2003: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.17.tar.gz">Version
+0.17</a> released, changes include: documentation update, better support for multiple interfaces, gcc 2.95 build fix</p>
+
+<div class="news-date">Thu Aug 13 2003: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.16.tar.gz">Version
+0.16</a> released, changes include: RPM spec file added, build fixes, WLAN improvements (including compatibility with the upcoming <tt>waproamd</tt>, a WLAN roaming daemon), monitor mode for use in conjunction with PCMCIA devices, better support for multiple interface setups, <tt>SUPPORTED_DRIVERS</tt> returns</p>
+
+<div class="news-date">Thu July 10 2003: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.15.tar.gz">Version
+0.15</a> released, changes include: bad umask fix, documentation update</p>
+
+<div class="news-date">Mon July 7 2003: </div> <p class="news-text"><a
+href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.14.tar.gz">Version
+0.14</a> released, changes include: autoconf usage, new dependency <a
+href="http://0pointer.de/lennart/projects/libdaemon/"><tt>libdaemon</tt></a>, wireless LAN support, support for
+suspending/resuming, many fixes</p>
+
+<h2><a name="overview">Overview</a></h2>
+
+<p><tt>ifplugd</tt> is a Linux daemon which will automatically
+configure your ethernet device when a cable is plugged in and
+automatically unconfigure it if the cable is pulled. This is useful on
+laptops with onboard network adapters, since it will only configure
+the interface when a cable is really connected.</p>
+
+<p><tt>ifplugd</tt> ifplugd interfaces with your distribution's native network
+ configuration utilities.</p>
+
+<p>Some features:</p>
+
+<ul>
+ <li>Uses your distribution's native <tt>ifup</tt>/<tt>ifdown</tt> programs.</li>
+
+ <li>May beep when the cable is unplugged, plugged, the interface
+ configuration succeeded or failed.</li>
+
+ <li>Supports the Linux <tt>SIOCETHTOOL</tt> (newer, aka <tt>ethtool</tt> API), <tt>SIOCGMIIREG</tt>
+ (older, aka <tt>mii-diag</tt>/<tt>mii-tool</tt> API) and SIOCDEVPRIVATE (oldest, aka
+ <tt>mii-tool</tt> API) <tt>ioctl()</tt>s for getting link status. Release 0.24 introduces support for link detection with the <tt>IFF_RUNNING</tt> interface flag.</li>
+
+ <li>Syslog support</li>
+
+ <li>Small program - the binary is just 25 KB (plus 16 KB for <tt>libdaemon</tt>).</li>
+
+ <li>Multiple ethernet interface support</li>
+
+ <li>Can be configured to ignore short "unplugged" periods
+ (-d option) or short "plugged" periods(<tt>-u</tt>
+ option)</li>
+
+ <li>Support for wireless networking. Whenever an association to an
+AP is detected the network is configured. Have a look on <a
+href="http://0pointer.de/lennart/projects/waproamd/"><tt>waproamd</tt></a>
+if you need a facility to configure WEP keys before AP associations succeed.</li>
+
+ <li>Compatibility mode for network devices which do not support cable detection (<tt>-F</tt> option)</li>
+</ul>
+
+<h2><a name="status">Status</a></h2>
+
+<p>Version 0.26 is stable and has all the sensible features its users could think of.</p>
+
+<h2><a name="documentation">Documentation</a></h2>
+
+<p>Have a look on the man pages <a href="http://0pointer.de/lennart/projects/ifplugd/ifplugd.8.xml"><tt>ifplugd(8)</tt></a>, <a href="http://0pointer.de/lennart/projects/ifplugd/ifplugstatus.8.xml"><tt>ifplugstatus(8)</tt></a>, <a href="http://0pointer.de/lennart/projects/ifplugd/ifplugd.conf.5.xml"><tt>ifplugd.conf(5)</tt></a>. (An XSLT capable browser is required)</p>
+
+<h3>Configuration</h3>
+
+<p>Edit <tt>/etc/ifplugd/ifplugd.conf</tt> for configuration
+changes. This file is a bourne shell script sourced by the init script
+and used to start <tt>ifplugd</tt> with appropriate arguments. You may specify more than
+one ethernet interface in <tt>INTERFACES</tt>. For each interface a
+seperate instance of <tt>ifplugd</tt> is spawned. The arguments specified in
+<tt>ARGS</tt> are append to <tt>ifplugd</tt>'s command line. Have a look on
+<tt>ifplugd -h</tt> or <tt>man ifplugd</tt> for further information
+about the available options.</p>
+
+<p>The network interface which is controlled by <tt>ifplugd</tt>
+should not be configured automatically by your distribution's network
+subsystem, since <tt>ifplugd</tt> will do this for you if needed.</p>
+
+<p>On Debian systems, any interfaces named in ifplugd's
+<tt>INTERFACES</tt> environment variable should not also be listed in
+an "auto" stanza in <tt>/etc/network/interfaces</tt>.</p>
+
+<h3>Troubleshooting</h3>
+
+<p>When you are using the hotplug subsystem (Debian package
+<tt>hotplug</tt>) you may notice that the network device is configured
+even when it is not listed on an <tt>auto</tt> line in
+<tt>/etc/network/interface</tt>. This may be due to <tt>hotplug</tt>
+being configured to <tt>ifup</tt> the network interface when it
+becomes available. This was the default behavior in the Debian
+<tt>hotplug</tt> package prior to release <tt>0.0.20030117-1</tt>, for
+example. To prevent this you should either upgrade your
+<tt>hotplug</tt> package or comment out the <tt>ifup</tt> call in
+<tt>/etc/hotplug/net.agent</tt>.</p>
+
+<p>When using <tt>ifplugd</tt> together with APM (and probably ACPI)
+suspends, strange things may happen: some network devices fail to
+detect the network cable for a short period of time before and after
+the suspend. When using the <tt>-f</tt> switch, this will be treated
+as "no link beat", thus the network is shutdown after a
+timeout. During this timeout the machine changes to suspended
+state. When it is resumed again, the timeout period will have expired
+and so the network is deconfigured, however, as the next cable
+detection succeeds, the network is configured again immediately. To
+fix this problem, <tt>ifplugd</tt> should be disabled before the APM
+suspend and enabled back after the suspend. This may be done by using
+<tt>apmd</tt> and adding a script to
+<tt>/etc/apm/{suspend,resume}.d</tt> which simply calls
+<tt>/etc/init.d/ifplugd suspend</tt>, resp. <tt>/etc/init.d/ifplugd
+resume</tt>. It might even be a good idea to shut down the network
+completely during suspend, this may be achieved by calling
+<tt>/etc/init.d/ifplugd stop</tt> and <tt>/etc/init.d/ifplugd
+start</tt> in the appropriate places. I strongly urge the packagers of
+this software for the Linux distributions to add such scripts to their
+packages.</p>
+
+<h3>FAQ</h3>
+
+<ol>
+ <li><p><b>Q:</b> I want to use <tt>ifplugd</tt> with my PCMCIA device, but <tt>ifplugd</tt> quits
+ when it doesn't find <tt>eth0</tt>, when I have not inserted the
+ card. What can I do?</p>
+
+ <p><b>A:</b> Use the <tt>-f</tt> switch. This is not very clean however,
+ since modprobe is called on each cable detection query of <tt>ifplugd</tt> to
+ load a module for the network device. This is suboptimal. You should
+ probably run <tt>ifplugd</tt> only when the card is really inserted.</p>
+ </li>
+
+ <li><p><b>Q:</b> I am using the <tt>-f</tt> switch, but the kernel logs are getting filled
+ with messages like "<tt>modprobe: modprobe: Can't locate module
+ eth0</tt>". What can I do?</p>
+
+ <p><b>A:</b> Make sure you have a line like <tt>alias eth0 off</tt> in your <tt>/etc/modules.conf</tt></p>
+ </li>
+
+ <li><p><b>Q:</b> When the cable is unplugged and the interface shut down it is
+ still available with <tt>ifconfig</tt> and markes as UP. Why this?</p>
+
+ <p><b>A:</b> <tt>ifplugd</tt> cannot detect the link beat with a shut down interface on
+ certain (most as of kernel 2.4.19) network drivers. Thus <tt>ifplugd</tt>
+ enables the interface before querying the link status. This may
+ be switched off with -a flag. You might want to use it if you
+ have a sane network driver (e.g. <tt>eepro100</tt>). The subdirectory
+ <tt>patches/</tt> in the <tt>ifplugd</tt> distribution includes a patch for the
+ 8139too 0.9.26 driver, which makes the driver compatible with
+ -a. Don't ask me how to apply this patch. If you don't know, you
+ won't need it.</p></li>
+
+ <li><p><b>Q:</b> Does it work with anything else than plain ethernet or wireless LAN?</p>
+
+ <p><b>A:</b> Certainly not, since the <tt>MII</tt> and
+<tt>ETHTOOL</tt> <tt>ioctl()</tt>s and the wireless extension don't
+exist on
+ other network device types.</p></li>
+
+ <li><p><b>Q:</b> I have a Realtek 8139 based network card. Everytime <tt>ifplugd</tt>
+ starts on bootup my machine freezes. What can I do?</p>
+
+ <p><b>A:</b> This is a bug in the <tt>8139too</tt> driver 0.9.25 (at least) shipped
+ with Linux 2.4.19, please upgrade to <tt>8139too</tt> 0.9.26 (Linux 2.4.20
+ or seperately at <a href="http://www.sourceforge.net/projects/gkernel/">http://www.sourceforge.net/projects/gkernel/</a>).</p></li>
+
+
+ <li><p><b>Q:</b> There are already <tt>laptop-net</tt>'s <tt>ifd</tt> and <tt>miid</tt>, why did you write
+ your own daemon?</p>
+
+ <p><b>A:</b> <tt>laptop-net</tt> was too integrated with its profile
+system and didn't work on my hardware when I had a look on it. It
+seemed easier to me to write a simple but feature complete replacement
+than using laptop-net without most of the special features disabled. I
+didn't know about <tt>miid</tt> when I wrote
+ <tt>ifplugd</tt>, but in any case <tt>ifplugd</tt> is much better
+than <tt>miid</tt>. For a
+ comparison of <tt>miid</tt> and <tt>ifplugd</tt>, have a look on
+
+ <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=162763&amp;repeatmerged=yes">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=162763&amp;repeatmerged=yes</a></p></li>
+</ol>
+
+
+<h2><a name="requirements">Requirements</a></h2>
+
+<p>A newer Linux Kernel (I think 2.2 is good enough, alltough I tested it
+only with 2.4) with a compatible device driver and
+ethernet card. Most modern cards and drivers are compatible, like mine
+which works with the <tt>8139too</tt> driver.</p>
+
+<p><tt>ifplugd</tt> was developed and tested on Debian GNU/Linux
+"testing" from July 2003, it should work on most other Linux
+distributions (and maybe Unix versions) since it uses GNU autoconf and
+GNU libtool for source code configuration and shared library
+management.</p>
+
+<p>The machine used was a Medion 9580-F laptop with a Realtek 8139
+network card and a PRISM1 PCMCIA wireless LAN card.</p>
+
+<p><tt>ifplugd</tt> needs <a
+href="http://0pointer.de/lennart/projects/libdaemon/"><tt>libdaemon</tt></a>.</p>
+
+<h2><a name="installation">Installation</a></h2>
+
+<p>As this package is made with the GNU autotools you should run
+<tt>./configure</tt> inside the distribution directory for configuring
+the source tree. After that you should run <tt>make</tt> for
+compilation and <tt>make install</tt> (as root) for installation of
+<tt>ifplugd</tt>.</p>
+
+<p>The installation scripts create an init script in
+<tt>${sysconfdir}/init.d/ifplugd</tt>, however no <tt>/etc/rc?.d/</tt> links are created
+for it.</p>
+
+<p>Extensive installation instructions for installation of <tt>ifplugd</tt> on Fedora Core 1 are available at <a href="http://www.acmc.uq.edu.au/~gbe/linux/installation_of_ifplugd.html">Geoff Ericksson's web site</a>.</p>
+
+<h2><a name="acks">Acknowledgements</a></h2>
+
+<p>For the developers of <tt>mii-diag</tt>, <tt>ethtool</tt> and <tt>laptop-net</tt>, since I looked
+on their source codes for learning how to use the link beat ioctls.</p>
+
+<p>Oliver Kurth for packaging <tt>ifplugd</tt> for Debian and <tt>ifplugd</tt>'s
+manpage</p>
+
+<p>Thomas Hood, Asgeir Nilsen, Sean Reifschneider, R. Steve McKown, David Mitchell, Norbert Preining, Herbert Graeber for patches</p>
+
+<p>Frederic Lepied for integrating <tt>ifplugd</tt> into Mandrake Linux</p>
+
+<h2><a name="download">Download</a></h2>
+
+<p>The newest release is always available from <a href="http://0pointer.de/lennart/projects/ifplugd/">http://0pointer.de/lennart/projects/ifplugd/</a></p>
+
+<p>The current release is <a href="http://0pointer.de/lennart/projects/ifplugd/ifplugd-0.26.tar.gz">0.26</a></p>
+
+<p>Get <tt>ifplugd</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="svn://seth.intheinter.net/ifplugd">repository</a> (<a href="http://0pointer.de/cgi-bin/viewcvs.cgi/?root=ifplugd">viewcvs</a>): </p>
+
+<pre>svn checkout svn://seth.intheinter.net/ifplugd/trunk ifplugd</pre>
+
+<p>You may find an up to date Debian package of <tt>ifplugd</tt> on the <a href="http://packages.debian.org/ifplugd">Debian package repository</a>.</p>
+
+<p>Packages for Mandrake Linux may be found in the Cooker distribution; Gentoo packages are available as well; <a href="http://packman.links2linux.de/">SuSE packages</a> are available courtesy of Herbert Graeber.</p>
+
+<p>If you want to be notified whenever I release a new version of this software use the subscription feature of <a href="http://freshmeat.net/projects/ifplugd/">Freshmeat</a>.</p>
+
+<p><b>New!</b> There is a joint <tt>ifplugd</tt> and <tt>waproamd</tt> <a href="https://seth.intheinter.net/mailman/listinfo/ifplugd-discuss">mailing list</a> available.</p>
+
+<hr/>
+<address class="grey">Lennart Poettering &lt;mzvscyhtq (at) 0pointer (dot) de&gt;, December 2004</address>
+<div class="grey"><i>$Id: README.html.in 117 2004-12-19 00:30:39Z lennart $</i></div>
+
+</body>
+</html>
diff --git a/doc/README.html.in b/doc/README.html.in
new file mode 100644
index 0000000..1a3c8ab
--- /dev/null
+++ b/doc/README.html.in
@@ -0,0 +1,344 @@
+<?xml version="1.0" encoding="iso-8859-1"?> <!-- -*-html-helper-*- -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>ifplugd @PACKAGE_VERSION@</title>
+<link rel="stylesheet" type="text/css" href="style.css" />
+</head>
+
+<body>
+<h1><a name="top">ifplugd @PACKAGE_VERSION@</a></h1>
+
+<p><i>Copyright 2002-2004 Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;</i></p>
+
+<ul class="toc">
+ <li><a href="#license">License</a></li>
+ <li><a href="#news">News</a></li>
+ <li><a href="#overview">Overview</a></li>
+ <li><a href="#status">Status</a></li>
+ <li><a href="#documentation">Documentation</a></li>
+ <li><a href="#requirements">Requirements</a></li>
+ <li><a href="#installation">Installation</a></li>
+ <li><a href="#acks">Acknowledgements</a></li>
+ <li><a href="#download">Download</a></li>
+</ul>
+
+<h2><a name="license">License</a></h2>
+
+<p>This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License as
+published by the Free Software Foundation; either version 2 of the
+License, or (at your option) any later version.</p>
+
+<p>This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+General Public License for more details.</p>
+
+<p>You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</p>
+
+<h2><a name="news">News</a></h2>
+
+<div class="news-date">Sun Dec 19 2004: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.26.tar.gz">Version 0.26</a> released,
+changes include: changed MII code for better compatibility with some 3COM Boomerang cards.</p>
+
+<div class="news-date">Mon May 10 2004: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.25.tar.gz">Version 0.25</a> released,
+changes include: Revert to more classic link checking support. The new
+checking order is: ETHTOOL, MII, WLAN, IFF. The obsolete API "PRIV" is
+no longer checked by the automatic API detection code. However, you may enable
+it forcibly by passing <tt>-m priv</tt> on the command line.</p>
+
+<div class="news-date">Mon Apr 12 2004: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.24.tar.gz">Version
+0.24</a> released, changes include: add <tt>IFF_RUNNING</tt> link check support and make it the default. This might break some setups. You may workaround this by passing <tt>-m</tt> to the daemon for selecting a different API. Please report breakages!</p>
+
+<div class="news-date">Wed Apr 7 2004: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.23.tar.gz">Version
+0.23</a> released, changes include: don't make <tt>/dev/tty1</tt> the controlling TTY when beeping</p>
+
+<div class="news-date">Tue Feb 10 2004: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.22.tar.gz">Version
+0.22</a> released, changes include: rename <tt>ifstatus</tt> to <tt>ifplugstatus</tt> due to namespace collision, minor fixes</p>
+
+<div class="news-date">Mon Jan 26 2004: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.21b.tar.gz">Version
+0.21b</a> released, added missing file.</p>
+
+<div class="news-date">Mon Jan 26 2004: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.21.tar.gz">Version
+0.21</a> released, changes include: better compatibility with wireless devices, compatibility with newer kernels</p>
+
+<div class="news-date">Sun Nov 9 2003: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.20.tar.gz">Version
+0.20</a> released, changes include: fix wrong message, build fix</p>
+
+<div class="news-date">Mon Oct 20 2003: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.19.tar.gz">Version
+0.19</a> released, changes include: New option <tt>--wait-for-kill</tt>, this requires <a href="http://0pointer.de/lennart/projects/libdaemon/"><tt>libdaemon 0.3</tt></a></p>
+
+<div class="news-date">Fri Oct 17 2003: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.18.tar.gz">Version
+0.18</a> released, changes include: Some bugs fixed</p>
+
+<div class="news-date">Fri Sep 13 2003: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.17b.tar.gz">Version
+0.17b</a> released, changes include: typo and date fix</p>
+
+<div class="news-date">Fri Sep 13 2003: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.17.tar.gz">Version
+0.17</a> released, changes include: documentation update, better support for multiple interfaces, gcc 2.95 build fix</p>
+
+<div class="news-date">Thu Aug 13 2003: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.16.tar.gz">Version
+0.16</a> released, changes include: RPM spec file added, build fixes, WLAN improvements (including compatibility with the upcoming <tt>waproamd</tt>, a WLAN roaming daemon), monitor mode for use in conjunction with PCMCIA devices, better support for multiple interface setups, <tt>SUPPORTED_DRIVERS</tt> returns</p>
+
+<div class="news-date">Thu July 10 2003: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.15.tar.gz">Version
+0.15</a> released, changes include: bad umask fix, documentation update</p>
+
+<div class="news-date">Mon July 7 2003: </div> <p class="news-text"><a
+href="@PACKAGE_URL@ifplugd-0.14.tar.gz">Version
+0.14</a> released, changes include: autoconf usage, new dependency <a
+href="http://0pointer.de/lennart/projects/libdaemon/"><tt>libdaemon</tt></a>, wireless LAN support, support for
+suspending/resuming, many fixes</p>
+
+<h2><a name="overview">Overview</a></h2>
+
+<p><tt>ifplugd</tt> is a Linux daemon which will automatically
+configure your ethernet device when a cable is plugged in and
+automatically unconfigure it if the cable is pulled. This is useful on
+laptops with onboard network adapters, since it will only configure
+the interface when a cable is really connected.</p>
+
+<p><tt>ifplugd</tt> ifplugd interfaces with your distribution's native network
+ configuration utilities.</p>
+
+<p>Some features:</p>
+
+<ul>
+ <li>Uses your distribution's native <tt>ifup</tt>/<tt>ifdown</tt> programs.</li>
+
+ <li>May beep when the cable is unplugged, plugged, the interface
+ configuration succeeded or failed.</li>
+
+ <li>Supports the Linux <tt>SIOCETHTOOL</tt> (newer, aka <tt>ethtool</tt> API), <tt>SIOCGMIIREG</tt>
+ (older, aka <tt>mii-diag</tt>/<tt>mii-tool</tt> API) and SIOCDEVPRIVATE (oldest, aka
+ <tt>mii-tool</tt> API) <tt>ioctl()</tt>s for getting link status. Release 0.24 introduces support for link detection with the <tt>IFF_RUNNING</tt> interface flag.</li>
+
+ <li>Syslog support</li>
+
+ <li>Small program - the binary is just 25 KB (plus 16 KB for <tt>libdaemon</tt>).</li>
+
+ <li>Multiple ethernet interface support</li>
+
+ <li>Can be configured to ignore short "unplugged" periods
+ (-d option) or short "plugged" periods(<tt>-u</tt>
+ option)</li>
+
+ <li>Support for wireless networking. Whenever an association to an
+AP is detected the network is configured. Have a look on <a
+href="http://0pointer.de/lennart/projects/waproamd/"><tt>waproamd</tt></a>
+if you need a facility to configure WEP keys before AP associations succeed.</li>
+
+ <li>Compatibility mode for network devices which do not support cable detection (<tt>-F</tt> option)</li>
+</ul>
+
+<h2><a name="status">Status</a></h2>
+
+<p>Version @PACKAGE_VERSION@ is stable and has all the sensible features its users could think of.</p>
+
+<h2><a name="documentation">Documentation</a></h2>
+
+<p>Have a look on the man pages <a href="@PACKAGE_URL@ifplugd.8.xml"><tt>ifplugd(8)</tt></a>, <a href="@PACKAGE_URL@ifplugstatus.8.xml"><tt>ifplugstatus(8)</tt></a>, <a href="@PACKAGE_URL@ifplugd.conf.5.xml"><tt>ifplugd.conf(5)</tt></a>. (An XSLT capable browser is required)</p>
+
+<h3>Configuration</h3>
+
+<p>Edit <tt>/etc/ifplugd/ifplugd.conf</tt> for configuration
+changes. This file is a bourne shell script sourced by the init script
+and used to start <tt>ifplugd</tt> with appropriate arguments. You may specify more than
+one ethernet interface in <tt>INTERFACES</tt>. For each interface a
+seperate instance of <tt>ifplugd</tt> is spawned. The arguments specified in
+<tt>ARGS</tt> are append to <tt>ifplugd</tt>'s command line. Have a look on
+<tt>ifplugd -h</tt> or <tt>man ifplugd</tt> for further information
+about the available options.</p>
+
+<p>The network interface which is controlled by <tt>ifplugd</tt>
+should not be configured automatically by your distribution's network
+subsystem, since <tt>ifplugd</tt> will do this for you if needed.</p>
+
+<p>On Debian systems, any interfaces named in ifplugd's
+<tt>INTERFACES</tt> environment variable should not also be listed in
+an "auto" stanza in <tt>/etc/network/interfaces</tt>.</p>
+
+<h3>Troubleshooting</h3>
+
+<p>When you are using the hotplug subsystem (Debian package
+<tt>hotplug</tt>) you may notice that the network device is configured
+even when it is not listed on an <tt>auto</tt> line in
+<tt>/etc/network/interface</tt>. This may be due to <tt>hotplug</tt>
+being configured to <tt>ifup</tt> the network interface when it
+becomes available. This was the default behavior in the Debian
+<tt>hotplug</tt> package prior to release <tt>0.0.20030117-1</tt>, for
+example. To prevent this you should either upgrade your
+<tt>hotplug</tt> package or comment out the <tt>ifup</tt> call in
+<tt>/etc/hotplug/net.agent</tt>.</p>
+
+<p>When using <tt>ifplugd</tt> together with APM (and probably ACPI)
+suspends, strange things may happen: some network devices fail to
+detect the network cable for a short period of time before and after
+the suspend. When using the <tt>-f</tt> switch, this will be treated
+as "no link beat", thus the network is shutdown after a
+timeout. During this timeout the machine changes to suspended
+state. When it is resumed again, the timeout period will have expired
+and so the network is deconfigured, however, as the next cable
+detection succeeds, the network is configured again immediately. To
+fix this problem, <tt>ifplugd</tt> should be disabled before the APM
+suspend and enabled back after the suspend. This may be done by using
+<tt>apmd</tt> and adding a script to
+<tt>/etc/apm/{suspend,resume}.d</tt> which simply calls
+<tt>/etc/init.d/ifplugd suspend</tt>, resp. <tt>/etc/init.d/ifplugd
+resume</tt>. It might even be a good idea to shut down the network
+completely during suspend, this may be achieved by calling
+<tt>/etc/init.d/ifplugd stop</tt> and <tt>/etc/init.d/ifplugd
+start</tt> in the appropriate places. I strongly urge the packagers of
+this software for the Linux distributions to add such scripts to their
+packages.</p>
+
+<h3>FAQ</h3>
+
+<ol>
+ <li><p><b>Q:</b> I want to use <tt>ifplugd</tt> with my PCMCIA device, but <tt>ifplugd</tt> quits
+ when it doesn't find <tt>eth0</tt>, when I have not inserted the
+ card. What can I do?</p>
+
+ <p><b>A:</b> Use the <tt>-f</tt> switch. This is not very clean however,
+ since modprobe is called on each cable detection query of <tt>ifplugd</tt> to
+ load a module for the network device. This is suboptimal. You should
+ probably run <tt>ifplugd</tt> only when the card is really inserted.</p>
+ </li>
+
+ <li><p><b>Q:</b> I am using the <tt>-f</tt> switch, but the kernel logs are getting filled
+ with messages like "<tt>modprobe: modprobe: Can't locate module
+ eth0</tt>". What can I do?</p>
+
+ <p><b>A:</b> Make sure you have a line like <tt>alias eth0 off</tt> in your <tt>/etc/modules.conf</tt></p>
+ </li>
+
+ <li><p><b>Q:</b> When the cable is unplugged and the interface shut down it is
+ still available with <tt>ifconfig</tt> and markes as UP. Why this?</p>
+
+ <p><b>A:</b> <tt>ifplugd</tt> cannot detect the link beat with a shut down interface on
+ certain (most as of kernel 2.4.19) network drivers. Thus <tt>ifplugd</tt>
+ enables the interface before querying the link status. This may
+ be switched off with -a flag. You might want to use it if you
+ have a sane network driver (e.g. <tt>eepro100</tt>). The subdirectory
+ <tt>patches/</tt> in the <tt>ifplugd</tt> distribution includes a patch for the
+ 8139too 0.9.26 driver, which makes the driver compatible with
+ -a. Don't ask me how to apply this patch. If you don't know, you
+ won't need it.</p></li>
+
+ <li><p><b>Q:</b> Does it work with anything else than plain ethernet or wireless LAN?</p>
+
+ <p><b>A:</b> Certainly not, since the <tt>MII</tt> and
+<tt>ETHTOOL</tt> <tt>ioctl()</tt>s and the wireless extension don't
+exist on
+ other network device types.</p></li>
+
+ <li><p><b>Q:</b> I have a Realtek 8139 based network card. Everytime <tt>ifplugd</tt>
+ starts on bootup my machine freezes. What can I do?</p>
+
+ <p><b>A:</b> This is a bug in the <tt>8139too</tt> driver 0.9.25 (at least) shipped
+ with Linux 2.4.19, please upgrade to <tt>8139too</tt> 0.9.26 (Linux 2.4.20
+ or seperately at <a href="http://www.sourceforge.net/projects/gkernel/">http://www.sourceforge.net/projects/gkernel/</a>).</p></li>
+
+
+ <li><p><b>Q:</b> There are already <tt>laptop-net</tt>'s <tt>ifd</tt> and <tt>miid</tt>, why did you write
+ your own daemon?</p>
+
+ <p><b>A:</b> <tt>laptop-net</tt> was too integrated with its profile
+system and didn't work on my hardware when I had a look on it. It
+seemed easier to me to write a simple but feature complete replacement
+than using laptop-net without most of the special features disabled. I
+didn't know about <tt>miid</tt> when I wrote
+ <tt>ifplugd</tt>, but in any case <tt>ifplugd</tt> is much better
+than <tt>miid</tt>. For a
+ comparison of <tt>miid</tt> and <tt>ifplugd</tt>, have a look on
+
+ <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=162763&amp;repeatmerged=yes">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=162763&amp;repeatmerged=yes</a></p></li>
+</ol>
+
+
+<h2><a name="requirements">Requirements</a></h2>
+
+<p>A newer Linux Kernel (I think 2.2 is good enough, alltough I tested it
+only with 2.4) with a compatible device driver and
+ethernet card. Most modern cards and drivers are compatible, like mine
+which works with the <tt>8139too</tt> driver.</p>
+
+<p><tt>ifplugd</tt> was developed and tested on Debian GNU/Linux
+"testing" from July 2003, it should work on most other Linux
+distributions (and maybe Unix versions) since it uses GNU autoconf and
+GNU libtool for source code configuration and shared library
+management.</p>
+
+<p>The machine used was a Medion 9580-F laptop with a Realtek 8139
+network card and a PRISM1 PCMCIA wireless LAN card.</p>
+
+<p><tt>ifplugd</tt> needs <a
+href="http://0pointer.de/lennart/projects/libdaemon/"><tt>libdaemon</tt></a>.</p>
+
+<h2><a name="installation">Installation</a></h2>
+
+<p>As this package is made with the GNU autotools you should run
+<tt>./configure</tt> inside the distribution directory for configuring
+the source tree. After that you should run <tt>make</tt> for
+compilation and <tt>make install</tt> (as root) for installation of
+<tt>ifplugd</tt>.</p>
+
+<p>The installation scripts create an init script in
+<tt>${sysconfdir}/init.d/ifplugd</tt>, however no <tt>/etc/rc?.d/</tt> links are created
+for it.</p>
+
+<p>Extensive installation instructions for installation of <tt>ifplugd</tt> on Fedora Core 1 are available at <a href="http://www.acmc.uq.edu.au/~gbe/linux/installation_of_ifplugd.html">Geoff Ericksson's web site</a>.</p>
+
+<h2><a name="acks">Acknowledgements</a></h2>
+
+<p>For the developers of <tt>mii-diag</tt>, <tt>ethtool</tt> and <tt>laptop-net</tt>, since I looked
+on their source codes for learning how to use the link beat ioctls.</p>
+
+<p>Oliver Kurth for packaging <tt>ifplugd</tt> for Debian and <tt>ifplugd</tt>'s
+manpage</p>
+
+<p>Thomas Hood, Asgeir Nilsen, Sean Reifschneider, R. Steve McKown, David Mitchell, Norbert Preining, Herbert Graeber for patches</p>
+
+<p>Frederic Lepied for integrating <tt>ifplugd</tt> into Mandrake Linux</p>
+
+<h2><a name="download">Download</a></h2>
+
+<p>The newest release is always available from <a href="@PACKAGE_URL@">@PACKAGE_URL@</a></p>
+
+<p>The current release is <a href="@PACKAGE_URL@ifplugd-@PACKAGE_VERSION@.tar.gz">@PACKAGE_VERSION@</a></p>
+
+<p>Get <tt>ifplugd</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="svn://seth.intheinter.net/ifplugd">repository</a> (<a href="http://0pointer.de/cgi-bin/viewcvs.cgi/?root=ifplugd">viewcvs</a>): </p>
+
+<pre>svn checkout svn://seth.intheinter.net/ifplugd/trunk ifplugd</pre>
+
+<p>You may find an up to date Debian package of <tt>ifplugd</tt> on the <a href="http://packages.debian.org/ifplugd">Debian package repository</a>.</p>
+
+<p>Packages for Mandrake Linux may be found in the Cooker distribution; Gentoo packages are available as well; <a href="http://packman.links2linux.de/">SuSE packages</a> are available courtesy of Herbert Graeber.</p>
+
+<p>If you want to be notified whenever I release a new version of this software use the subscription feature of <a href="http://freshmeat.net/projects/ifplugd/">Freshmeat</a>.</p>
+
+<p><b>New!</b> There is a joint <tt>ifplugd</tt> and <tt>waproamd</tt> <a href="https://seth.intheinter.net/mailman/listinfo/ifplugd-discuss">mailing list</a> available.</p>
+
+<hr/>
+<address class="grey">Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;, December 2004</address>
+<div class="grey"><i>$Id: README.html.in 117 2004-12-19 00:30:39Z lennart $</i></div>
+
+</body>
+</html>
diff --git a/doc/SUPPORTED_DRIVERS b/doc/SUPPORTED_DRIVERS
new file mode 100644
index 0000000..47cf8b2
--- /dev/null
+++ b/doc/SUPPORTED_DRIVERS
@@ -0,0 +1,25 @@
+The following list is a short summary of user experiences with certain
+network drivers.
+
+The version prefixed with k is the driver version of the specific
+kernel, the version prefixed with d is the driver version. Versions
+suffixed with p are patched with a patch supplied with ifplugd.
+
+Driver | Version | Support
+---------+----------------------+------------------------------------------------
+eepro100 | k2.4.19 | works fine, even with -a
+e100 | k2.4.20 | works fine, even with -a
+8139too | k2.4.19 | the machine may lock up, doesn't work with -a
+8139too | k2.4.20 or d0.9.26 | works, doesn't work with -a
+8139too | k2.4.20p or d0.9.26p | works, even with -a
+de4x5 | k2.4.18 | Fails completely
+tulip | k2.4.18 | works; does it work with -a???
+3c59x | k2.4.19 and .20 | Works, even with -a
+hostap | d0.0.3 | Works, even with -a
+b44 | k2.6.3-rc2 | Works
+
+Please help me to extend this list and send me
+(mzvscyhtq (at) 0pointer (dot) de) more information about your
+experience with drivers not included in the list above yet.
+
+$Id: SUPPORTED_DRIVERS 103 2004-03-06 20:33:42Z lennart $
diff --git a/doc/style.css b/doc/style.css
new file mode 100644
index 0000000..27f0bdd
--- /dev/null
+++ b/doc/style.css
@@ -0,0 +1,32 @@
+/* $Id: style.css 84 2004-01-16 16:08:55Z lennart $ */
+
+/***
+ * This file is part of ifplugd.
+ *
+ * ifplugd is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * ifplugd is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with ifplugd; if not, write to the Free Software Foundation,
+ * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
+ ***/
+
+body { color: black; background-color: white; margin: 0.5cm; }
+a:link, a:visited { color: #900000; }
+p { margin-left: 0.5cm; margin-right: 0.5cm; }
+div.news-date { margin-left: 0.5cm; font-size: 80%; color: #4f0000; }
+p.news-text { margin-left: 1cm; }
+h1 { color: #00009F; }
+h2 { color: #00009F; }
+h3 { color: #00004F; margin-left: 0.5cm; }
+ul { margin-left: .5cm; }
+ol { margin-left: .5cm; }
+pre { margin-left: .5cm; background-color: #f0f0f0; padding: 0.4cm;}
+.grey { color: #afafaf; }