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.conf" section="5" desc="avahi-daemon configuration file">
29 <cmd>@pkgsysconfdir@/avahi-daemon.conf</cmd>
33 <p><file>avahi-daemon.conf</file> is the configuration file for avahi-daemon.</p>
36 <section name="Section [Server]">
39 <p><opt>host-name=</opt> Set the host name avahi-daemon tries
40 to register on the LAN. If omited defaults to the system host
41 name as set with the sethostname() system call.</p>
45 <p><opt>domain-name=</opt> Set the default domain name avahi-daemon
46 tries to register its host name and services on the LAN in. If
47 omitted defaults to ".local".</p>
51 <p><opt>browse-domains=</opt> Set a comma seperated list of
52 browsing domains (in addition to the default one and those
53 announced inside the default browsing domain). Please note
54 that the user may specify additional browsing domains on the
55 client side, either by setting $AVAHI_BROWSE_DOMAINS to a list
56 of colon seperated domains or by adding them to the XDG config
57 file <file>~/.config/avahi/browse-domains</file> (seperated by
63 <p><opt>use-ipv4=</opt> Takes a boolean value ("yes" or
64 "no"). If set to "no" avahi-daemon will not use IPv4
65 sockets. Default is "yes".</p>
69 <p><opt>use-ipv6=</opt> Takes a boolean value ("yes" or
70 "no"). If set to "no" avahi-daemon will not use IPv6
71 sockets. Default is "yes".</p>
75 <p><opt>check-response-ttl=</opt> Takes a boolean value ("yes"
76 or "no"). If set to "yes", an additional security check is
77 activated: incoming IP packets will be ignored unless the IP
78 TTL is 255. Earlier mDNS specifications required this
79 check. Since this feature may be incompatible with newer
80 implementations of mDNS it defaults to "no". On the other hand
81 it provides extra security.</p>
85 <p><opt>use-iff-running=</opt> Takes a boolean value ("yes" or
86 "no"). If set to "yes" avahi-daemon monitors the IFF_RUNNING
87 flag bit which is used by some (modern) network drivers to
88 tell user space if a network cable is plugged in (in case of
89 copper ethernet), or the network card is associated with some
90 kind of network (in case of WLAN). If IFF_RUNNING is set
91 avahi-daemon will automatically announce its services on that
92 network. Unfortunately far too many network drivers do not
93 support this flag or support it in a broken way. Therefore
94 this option defaults to "no".</p>
98 <p><opt>enable-dbus=</opt> Takes either "yes", "no" or
99 "warn". If set to "yes" avahi-daemon connects to D-BUS,
100 offering an object oriented client API. It is only available
101 if avahi has been compiled with <opt>--enable-dbus</opt> in
102 which case it defaults to "yes". "warn" behaves like "yes",
103 but the daemon starts up even when it fails to connect to a
108 <p><opt>disallow-other-stacks=</opt> Takes a boolean value
109 ("yes" or "no"). If set to "yes", no other process is allowed
110 to bind to UDP port 5353. This effectively impedes other mDNS
111 stacks from running on the host. Use this as a security
112 measure to make sure that only Avahi is responsible for mDNS
113 traffic. Please note that we do no recommend running multiple
114 mDNS stacks on the same host simultaneously. This hampers
115 reliability and is a waste of resources. However, to not annoy
116 people this option defaults to "no".</p>
120 <p><opt>allow-point-to-point=</opt> Takes a boolean value
121 ("yes" or "no"). If set to "yes", avahi-daemon will accept
122 interfaces with the POINTOPOINT flag. This option defaults
123 to "no" as it may be unreliable.</p>
128 <section name="Section [wide-area]">
130 <p><opt>enable-wide-area=</opt> Enable wide-area DNS-SD, aka
131 DNS-SD over unicast DNS. If this is enabled only domains
132 ending in .local will be resolved on mDNS, all other domains
133 are resolved via unicast DNS. If you want to maintain multiple
134 different multicast DNS domains even with this option enabled
135 we encourage you to use subdomains of .local, such as
136 "kitchen.local". This option defaults to "yes".</p>
141 <section name="Section [publish]">
143 <option><p><opt>disable-publishing=</opt> Takes a boolean value
144 ("yes" or "no"). If set to "yes", no record will be published by
145 Avahi, not even address records for the local host. Avahi will
146 be started in a querying-only mode. Use this is a security
147 measure. This option defaults to "no"</p></option>
149 <option><p><opt>disable-user-service-publishing=</opt> Takes a boolean value
150 ("yes" or "no"). If set to "yes", Avahi will still publish
151 address records and suchlike but will not allow user
152 applications to publish services. Use this is a security
153 measure. This option defaults to "no"</p></option>
156 <p><opt>add-service-cookie=</opt> Takes a boolean value ("yes"
157 or "no"). If set to "yes" an implicit TXT entry will be added
158 to all locally registered services, containing a cookie value
159 which is chosen randomly on daemon startup. This can be used
160 to detect if two services on two different
161 interfaces/protocols are actually identical. Defaults to
166 <p><opt>publish-addresses=</opt> Takes a boolean value ("yes"
167 or "no"). If set to "yes" avahi-daemon will register mDNS
168 address records for all local IP addresses. Unless you want to
169 use avahi-daemon exclusively for browsing it's recommended to
170 enable this. If you plan to register local services you need
171 to enable this option. Defaults to "yes".</p>
175 <p><opt>publish-hinfo=</opt> Takes a boolean value ("yes" or
176 "no"). If set to "yes" avahi-daemon will register an mDNS
177 HINFO record on all interfaces which contains information
178 about the local operating system and CPU, which might be
179 useful for administrative purposes. This is recommended by the
180 mDNS specification but not required. For the sake of privacy
181 you might choose to disable this feature. Defaults to
186 <p><opt>publish-workstation=</opt> Takes a boolean value
187 ("yes" or "no"). If set to "yes" avahi-daemon will register a
188 service of type "_workstation._tcp" on the local LAN. This
189 might be useful for administrative purposes (i.e. browse for
190 all PCs on the LAN), but is not required or recommended by any
191 specification. Newer MacOS X releases register a service of
192 this type. Defaults to "yes".</p>
196 <p><opt>publish-domain=</opt> Takes a boolean value ("yes" or
197 "no"). If set to "yes" avahi-daemon will announce the locally
198 used domain name (see above) for browsing by other
199 hosts. Defaults to "yes".</p>
203 <p><opt>publish-dns-servers=</opt> Takes a comma seperated
204 list of IP addresses for unicast DNS servers. You can use this
205 to announce unicast DNS servers via mDNS. When used in
206 conjunction with avahi-dnsconfd on the client
207 side this allows DHCP-like configuration of unicast DNS
212 <p><opt>publish-resolv-conf-dns-servers=</opt> Takes a boolean
213 value ("yes" or "no"). If set to "yes" avahi-daemon will
214 publish the unicast DNS servers specified in
215 <file>/etc/resolv.conf</file> in addition to those specified
216 with <opt>publish-dns-servers</opt>. Send avahi-daemon a
217 SIGHUP to have it reload this file. Defaults to "no".</p>
222 <section name="Section [reflector]">
224 <p><opt>enable-reflector=</opt> Takes a boolean value ("yes"
225 or "no"). If set to "yes" avahi-daemon will reflect incoming
226 mDNS requests to all local network interfaces, effectively
227 allowing clients to browse mDNS/DNS-SD services on all
228 networks connected to the gateway. The gateway is somewhat
229 intelligent and should work with all kinds of mDNS traffic,
230 though some functionality is lost (specifically the unicast
231 reply bit, which is used rarely anyway). Make sure to not run
232 multiple reflectors between the same networks, this might
233 cause them to play Ping Pong with mDNS packets. Defaults to
238 <p><opt>reflect-ipv=</opt> Takes a boolean value ("yes" or
239 "no"). If set to "yes" and <opt>enable-reflector</opt> is
240 enabled, avahi-daemon will forward mDNS traffic between IPv4
241 and IPv6, which is usually not recommended. Defaults to "no".</p>
245 <section name="Section [rlimits]">
246 <p>This section is used to define system resource limits for the
247 daemon. See <manref section="2" name="setrlimit"/> for more
248 information. If any of the options is not specified in the configuration
249 file, avahi-daemon does not change it from the system
254 <p><opt>rlimit-as=</opt> Value in bytes for RLIMIT_AS (maximum size of the process's virtual memory). Sensible values are heavily system dependent.</p>
258 <p><opt>rlimit-core=</opt> Value in bytes for RLIMIT_CORE (maximum core file size). Unless you want to debug avahi-daemon, it is safe to set this to 0.</p>
262 <p><opt>rlimit-data=</opt> Value in bytes for RLIMIT_DATA (maximum size of the process's data segment). Sensible values are heavily system dependent.</p>
266 <p><opt>rlimit-fsize=</opt> Value for RLIMIT_FSIZE (maximum size of files the process may create). Since avahi-daemon shouldn't write any files to disk, it is safe to set this to 0.</p>
270 <p><opt>rlimit-nofile=</opt> Value for RLIMIT_NOFILE (open file descriptors). avahi-daemon shouldn't need more than 15 to 20 open file descriptors concurrently.</p>
274 <p><opt>rlimit-stack=</opt> Value in bytes for RLIMIT_STACK (maximum size of the process stack). Sensible values are heavily system dependent.</p>
278 <p><opt>rlimit-nproc=</opt> Value for RLIMIT_NPROC (number of process of user). Since only a single avahi-daemon process is usually running you can set this safely to 1.</p>
283 <section name="Authors">
284 <p>The avahi developers <@PACKAGE_BUGREPORT@>; avahi is
285 available from <url href="@PACKAGE_URL@"/></p>
288 <section name="See also">
290 <manref name="avahi-daemon" section="8"/>, <manref name="avahi-dnsconfd" section="8"/>
294 <section name="Comments">
295 <p>This man page was written using <manref name="xml2man" section="1"
296 href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>