diff options
author | Andrew Shadura <andrew.shadura@collabora.co.uk> | 2016-06-21 11:57:24 +0200 |
---|---|---|
committer | Andrew Shadura <andrew.shadura@collabora.co.uk> | 2016-06-21 11:57:24 +0200 |
commit | 0af3fe8aecc7ee52a6ee0eb926aab985513c4204 (patch) | |
tree | 1297533f6cec6790a4c11fab567c69a2dfc56369 /doc |
Imported Upstream version 0.26
Diffstat (limited to 'doc')
-rw-r--r-- | doc/Makefile.am | 36 | ||||
-rw-r--r-- | doc/Makefile.in | 305 | ||||
-rw-r--r-- | doc/NEWS | 117 | ||||
-rw-r--r-- | doc/README | 369 | ||||
-rw-r--r-- | doc/README.SuSE | 15 | ||||
-rw-r--r-- | doc/README.html | 344 | ||||
-rw-r--r-- | doc/README.html.in | 344 | ||||
-rw-r--r-- | doc/SUPPORTED_DRIVERS | 25 | ||||
-rw-r--r-- | doc/style.css | 32 |
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 <mzvscyhtq (at) 0pointer (dot) de></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&repeatmerged=yes">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=162763&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 <mzvscyhtq (at) 0pointer (dot) de>, 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 <@PACKAGE_BUGREPORT@></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&repeatmerged=yes">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=162763&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 <@PACKAGE_BUGREPORT@>, 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; } |