git.meshlink.io Git - catta/blob - man/avahi-daemon.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 <!-- $Id$ -->
   6
   7 <!--
   8   This file is part of avahi.
   9
  10   avahi is free software; you can redistribute it and/or modify it
  11   under the terms of the GNU Lesser General Public License as
  12   published by the Free Software Foundation; either version 2.1 of the
  13   License, or (at your option) any later version.
  14
  15   avahi is distributed in the hope that it will be useful, but WITHOUT
  16   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  17   or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
  18   Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public
  21   License along with avahi; if not, write to the Free Software
  22   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  23   USA.
  24 -->
  25
  26   <manpage name="avahi-daemon" section="8" desc="The Avahi mDNS/DNS-SD daemon">
  27
  28         <synopsis>
  29       <cmd>avahi-daemon [<arg>options</arg>]</cmd>
  30       <cmd>avahi-daemon <opt>--kill</opt></cmd>
  31       <cmd>avahi-daemon <opt>--reload</opt></cmd>
  32       <cmd>avahi-daemon <opt>--check</opt></cmd>
  33       <cmd>avahi-daemon <opt>--version</opt></cmd>
  34       <cmd>avahi-daemon <opt>--help</opt></cmd>
  35         </synopsis>
  36
  37     <description>
  38       <p>The Avahi mDNS/DNS-SD daemon implementing Apple's ZeroConf
  39       architecture (also known as "Rendezvous" or "Bonjour"). The daemon
  40       registers local IP addresses and static services using
  41       mDNS/DNS-SD and provides two IPC APIs for local programs to make
  42       use of the mDNS record cache the avahi-daemon maintains. First
  43       there is the so called "simple protocol" which is used
  44       exclusively by avahi-dnsconfd (a daemon which configures unicast
  45       DNS servers using server info published via mDNS) and nss-mdns
  46       (a libc NSS plugin, providing name resolution via mDNS). Finally
  47       there is the DBUS interface which provides a rich object
  48       oriented interface to DBUS enabled applications.</p>
  49
  50       <p>Upon startup avahi-daemon interprets its configuration file
  51       <file>@pkgsysconfdir@/avahi-daemon.conf</file> and reads XML fragments from
  52       <file>@servicedir@/*.service</file> which may define static DNS-SD
  53       services.</p>
  54         </description>
  55
  56         <options>
  57
  58           <option>
  59                 <p><opt>-f | --file=</opt> <arg>FILE</arg></p>
  60                 <optdesc><p>Specify the configuration file to read. (default: @pkgsysconfdir@/avahi-daemon.conf)</p></optdesc>
  61           </option>
  62
  63           <option>
  64                 <p><opt>-D | --daemonize</opt></p>
  65                 <optdesc><p>Daemonize after startup and redirect log messages to syslog.</p></optdesc>
  66           </option>
  67
  68           <option>
  69                 <p><opt>-k | --kill</opt></p>
  70                 <optdesc><p>Kill an already running avahi-daemon. (equivalent to sending a SIGTERM)</p></optdesc>
  71           </option>
  72
  73           <option>
  74                 <p><opt>-r | --reload</opt></p>
  75                 <optdesc><p>Tell an already running avahi-daemon to reread the files from <file>@servicedir@/</file>. Please note that this will not reload the <file>@pkgsysconfdir@/avahi-daemon.conf</file>(equivalent to sending a SIGHUP)</p></optdesc>
  76           </option>
  77
  78           <option>
  79                 <p><opt>-c | --check</opt></p>
  80                 <optdesc><p>Return 0 as return code when avahi-daemon is already running.</p></optdesc>
  81           </option>
  82
  83           <option>
  84                 <p><opt>-h | --help</opt></p>
  85                 <optdesc><p>Show help</p></optdesc>
  86           </option>
  87
  88           <option>
  89                 <p><opt>-v | --version</opt></p>
  90                 <optdesc><p>Show version information </p></optdesc>
  91           </option>
  92
  93         </options>
  94
  95
  96     <section name="Files">
  97
  98       <p><file>@pkgsysconfdir@/avahi-daemon.conf</file>: the default configuration file for avahi-daemon.</p>
  99
 100       <p><file>@servicedir@/*.service</file>: static service definitions.</p>
 101
 102     </section>
 103
 104     <section name="Signals">
 105       <p><arg>SIGINT, SIGTERM, SIGQUIT</arg>: avahi-daemon will shutdown. This is issued by passing --kill to avahi-daemon.</p>
 106       <p><arg>SIGHUP</arg>: avahi-daemon will reload the static service definitions from <file>@servicedir@/</file>.</p>
 107       <p><arg>SIGUSR1</arg>: avahi-daemon will dump local and remote cached resource record data to syslog.</p>
 108     </section>
 109
 110         <section name="Authors">
 111           <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
 112           available from <url href="@PACKAGE_URL@"/></p>
 113         </section>
 114
 115         <section name="See also">
 116           <p>
 117         <manref name="avahi-dnsconfd" section="8"/>, <manref name="avahi-daemon.conf" section="5"/>
 118           </p>
 119         </section>
 120
 121         <section name="Comments">
 122           <p>This man page was written using <manref name="xml2man" section="1"
 123                   href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
 124         </section>
 125
 126   </manpage>