summaryrefslogtreecommitdiff
path: root/man
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 /man
Imported Upstream version 0.26
Diffstat (limited to 'man')
-rw-r--r--man/Makefile.am49
-rw-r--r--man/Makefile.in414
-rw-r--r--man/ifplugd.8116
-rw-r--r--man/ifplugd.8.xml.in292
-rw-r--r--man/ifplugd.conf.522
-rw-r--r--man/ifplugd.conf.5.xml.in78
-rw-r--r--man/ifplugstatus.853
-rw-r--r--man/ifplugstatus.8.xml.in127
-rw-r--r--man/xmltoman.css30
-rw-r--r--man/xmltoman.dtd39
-rw-r--r--man/xmltoman.xsl120
11 files changed, 1340 insertions, 0 deletions
diff --git a/man/Makefile.am b/man/Makefile.am
new file mode 100644
index 0000000..5a32080
--- /dev/null
+++ b/man/Makefile.am
@@ -0,0 +1,49 @@
+# $Id: Makefile.am 96 2004-02-01 01:04:52Z 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.
+
+man_MANS = ifplugd.8 ifplugd.conf.5 ifplugstatus.8
+
+noinst_DATA = ifplugd.8.xml ifplugd.conf.5.xml ifplugstatus.8.xml
+
+EXTRA_DIST = $(man_MANS) ifplugd.8.xml.in ifplugd.conf.5.xml.in ifplugstatus.8.xml.in xmltoman.css xmltoman.xsl xmltoman.dtd
+
+CLEANFILES = ifplugd.8.xml ifplugd.conf.5.xml ifplugstatus.8.xml
+
+ifplugd.8.xml: ifplugd.8.xml.in Makefile
+ sed -e 's,@sysconfdir\@,$(sysconfdir),g' -e 's,@sbindir\@,$(sbindir),g' -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+
+ifplugd.conf.5.xml: ifplugd.conf.5.xml.in Makefile
+ sed -e 's,@sysconfdir\@,$(sysconfdir),g' -e 's,@sbindir\@,$(sbindir),g' -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+
+ifplugstatus.8.xml: ifplugstatus.8.xml.in Makefile
+ sed -e 's,@sysconfdir\@,$(sysconfdir),g' -e 's,@sbindir\@,$(sbindir),g' -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+
+if USE_XMLTOMAN
+
+CLEANFILES += $(man_MANS)
+
+ifplugd.8: ifplugd.8.xml Makefile
+ xmltoman $< > $@
+
+ifplugd.conf.5: ifplugd.conf.5.xml Makefile
+ xmltoman $< > $@
+
+ifplugstatus.8: ifplugstatus.8.xml Makefile
+ xmltoman $< > $@
+
+endif
diff --git a/man/Makefile.in b/man/Makefile.in
new file mode 100644
index 0000000..432cfd9
--- /dev/null
+++ b/man/Makefile.in
@@ -0,0 +1,414 @@
+# 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 96 2004-02-01 01:04:52Z 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_XMLTOMAN_TRUE@am__append_1 = $(man_MANS)
+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@
+
+man_MANS = ifplugd.8 ifplugd.conf.5 ifplugstatus.8
+
+noinst_DATA = ifplugd.8.xml ifplugd.conf.5.xml ifplugstatus.8.xml
+
+EXTRA_DIST = $(man_MANS) ifplugd.8.xml.in ifplugd.conf.5.xml.in ifplugstatus.8.xml.in xmltoman.css xmltoman.xsl xmltoman.dtd
+
+CLEANFILES = ifplugd.8.xml ifplugd.conf.5.xml ifplugstatus.8.xml $(am__append_1)
+subdir = man
+ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
+mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
+CONFIG_HEADER = $(top_builddir)/config.h
+CONFIG_CLEAN_FILES =
+DIST_SOURCES =
+
+NROFF = nroff
+MANS = $(man_MANS)
+DATA = $(noinst_DATA)
+
+DIST_COMMON = $(srcdir)/Makefile.in Makefile.am
+all: all-am
+
+.SUFFIXES:
+$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/configure.ac $(ACLOCAL_M4)
+ cd $(top_srcdir) && \
+ $(AUTOMAKE) --foreign man/Makefile
+Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
+ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)
+uninstall-info-am:
+
+man5dir = $(mandir)/man5
+install-man5: $(man5_MANS) $(man_MANS)
+ @$(NORMAL_INSTALL)
+ $(mkinstalldirs) $(DESTDIR)$(man5dir)
+ @list='$(man5_MANS) $(dist_man5_MANS) $(nodist_man5_MANS)'; \
+ l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
+ for i in $$l2; do \
+ case "$$i" in \
+ *.5*) list="$$list $$i" ;; \
+ esac; \
+ done; \
+ for i in $$list; do \
+ if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \
+ else file=$$i; fi; \
+ ext=`echo $$i | sed -e 's/^.*\\.//'`; \
+ case "$$ext" in \
+ 5*) ;; \
+ *) ext='5' ;; \
+ esac; \
+ inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
+ inst=`echo $$inst | sed -e 's/^.*\///'`; \
+ inst=`echo $$inst | sed '$(transform)'`.$$ext; \
+ echo " $(INSTALL_DATA) $$file $(DESTDIR)$(man5dir)/$$inst"; \
+ $(INSTALL_DATA) $$file $(DESTDIR)$(man5dir)/$$inst; \
+ done
+uninstall-man5:
+ @$(NORMAL_UNINSTALL)
+ @list='$(man5_MANS) $(dist_man5_MANS) $(nodist_man5_MANS)'; \
+ l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
+ for i in $$l2; do \
+ case "$$i" in \
+ *.5*) list="$$list $$i" ;; \
+ esac; \
+ done; \
+ for i in $$list; do \
+ ext=`echo $$i | sed -e 's/^.*\\.//'`; \
+ case "$$ext" in \
+ 5*) ;; \
+ *) ext='5' ;; \
+ esac; \
+ inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
+ inst=`echo $$inst | sed -e 's/^.*\///'`; \
+ inst=`echo $$inst | sed '$(transform)'`.$$ext; \
+ echo " rm -f $(DESTDIR)$(man5dir)/$$inst"; \
+ rm -f $(DESTDIR)$(man5dir)/$$inst; \
+ done
+
+man8dir = $(mandir)/man8
+install-man8: $(man8_MANS) $(man_MANS)
+ @$(NORMAL_INSTALL)
+ $(mkinstalldirs) $(DESTDIR)$(man8dir)
+ @list='$(man8_MANS) $(dist_man8_MANS) $(nodist_man8_MANS)'; \
+ l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
+ for i in $$l2; do \
+ case "$$i" in \
+ *.8*) list="$$list $$i" ;; \
+ esac; \
+ done; \
+ for i in $$list; do \
+ if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \
+ else file=$$i; fi; \
+ ext=`echo $$i | sed -e 's/^.*\\.//'`; \
+ case "$$ext" in \
+ 8*) ;; \
+ *) ext='8' ;; \
+ esac; \
+ inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
+ inst=`echo $$inst | sed -e 's/^.*\///'`; \
+ inst=`echo $$inst | sed '$(transform)'`.$$ext; \
+ echo " $(INSTALL_DATA) $$file $(DESTDIR)$(man8dir)/$$inst"; \
+ $(INSTALL_DATA) $$file $(DESTDIR)$(man8dir)/$$inst; \
+ done
+uninstall-man8:
+ @$(NORMAL_UNINSTALL)
+ @list='$(man8_MANS) $(dist_man8_MANS) $(nodist_man8_MANS)'; \
+ l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
+ for i in $$l2; do \
+ case "$$i" in \
+ *.8*) list="$$list $$i" ;; \
+ esac; \
+ done; \
+ for i in $$list; do \
+ ext=`echo $$i | sed -e 's/^.*\\.//'`; \
+ case "$$ext" in \
+ 8*) ;; \
+ *) ext='8' ;; \
+ esac; \
+ inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
+ inst=`echo $$inst | sed -e 's/^.*\///'`; \
+ inst=`echo $$inst | sed '$(transform)'`.$$ext; \
+ echo " rm -f $(DESTDIR)$(man8dir)/$$inst"; \
+ rm -f $(DESTDIR)$(man8dir)/$$inst; \
+ done
+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 $(MANS) $(DATA)
+
+installdirs:
+ $(mkinstalldirs) $(DESTDIR)$(man5dir) $(DESTDIR)$(man8dir)
+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."
+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-man
+
+install-exec-am:
+
+install-info: install-info-am
+
+install-man: install-man5 install-man8
+
+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 uninstall-man
+
+uninstall-man: uninstall-man5 uninstall-man8
+
+.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-man5 install-man8 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 \
+ uninstall-man uninstall-man5 uninstall-man8
+
+
+ifplugd.8.xml: ifplugd.8.xml.in Makefile
+ sed -e 's,@sysconfdir\@,$(sysconfdir),g' -e 's,@sbindir\@,$(sbindir),g' -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+
+ifplugd.conf.5.xml: ifplugd.conf.5.xml.in Makefile
+ sed -e 's,@sysconfdir\@,$(sysconfdir),g' -e 's,@sbindir\@,$(sbindir),g' -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+
+ifplugstatus.8.xml: ifplugstatus.8.xml.in Makefile
+ sed -e 's,@sysconfdir\@,$(sysconfdir),g' -e 's,@sbindir\@,$(sbindir),g' -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+
+@USE_XMLTOMAN_TRUE@ifplugd.8: ifplugd.8.xml Makefile
+@USE_XMLTOMAN_TRUE@ xmltoman $< > $@
+
+@USE_XMLTOMAN_TRUE@ifplugd.conf.5: ifplugd.conf.5.xml Makefile
+@USE_XMLTOMAN_TRUE@ xmltoman $< > $@
+
+@USE_XMLTOMAN_TRUE@ifplugstatus.8: ifplugstatus.8.xml Makefile
+@USE_XMLTOMAN_TRUE@ xmltoman $< > $@
+# 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/man/ifplugd.8 b/man/ifplugd.8
new file mode 100644
index 0000000..302d9d3
--- /dev/null
+++ b/man/ifplugd.8
@@ -0,0 +1,116 @@
+.TH ifplugd 8 User Manuals
+.SH NAME
+ifplugd \- A link detection daemon for ethernet devices
+.SH SYNOPSIS
+\fBifplugd [\fIoptions\fB]
+\f1
+.SH DESCRIPTION
+ifplugd is a 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 on-board network adapters, since it will only configure the interface when a cable is really connected.
+
+It uses your distribution's native ifup/ifdown programs, but can be configured to do anything you wish when the state of the interface changes. It may ignore short unplugged whiles (\fB-d\f1 option) or plugged whiles (\fB-u\f1 option).
+
+ifplugd may be used in "compatibility mode" by specifying -F on the command line. Than ifplugd will treat network drivers which do not support link beat querying as always online.
+.SH OPTIONS
+.TP
+\fB-a | --no-auto\f1
+Do not enable interface automatically (default: off)
+.TP
+\fB-n | --no-daemon\f1
+Do not daemonize (for debugging) (default: off)
+.TP
+\fB-s | --no-syslog\f1
+Do not use syslog, use stdout instead (for debugging) (default: off).
+.TP
+\fB-b | --no-beep\f1
+Do not beep (off)
+.TP
+\fB-f | --ignore-fail\f1
+Ignore detection failure, retry instead. Failure is treated as "no link". (default: off)
+.TP
+\fB-F | --ignore-fail-positive\f1
+Ignore detection failure, retry instead. Failure is treated as "link detected". (default: off)
+.TP
+\fB-i | --iface=\f1 \fIIFACE\f1
+Specify ethernet interface (default: eth0)
+.TP
+\fB-r | --run=\f1 \fIEXEC\f1
+Specify program to execute when link status changes (default: \fI/etc/ifplugd/ifplugd.action\f1)
+.TP
+\fB-I | --ignore-retval\f1
+Don't exit on nonzero return value of program executed on link change. (default: off)
+.TP
+\fB-t | --poll-time=\f1 \fISECS\f1
+Specify poll time in seconds (default: 1)
+.TP
+\fB-u | --delay-up=\f1 \fISECS\f1
+Specify delay for configuring interface (default: 0)
+.TP
+\fB-d | --delay-down=\f1 \fISECS\f1
+Specify delay for deconfiguring interface (default: 5)
+.TP
+\fB-m | --api-mode=\f1 \fIMODE\f1
+Force a specific link beat detection ioctl() API. Possible values are auto, iff, wlan, ethtool, mii, and priv for automatic detection, interface flag (IFF_RUNNING), wireless extension, SIOCETHTOOL, SIOCGMIIREG resp. SIOCPRIV. Only the first character of the argument is relevant, case insensitive. (default: auto)
+.TP
+\fB-q | --no-shutdown\f1
+Don't call the script for network shutdown on deamon quit (default: off)
+.TP
+\fB-w | --wait-on-fork\f1
+When daemonizing, wait until the background process finished with the initial link beat detection. When this is enabled, the parent process will return the link status on exit. 1 means link beat detected, 2 stands for link beat not detected, everything else is an error.
+.TP
+\fB-W | --wait-on-kill\f1
+When killing a running daemon (with -k) wait until the daemon died.
+.TP
+\fB-x | --extra-arg=\f1 \fIARG\f1
+Specify an extra argument to be passed to the action script.
+.TP
+\fB-M | --monitor\f1
+Don't fail when the network interface is not available, instead use NETLINK to monitor device avaibility. The is useful for PCMCIA devices and similar.
+.TP
+\fB-h | --help\f1
+Show help
+.TP
+\fB-k | --kill\f1
+Kill a running daemon (Specify -i to select the daemon instance to kill)
+.TP
+\fB-c | --check-running\f1
+Check if a daemon is running for a given network interface. Sets the return value to 0 if a daemon is already running or to 255 if not.
+.TP
+\fB-v | --version\f1
+Show version
+.TP
+\fB-S | --supend\f1
+Suspend a running daemon. The daemon will no longer check the link status until it is resumed (-R) again. (Specify -i to select the daemon instance to suspend.)
+.TP
+\fB-R | --resume\f1
+Resume a suspended daemon. (Specify -i to select the daemon instance to resume.)
+.TP
+\fB-z | --info\f1
+Request that a running daemon shall write its status information to syslog. (Specify -i to select the daemon instance to send the request to.)
+.SH FILES
+\fI/etc/ifplugd/ifplugd.conf\f1: this file is sourced by the init script \fI/etc/init.d/ifplugd\f1 and contains the interface to be monitored and the options to be used.
+
+\fI/etc/ifplugd/ifplugd.action\f1: this is the script which will be called by the daemon whenever the state of the interface changes. It takes two areguments: the first is the interface name (eg. eth0), the second either "up" or "down".
+
+\fI/var/run/ifplugd.<iface>.pid\f1: the pid file for ifplugd.
+.SH ENVIRONMENT
+The action script will be called with two environment variables set:
+
+\fIIFPLUGD_PREVIOUS\f1 The previous link status. Either "up", "down", "error" or "disabled". The former values should be obvious, the latter is set on daemon startup.
+
+\fIIFPLUGD_CURRENT\f1 The current link status. See above for possible values.
+.SH SIGNALS
+\fISIGINT, SIGTERM\f1 ifplugd will quit, possibly running the shutdown script. This is issued by passing -k to ifplugd.
+
+\fISIGQUIT\f1 ifplugd will quit, the shutdown script is never run.
+
+\fISIGHUP\f1 ifplugd will write its status information to syslog. This is issued by -z.
+
+\fISIGUSR1\f1 ifplugd will go to suspend mode. (-S)
+
+\fISIGUSR2\f1 ifplugd will resume from suspend mode. (-R)
+.SH AUTHOR
+ifplugd was written by Lennart Poettering <mzvscyhtq (at) 0pointer (dot) de>. ifplugd is available at \fBhttp://0pointer.de/lennart/projects/ifplugd/\f1
+.SH SEE ALSO
+\fBifplugd.conf(5)\f1, \fBifup(8)\f1, \fBinterfaces(5)\f1, \fBifconfig(8)\f1, \fBifplugstatus(8)\f1
+.SH COMMENTS
+This man page was written using \fBxmltoman(1)\f1 by Oliver Kurth.
diff --git a/man/ifplugd.8.xml.in b/man/ifplugd.8.xml.in
new file mode 100644
index 0000000..d40f1bc
--- /dev/null
+++ b/man/ifplugd.8.xml.in
@@ -0,0 +1,292 @@
+<?xml version="1.0" standalone='no'?>
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
+
+<!-- $Id: ifplugd.8.xml.in 109 2004-04-12 13:58:11Z 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.
+-->
+
+ <manpage name="ifplugd" section="8" desc="A link detection daemon for ethernet devices">
+
+ <synopsis>
+ <cmd>ifplugd [<arg>options</arg>]</cmd>
+ </synopsis>
+
+ <description>
+ <p>ifplugd is a 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 on-board network adapters, since it will only
+ configure the interface when a cable is really connected.</p>
+
+ <p>It uses your distribution's native ifup/ifdown programs, but
+ can be configured to do anything you wish when the state of
+ the interface changes. It may ignore short unplugged whiles
+ (<opt>-d</opt> option) or plugged whiles (<opt>-u</opt> option).</p>
+
+ <p>ifplugd may be used in "compatibility mode" by specifying -F
+ on the command line. Than ifplugd will treat network drivers
+ which do not support link beat querying as always online.</p>
+
+
+</description>
+
+ <options>
+
+ <option>
+ <p><opt>-a | --no-auto</opt></p>
+ <optdesc><p>
+ Do not enable interface automatically (default: off)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-n | --no-daemon</opt></p>
+ <optdesc><p>
+ Do not daemonize (for debugging) (default: off)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-s | --no-syslog</opt></p>
+ <optdesc><p>
+ Do not use syslog, use stdout instead (for debugging) (default: off).
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-b | --no-beep</opt></p>
+ <optdesc><p>
+ Do not beep (off)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-f | --ignore-fail</opt></p>
+ <optdesc><p>
+ Ignore detection failure, retry instead. Failure is treated as "no link". (default: off)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-F | --ignore-fail-positive</opt></p>
+ <optdesc><p>
+ Ignore detection failure, retry instead. Failure is treated as "link detected". (default: off)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-i | --iface=</opt> <arg>IFACE</arg></p>
+ <optdesc><p>
+ Specify ethernet interface (default: eth0)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-r | --run=</opt> <arg>EXEC</arg></p>
+ <optdesc><p>
+ Specify program to execute when link status changes (default: <file>@sysconfdir@/ifplugd/ifplugd.action</file>)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-I | --ignore-retval</opt></p>
+ <optdesc><p>
+ Don't exit on nonzero return value of program executed on link change. (default: off)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-t | --poll-time=</opt> <arg>SECS</arg></p>
+ <optdesc><p>
+ Specify poll time in seconds (default: 1)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-u | --delay-up=</opt> <arg>SECS</arg></p>
+ <optdesc><p>
+ Specify delay for configuring interface (default: 0)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-d | --delay-down=</opt> <arg>SECS</arg></p>
+ <optdesc><p>
+ Specify delay for deconfiguring interface (default: 5)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-m | --api-mode=</opt> <arg>MODE</arg></p> <optdesc><p>
+ Force a specific link beat detection ioctl() API. Possible
+ values are auto, iff, wlan, ethtool, mii, and priv for automatic
+ detection, interface flag (IFF_RUNNING), wireless extension, SIOCETHTOOL, SIOCGMIIREG
+ resp. SIOCPRIV. Only the first character of the argument is
+ relevant, case insensitive. (default: auto) </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-q | --no-shutdown</opt></p>
+ <optdesc><p>
+ Don't call the script for network shutdown on deamon quit (default: off)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-w | --wait-on-fork</opt></p>
+
+ <optdesc><p> When daemonizing, wait until the background
+ process finished with the initial link beat detection. When
+ this is enabled, the parent process will return the link
+ status on exit. 1 means link beat detected, 2 stands for link
+ beat not detected, everything else is an error.
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-W | --wait-on-kill</opt></p>
+
+ <optdesc><p> When killing a running daemon (with -k) wait
+ until the daemon died.
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-x | --extra-arg=</opt> <arg>ARG</arg></p>
+ <optdesc><p>
+ Specify an extra argument to be passed to the action script.
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-M | --monitor</opt></p>
+ <optdesc><p>
+ Don't fail when the network interface is not available, instead use NETLINK to monitor device avaibility. The is useful for PCMCIA devices and similar.
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-h | --help</opt></p>
+ <optdesc><p>
+ Show help
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-k | --kill</opt></p>
+ <optdesc><p>
+ Kill a running daemon (Specify -i to select the daemon instance to kill)
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-c | --check-running</opt></p>
+ <optdesc><p>
+ Check if a daemon is running for a given network interface. Sets the return value to 0 if a daemon is already running or to 255 if not.
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-v | --version</opt></p>
+ <optdesc><p>
+ Show version
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-S | --supend</opt></p> <optdesc><p> Suspend a running
+ daemon. The daemon will no longer check the link status until
+ it is resumed (-R) again. (Specify -i to select the daemon instance
+ to suspend.) </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-R | --resume</opt></p> <optdesc><p> Resume a suspended
+ daemon. (Specify -i to select the daemon instance
+ to resume.) </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-z | --info</opt></p> <optdesc><p>Request that a
+ running daemon shall write its status information to
+ syslog. (Specify -i to select the daemon instance to send the
+ request to.) </p></optdesc>
+ </option>
+
+ </options>
+
+ <section name="Files">
+
+ <p><file>@sysconfdir@/ifplugd/ifplugd.conf</file>: this file is sourced
+ by the init script <file>@sysconfdir@/init.d/ifplugd</file> and
+ contains the interface to be monitored and the options to be
+ used.</p>
+
+ <p><file>@sysconfdir@/ifplugd/ifplugd.action</file>: this is the script
+ which will be called by the daemon whenever the state of the
+ interface changes. It takes two areguments: the first is the interface
+ name (eg. eth0), the second either "up" or "down". </p>
+
+ <p><file>/var/run/ifplugd.&lt;iface&gt;.pid</file>: the pid file
+ for ifplugd.</p>
+
+ </section>
+
+ <section name="Environment">
+ <p>The action script will be called with two environment variables set:</p>
+
+ <p><arg>IFPLUGD_PREVIOUS</arg> The previous link status. Either
+ "up", "down", "error" or "disabled". The former values should be
+ obvious, the latter is set on daemon startup.</p>
+
+ <p><arg>IFPLUGD_CURRENT</arg> The current link status. See above
+ for possible values.</p>
+
+ </section>
+
+ <section name="Signals">
+ <p><arg>SIGINT, SIGTERM</arg> ifplugd will quit, possibly running the shutdown script. This is issued by passing -k to ifplugd.</p>
+ <p><arg>SIGQUIT</arg> ifplugd will quit, the shutdown script is never run.</p>
+ <p><arg>SIGHUP</arg> ifplugd will write its status information to syslog. This is issued by -z.</p>
+ <p><arg>SIGUSR1</arg> ifplugd will go to suspend mode. (-S)</p>
+ <p><arg>SIGUSR2</arg> ifplugd will resume from suspend mode. (-R)</p>
+ </section>
+
+ <section name="Author">
+ <p>ifplugd was written by Lennart Poettering
+ &lt;@PACKAGE_BUGREPORT@&gt;. ifplugd is available
+ at <url
+ href="@PACKAGE_URL@"/>
+ </p>
+ </section>
+
+ <section name="See also">
+ <p>
+ <manref name="ifplugd.conf" section="5"/>, <manref name="ifup" section="8"/>, <manref name="interfaces"
+ section="5"/>, <manref name="ifconfig" section="8"/>, <manref name="ifplugstatus" section="8"/>
+ </p>
+ </section>
+
+ <section name="Comments">
+ <p>This man page was written using <manref name="xmltoman" section="1"
+ href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
+ </section>
+
+ </manpage>
diff --git a/man/ifplugd.conf.5 b/man/ifplugd.conf.5
new file mode 100644
index 0000000..6e96378
--- /dev/null
+++ b/man/ifplugd.conf.5
@@ -0,0 +1,22 @@
+.TH ifplugd.conf 5 User Manuals
+.SH NAME
+ifplugd.conf \- ifplugd configuration file
+.SH SYNOPSIS
+\fB/etc/ifplugd/ifplugd.conf
+\f1
+.SH DESCRIPTION
+ifplugd.conf is the configuration file for ifplugd. It is a shell script that is sourced by the init script starting the daemon. It shall be used to set environment variables which are interpreted by the init script:
+.SH OPTIONS
+.TP
+\fBINTERFACES\f1
+Specifies the ethernet interfaces to monitor. It has to contain a space seperated list of network interfaces names. Most users will probably use "eth0" here, however you may add additional interfaces for monitoring more than one device. A special value is supported as well: "auto" will enable a more or less working auto detection of available network devices. This won't make you happy when using network module auto loading, since it cannot detect currently unloaded network devices.
+.TP
+\fBARGS\f1
+Additional command line arguments for ifplugd invocation. See \fBifplugd(8)\f1 for further information.
+.TP
+\fBARGS_\f1\fIiface\f1
+If specified for an interface this variable takes precedence over ARGS. This may be useful if more than one network device is present.
+.SH SEE ALSO
+\fBifplugd(8)\f1
+.SH COMMENTS
+This man page was written using \fBxmltoman(1)\f1 by Oliver Kurth.
diff --git a/man/ifplugd.conf.5.xml.in b/man/ifplugd.conf.5.xml.in
new file mode 100644
index 0000000..7da7da0
--- /dev/null
+++ b/man/ifplugd.conf.5.xml.in
@@ -0,0 +1,78 @@
+<?xml version="1.0" standalone='no'?>
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
+
+<!-- $Id: ifplugd.conf.5.xml.in 52 2003-10-17 00:09:23Z 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.
+-->
+
+ <manpage name="ifplugd.conf" section="5" desc="ifplugd configuration file">
+
+ <synopsis>
+ <cmd>@sysconfdir@/ifplugd/ifplugd.conf</cmd>
+ </synopsis>
+
+ <description>
+ <p>ifplugd.conf is the configuration file for ifplugd. It is a
+ shell script that is sourced by the init script starting
+ the daemon. It shall be used to set environment variables which
+ are interpreted by the init script:</p>
+ </description>
+
+ <options>
+
+ <option>
+ <p><opt>INTERFACES</opt></p> <optdesc><p>Specifies the
+ ethernet interfaces to monitor. It has to contain a space
+ seperated list of network interfaces names. Most users will
+ probably use "eth0" here, however you may add additional
+ interfaces for monitoring more than one device. A special
+ value is supported as well: "auto" will enable a more or less
+ working auto detection of available network devices. This
+ won't make you happy when using network module auto loading,
+ since it cannot detect currently unloaded network
+ devices.</p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>ARGS</opt></p> <optdesc><p>Additional command line
+ arguments for ifplugd invocation. See <manref name="ifplugd"
+ section="8"/> for further information.</p></optdesc>
+ </option>
+
+
+ <option>
+ <p><opt>ARGS_</opt><arg>iface</arg></p>
+
+ <optdesc><p>If specified for an interface this variable takes precedence over ARGS. This may be useful if more than one network device is present.</p></optdesc>
+ </option>
+ </options>
+
+ <section name="See also">
+ <p>
+ <manref name="ifplugd" section="8"/>
+ </p>
+ </section>
+
+ <section name="Comments">
+ <p>This man page was written using <manref name="xmltoman" section="1"
+ href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
+ </section>
+
+ </manpage>
diff --git a/man/ifplugstatus.8 b/man/ifplugstatus.8
new file mode 100644
index 0000000..5dde013
--- /dev/null
+++ b/man/ifplugstatus.8
@@ -0,0 +1,53 @@
+.TH ifplugstatus 8 User Manuals
+.SH NAME
+ifplugstatus \- A link beat detection tool
+.SH SYNOPSIS
+\fBifplugstatus [\fIoptions\fB] [\fIINTERFACE\fB]
+\f1
+.SH DESCRIPTION
+ifplugstatus is an utility which may be used to detect the link status of a local Linux ethernet device, much in the same way mii-diag, mii-tool and ethtool work. In fact it supports all three different APIs these three tools use. In addition it supports link checking with the IFF_RUNNING interface flag, which most modern drivers (not only ethernet) support, and association status checking with the wireless extension API for WLAN devices.
+
+The APIs are tried in the following order:
+
+First the newest API: \fISIOCETHTOOL\f1 (aka ethtool API)
+
+Second the next older API: \fISIOCGMIIREG\f1 (aka mii-diag API)
+
+Than the WLAN API: \fIwireless extension\f1 (aka iwconfig API)
+
+Followed by the cleanest API: \fIIFF_RUNNING\f1 (aka ifconfig API)
+
+The oldest API (\fISIOCPRIV\f1 aka mii-tool API) is not tested since it is obsolete.
+
+ifplugstatus may be used in shell script since it returns the current status as return value. It is especially useful to detect the available APIs on the used network driver. (Option \fB-v\f1)
+.SH OPTIONS
+You may specify an ethernet device on the command line. Otherwise ifplugstatus will check all available network interfaces.
+.TP
+\fB-a | --auto\f1
+Enable interface automatically before querying (default: off)
+.TP
+\fB-h | --help\f1
+Show help
+.TP
+\fB-q | --quiet\f1
+Decrease verbosity by one. If the verbosity is < 0, no text will be shown, only the return value is relevant; if the verbosity is = 0, a terse status will be shown; If the verbosity is > 0, detailed information about the used API is returned. (By default the verbosity is 0)
+.TP
+\fB-v | --verbose\f1
+Increase verbosity by one. See option \fB-q\f1.
+.TP
+\fB-V | --version\f1
+Show version
+.SH RETURN VALUES
+\fI0\f1 Success
+
+\fI1\f1 Failure
+
+\fI2\f1 Link beat detected (only available when an interface is specified)
+
+\fI3\f1 Unplugged (same here)
+.SH AUTHOR
+ifplugd was written by Lennart Poettering <mzvscyhtq (at) 0pointer (dot) de>. ifplugd is available at \fBhttp://0pointer.de/lennart/projects/ifplugd/\f1
+.SH SEE ALSO
+\fBmii-diag(8)\f1, \fBmii-tool(8)\f1, \fBethtool(8)\f1, \fBifplugd(8)\f1
+.SH COMMENTS
+This man page was written using \fBxml2man(1)\f1 by Oliver Kurth.
diff --git a/man/ifplugstatus.8.xml.in b/man/ifplugstatus.8.xml.in
new file mode 100644
index 0000000..e9fb2c2
--- /dev/null
+++ b/man/ifplugstatus.8.xml.in
@@ -0,0 +1,127 @@
+<?xml version="1.0"?>
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
+
+<!-- $Id: ifplugstatus.8.xml.in 110 2004-05-10 21:32:00Z 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.
+-->
+
+ <manpage name="ifplugstatus" section="8" desc="A link beat detection tool">
+
+ <synopsis>
+ <cmd>ifplugstatus [<arg>options</arg>] [<arg>INTERFACE</arg>]</cmd>
+ </synopsis>
+
+ <description>
+ <p>ifplugstatus is an utility which may be used to detect the link
+ status of a local Linux ethernet device, much in the same way
+ mii-diag, mii-tool and ethtool work. In fact it supports all
+ three different APIs these three tools use. In addition it supports
+ link checking with the IFF_RUNNING interface flag, which most modern
+ drivers (not only ethernet) support, and association status checking
+ with the wireless extension API for WLAN devices.</p>
+
+ <p>The APIs are tried in the following order:</p>
+
+ <p>First the newest API: <arg>SIOCETHTOOL</arg> (aka ethtool API)</p>
+ <p>Second the next older API: <arg>SIOCGMIIREG</arg> (aka mii-diag API)</p>
+ <p>Than the WLAN API: <arg>wireless extension</arg> (aka iwconfig API)</p>
+ <p>Followed by the cleanest API: <arg>IFF_RUNNING</arg> (aka ifconfig API)</p>
+
+ <p>The oldest API (<arg>SIOCPRIV</arg> aka mii-tool API) is not tested since it is obsolete.</p>
+
+ <p>ifplugstatus may be used in shell script since it returns the
+ current status as return value. It is especially useful to
+ detect the available APIs on the used network driver. (Option
+ <opt>-v</opt>)</p>
+ </description>
+
+ <options>
+
+ <p>You may specify an ethernet device on the command
+ line. Otherwise ifplugstatus will check all available network interfaces.</p>
+
+ <option>
+ <p><opt>-a | --auto</opt></p>
+ <optdesc><p>
+ Enable interface automatically before querying (default: off)
+ </p></optdesc>
+ </option>
+
+
+ <option>
+ <p><opt>-h | --help</opt></p>
+ <optdesc><p>
+ Show help
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-q | --quiet</opt></p> <optdesc><p>Decrease verbosity
+ by one. If the verbosity is &lt; 0, no text will be shown,
+ only the return value is relevant; if the verbosity is = 0, a
+ terse status will be shown; If the verbosity is &gt; 0,
+ detailed information about the used API is returned. (By
+ default the verbosity is 0)</p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-v | --verbose</opt></p>
+ <optdesc><p>
+ Increase verbosity by one. See option <opt>-q</opt>.
+ </p></optdesc>
+ </option>
+
+ <option>
+ <p><opt>-V | --version</opt></p>
+ <optdesc><p>
+ Show version
+ </p></optdesc>
+ </option>
+
+ </options>
+
+ <section name="Return values">
+ <p><arg>0</arg> Success</p>
+ <p><arg>1</arg> Failure</p>
+ <p><arg>2</arg> Link beat detected (only available when an interface is specified)</p>
+ <p><arg>3</arg> Unplugged (same here)</p>
+ </section>
+
+ <section name="Author">
+ <p>ifplugd was written by Lennart Poettering
+ &lt;@PACKAGE_BUGREPORT@&gt;. ifplugd is available
+ at <url
+ href="@PACKAGE_URL@"/>
+ </p>
+ </section>
+
+ <section name="See also">
+ <p>
+ <manref name="mii-diag" section="8"/>, <manref name="mii-tool"
+ section="8"/>, <manref name="ethtool" section="8"/>, <manref name="ifplugd" section="8"/>
+ </p>
+ </section>
+
+ <section name="Comments">
+ <p>This man page was written using <manref name="xml2man" section="1"
+ href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
+ </section>
+
+ </manpage>
diff --git a/man/xmltoman.css b/man/xmltoman.css
new file mode 100644
index 0000000..caab604
--- /dev/null
+++ b/man/xmltoman.css
@@ -0,0 +1,30 @@
+/* $Id: xmltoman.css 52 2003-10-17 00:09:23Z 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; }
+h1 { text-transform:uppercase; font-size: 18pt; color: #00009F; }
+p { margin-left:1cm; margin-right:1cm; }
+.cmd { font-family:monospace; }
+.file { font-family:monospace; }
+.arg { text-transform:uppercase; font-family:monospace; font-style: italic; }
+.opt { font-family:monospace; font-weight: bold; }
+.manref { font-family:monospace; }
+.option .optdesc { margin-left:2cm; }
diff --git a/man/xmltoman.dtd b/man/xmltoman.dtd
new file mode 100644
index 0000000..42809db
--- /dev/null
+++ b/man/xmltoman.dtd
@@ -0,0 +1,39 @@
+<!-- $Id: xmltoman.dtd 60 2003-10-20 22:05:22Z 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.
+-->
+
+<!ELEMENT manpage (synopsis | description | section | options | seealso)*>
+<!ATTLIST manpage name CDATA #REQUIRED section CDATA #REQUIRED desc CDATA #IMPLIED>
+<!ELEMENT arg (#PCDATA)>
+<!ELEMENT p (#PCDATA | arg | url | manref | opt | file )*>
+<!ELEMENT synopsis (cmd | p)+>
+<!ELEMENT description (p)+>
+<!ELEMENT section (p | option)*>
+<!ATTLIST section name CDATA #REQUIRED>
+<!ELEMENT option (#PCDATA | p | optdesc)*>
+<!ELEMENT optdesc (#PCDATA | p )*>
+<!ELEMENT cmd (#PCDATA | arg)*>
+<!ELEMENT options (p | option)*>
+<!ELEMENT seealso (p)*>
+<!ELEMENT opt (#PCDATA)>
+<!ELEMENT file (#PCDATA)>
+<!ELEMENT manref EMPTY>
+<!ATTLIST manref name CDATA #REQUIRED section CDATA #REQUIRED href CDATA #IMPLIED>
+<!ELEMENT url EMPTY>
+<!ATTLIST url href CDATA #REQUIRED>
diff --git a/man/xmltoman.xsl b/man/xmltoman.xsl
new file mode 100644
index 0000000..2048708
--- /dev/null
+++ b/man/xmltoman.xsl
@@ -0,0 +1,120 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns="http://www.w3.org/1999/xhtml">
+
+<!--
+ 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.
+-->
+
+<xsl:template match="/manpage">
+ <xsl:text disable-output-escaping="yes">
+ &lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"&gt;
+ </xsl:text>
+ <html>
+
+ <head>
+ <title>
+ <xsl:value-of select="@name"/>(<xsl:value-of select="@section"/>)
+ </title>
+ <link rel="stylesheet" type="text/css" href="xmltoman.css"/>
+ </head>
+ <body>
+ <h1>Name</h1>
+ <p><xsl:value-of select="@name"/>
+ <xsl:if test="string-length(@desc) &gt; 0">
+ - <xsl:value-of select="@desc"/>
+ </xsl:if>
+ </p>
+ <xsl:apply-templates />
+ </body>
+ </html>
+</xsl:template>
+
+<xsl:template match="p">
+ <p>
+ <xsl:apply-templates/>
+ </p>
+</xsl:template>
+
+<xsl:template match="cmd">
+ <p class="cmd">
+ <xsl:apply-templates/>
+ </p>
+</xsl:template>
+
+<xsl:template match="arg">
+ <span class="arg"><xsl:apply-templates/></span>
+</xsl:template>
+
+<xsl:template match="opt">
+ <span class="opt"><xsl:apply-templates/></span>
+</xsl:template>
+
+<xsl:template match="file">
+ <span class="file"><xsl:apply-templates/></span>
+</xsl:template>
+
+<xsl:template match="optdesc">
+ <div class="optdesc">
+ <xsl:apply-templates/>
+ </div>
+</xsl:template>
+
+<xsl:template match="synopsis">
+ <h1>Synopsis</h1>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="seealso">
+ <h1>Synopsis</h1>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="description">
+ <h1>Description</h1>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="options">
+ <h1>Options</h1>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="section">
+ <h1><xsl:value-of select="@name"/></h1>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="option">
+ <div class="option"><xsl:apply-templates/></div>
+</xsl:template>
+
+<xsl:template match="manref">
+ <xsl:choose>
+ <xsl:when test="string-length(@href) &gt; 0">
+ <a class="manref"><xsl:attribute name="href"><xsl:value-of select="@href"/></xsl:attribute><xsl:value-of select="@name"/>(<xsl:value-of select="@section"/>)</a>
+ </xsl:when>
+ <xsl:otherwise>
+ <span class="manref"><xsl:value-of select="@name"/>(<xsl:value-of select="@section"/>)</span>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+<xsl:template match="url">
+ <a class="url"><xsl:attribute name="href"><xsl:value-of select="@href"/></xsl:attribute><xsl:value-of select="@href"/></a>
+</xsl:template>
+
+</xsl:stylesheet>