git.meshlink.io Git - catta/blob - man/avahi-dnsconfd.8.xml.in

   1 <?xml version="1.0"?><!--*-nxml-*-->
   2 <!DOCTYPE manpage SYSTEM "xmltoman.dtd">
   3 <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
   4
   5 <!--
   6   This file is part of avahi.
   7
   8   avahi is free software; you can redistribute it and/or modify it
   9   under the terms of the GNU Lesser General Public License as
  10   published by the Free Software Foundation; either version 2.1 of the
  11   License, or (at your option) any later version.
  12
  13   avahi is distributed in the hope that it will be useful, but WITHOUT
  14   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  15   or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
  16   Public License for more details.
  17
  18   You should have received a copy of the GNU Lesser General Public
  19   License along with avahi; if not, write to the Free Software
  20   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  21   USA.
  22 -->
  23
  24   <manpage name="avahi-dnsconfd" section="8" desc="Unicast DNS server from mDNS/DNS-SD configuration daemon">
  25
  26         <synopsis>
  27       <cmd>avahi-dnsconfd [<arg>options</arg>]</cmd>
  28       <cmd>avahi-dnsconfd <opt>--kill</opt></cmd>
  29       <cmd>avahi-dnsconfd <opt>--refresh</opt></cmd>
  30       <cmd>avahi-dnsconfd <opt>--check</opt></cmd>
  31         </synopsis>
  32
  33     <description>
  34       <p>avahi-dnsconfd connects to a running avahi-daemon and runs
  35       the script <file>@pkgsysconfdir@/dnsconfd.action</file> for each unicast DNS
  36       server that is announced on the local LAN. This is useful for
  37       configuring unicast DNS servers in a DHCP-like fashion with
  38       mDNS.</p>
  39         </description>
  40
  41         <options>
  42
  43           <option>
  44                 <p><opt>-D | --daemonize</opt></p>
  45                 <optdesc><p>Daemonize after startup and redirect log messages to syslog.</p></optdesc>
  46           </option>
  47
  48       <option>
  49         <p><opt>-s | --syslog</opt></p>
  50         <optdesc><p>Log to syslog instead of STDERR. Implied by <opt>--daemonize</opt>.</p></optdesc>
  51       </option>
  52
  53           <option>
  54                 <p><opt>-k | --kill</opt></p>
  55                 <optdesc><p>Kill an already running avahi-dnsconfd. (equivalent to sending a SIGTERM)</p></optdesc>
  56           </option>
  57
  58           <option>
  59                 <p><opt>-r | --refresh</opt></p>
  60                 <optdesc><p>Tell an already running avahi-dnsconfd to refresh the DNS server data. (equivalent to sending a SIGHUP)</p></optdesc>
  61           </option>
  62
  63           <option>
  64                 <p><opt>-c | --check</opt></p>
  65                 <optdesc><p>Return 0 as return code when avahi-dnsconfd is already running.</p></optdesc>
  66           </option>
  67
  68           <option>
  69                 <p><opt>-h | --help</opt></p>
  70                 <optdesc><p>Show help</p></optdesc>
  71           </option>
  72
  73           <option>
  74                 <p><opt>-v | --version</opt></p>
  75                 <optdesc><p>Show version information </p></optdesc>
  76           </option>
  77
  78         </options>
  79
  80     <section name="Files">
  81
  82       <p><file>@pkgsysconfdir@/avahi-dnsconfd.action</file>: the script to run when a DNS server is found or removed.</p>
  83
  84     </section>
  85
  86     <section name="Signals">
  87       <p><arg>SIGINT, SIGTERM, SIGQUIT</arg>: avahi-dnsconfd will shutdown. This is issued by passing --kill to avahi-daemon.</p>
  88       <p><arg>SIGHUP</arg>: avahi-dnsconfd will refresh the DNS server data.</p>
  89     </section>
  90
  91         <section name="Authors">
  92           <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
  93           available from <url href="@PACKAGE_URL@"/></p>
  94         </section>
  95
  96         <section name="See also">
  97           <p>
  98         <manref name="avahi-daemon" section="8"/>, <manref name="avahi-dnsconfd.action" section="8"/>
  99           </p>
 100         </section>
 101
 102         <section name="Comments">
 103           <p>This man page was written using <manref name="xml2man" section="1"
 104                   href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
 105         </section>
 106
 107   </manpage>