add dnsconfd man page

git-svn-id: file:///home/lennart/svn/public/avahi/trunk@259 941a03a8-eaeb-0310-b9a0-b1bbd8fe43fe

1 files changed, 107 insertions, 0 deletions

diff --git a/man/avahi-dnsconfd.8.xml.in b/man/avahi-dnsconfd.8.xml.in
new file mode 100644
index 0000000..bd99f47
--- /dev/null
+++ b/man/avahi-dnsconfd.8.xml.in
@@ -0,0 +1,107 @@
+<?xml version="1.0"?><!--*-nxml-*-->
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
+
+<!-- $Id$ -->
+
+<!-- 
+  This file is part of avahi.
+ 
+  avahi is free software; you can redistribute it and/or modify it
+  under the terms of the GNU Lesser General Public License as
+  published by the Free Software Foundation; either version 2.1 of the
+  License, or (at your option) any later version.
+ 
+  avahi 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 Lesser General
+  Public License for more details.
+ 
+  You should have received a copy of the GNU Lesser General Public
+  License along with avahi; if not, write to the Free Software
+  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+  USA.
+-->
+
+  <manpage name="avahi-dnsconfd" section="8" desc="Unicast DNS server from mDNS/DNS-SD configuration daemon">
+
+	<synopsis>
+      <cmd>avahi-dnsconfd [<arg>options</arg>]</cmd>
+      <cmd>avahi-dnsconfd <opt>--kill</opt></cmd>
+      <cmd>avahi-dnsconfd <opt>--refresh</opt></cmd>
+      <cmd>avahi-dnsconfd <opt>--check</opt></cmd>
+      <cmd>avahi-dnsconfd <opt>--version</opt></cmd>
+      <cmd>avahi-dnsconfd<opt>--help</opt></cmd>
+	</synopsis>
+	
+    <description>
+      <p>avahi-dnsconfd connects to a running avahi-daemon and runs
+      the script <file>@pkgsysconfdir@/dnsconf.action</file> for each unicast DNS
+      server that is announced on the local LAN. This is useful for
+      configuring unicast DNS servers in a DHCP-like fashion with
+      mDNS.</p>
+	</description>
+	
+	<options>
+
+	  <option>
+		<p><opt>-D | --daemonize</opt></p>
+		<optdesc><p>Daemonize after startup and redirect log messages to syslog.</p></optdesc>
+	  </option>
+
+	  <option>
+		<p><opt>-k | --kill</opt></p>
+		<optdesc><p>Kill an already running avahi-dnsconfd. (equivalent to sending a SIGTERM)</p></optdesc>
+	  </option>
+
+	  <option>
+		<p><opt>-r | --refresh</opt></p>
+		<optdesc><p>Tell an already running avahi-dnsconfd to refresh the DNS server data. (equivalent to sending a SIGHUP)</p></optdesc>
+	  </option>
+
+	  <option>
+		<p><opt>-c | --check</opt></p>
+		<optdesc><p>Return 0 as return code when avahi-dnsconfd is already running.</p></optdesc>
+	  </option>
+
+	  <option>
+		<p><opt>-h | --help</opt></p>
+		<optdesc><p>Show help</p></optdesc>
+	  </option>
+
+	  <option>
+		<p><opt>-v | --version</opt></p>
+		<optdesc><p>Show version information </p></optdesc>
+	  </option>
+
+	</options>
+
+
+    <section name="Files">
+      
+      <p><file>@pkgsysconfdir@/dnsconf.action</file>: the script to run when a DNS server is found or removed.</p>
+    
+    </section>
+
+    <section name="Signals">
+      <p><arg>SIGINT, SIGTERM, SIGQUIT</arg>: avahi-dnsconfd will shutdown. This is issued by passing --kill to avahi-daemon.</p>
+      <p><arg>SIGHUP</arg>: avahi-dnsconfd will refresh the DNS server data.</p>
+    </section>
+
+	<section name="Authors">
+	  <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+	  available from <url href="@PACKAGE_URL@"/></p>
+	</section>
+	
+	<section name="See also">
+	  <p>
+        <manref name="avahi-daemon" section="8"/>, <manref name="dnsconf.action" 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>