1 <?xml version="1.0"?><!--*-nxml-*-->
2 <!DOCTYPE manpage SYSTEM "xmltoman.dtd">
3 <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
8 This file is part of avahi.
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.
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.
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
26 <manpage name="avahi-daemon" section="8" desc="The Avahi mDNS/DNS-SD daemon">
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>
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>
50 <p>Upon startup avahi-daemon interpretes its configuration file
51 @pkgsysconfdir@/avahi-daemon.conf and reads XML fragments from
52 @servicedir@/*.service which may define static DNS-SD
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>
64 <p><opt>-D | --daemonize</opt></p>
65 <optdesc><p>Daemonize avahi-daemon after startup and redirect log messages to syslog.</p></optdesc>
69 <p><opt>-k | --kill</opt></p>
70 <optdesc><p>Kill an already running avahi-daemon. (equivalent to sending a SIGTERM)</p></optdesc>
74 <p><opt>-r | --reload</opt></p>
75 <optdesc><p>Tell an already running avahi-daemon to reread the files from @servicedir@/. (equivalent to sending a SIGHUP)</p></optdesc>
79 <p><opt>-c | --check</opt></p>
80 <optdesc><p>Return 0 as return code when avahi-daemon is already running.</p></optdesc>
84 <p><opt>-h | --help</opt></p>
85 <optdesc><p>Show help</p></optdesc>
89 <p><opt>-v | --version</opt></p>
90 <optdesc><p>Show version information </p></optdesc>
96 <section name="Files">
98 <p><file>@pkgsysconfdir@/avahi-daemon.conf</file>: the default configuration file for avahi-daemon.</p>
100 <p><file>@servicedir@/*.service</file>: static service definitions.</p>
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 @servicedir@/.</p>
107 <p><arg>SIGUSR1</arg>: avahi-daemon will dump local and remote cached resource record data to syslog.</p>
110 <section name="Authors">
111 <p>The avahi developers <@PACKAGE_BUGREPORT@>; avahi is
112 available from <url href="@PACKAGE_URL@"/></p>
115 <section name="See also">
117 <manref name="avahi-dnsconfd" section="8"/>, <manref name="avahi-daemon.conf" section="5"/>
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>