summaryrefslogtreecommitdiffstats
path: root/man/avahi-daemon.conf.5.xml.in
blob: 89aa38e51971cf47b3b2e698af27641e95cd144f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
<?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-daemon.conf" section="5" desc="avahi-daemon configuration file">

	<synopsis>
      <cmd>@pkgsysconfdir@/avahi-daemon.conf</cmd>
	</synopsis>
	
    <description>
      <p><file>avahi-daemon.conf</file> is the configuration file for avahi-daemon.</p>
	</description>
	
	<section name="Section [Server]">

      <option>
        <p><opt>host-name=</opt> Set the host name avahi-daemon tries
        to register on the LAN. If omited defaults to the system host
        name as set with the sethostname() system call.</p>
      </option>

      <option>
        <p><opt>domain-name=</opt> Set the domain name avahi-domain
        tries to register its host name and services on the LAN in. If
        omited defaults to ".local".</p>
      </option>

      <option>
        <p><opt>use-ipv4=</opt> Takes a boolean value ("yes" or
        "no"). If set to "no" avahi-daemon will not use IPv4
        sockets. Default is "yes".</p>
      </option>

      <option>
        <p><opt>use-ipv6=</opt> Takes a boolean value ("yes" or
        "no"). If set to "no" avahi-daemon will not use IPv6
        sockets. Default is "yes".</p>
      </option>

      <option>
        <p><opt>check-response-ttl=</opt> Takes a boolean value ("yes"
        or "no"). If set to "yes", an additional security check is
        activated: incoming IP packets will be ignored unless the IP
        TTL is 255. Earlier mDNS specifications required this
        check. Since this feature may be incompatible with newer
        implementations of mDNS it defaults to "no". On the other hand
        it provides extra security.</p>
      </option>

      <option>
        <p><opt>use-iff-running=</opt> Takes a boolean value ("yes" or
        "no"). If set to "yes" avahi-daemon monitors the IFF_RUNNING
        flag bit which is used by some (modern) network drivers to
        tell user space if a network cable is plugged in (in case of
        copper ethernet), or the network card is associated with some
        kind of network (in case of WLAN). If IFF_RUNNING is set
        avahi-daemon will automatically announce its services on that
        network. Unfortunately far too many network drivers do not
        support this flag or support it in a broken way. Therefore
        this option defaults to "no".</p>
      </option>

      <option>
        <p><opt>enable-dbus=</opt> Takes either "yes", "no" or
        "warn". If set to "yes" avahi-daemon connects to D-BUS,
        offering an object oriented client API. It is only available
        if avahi has been compiled with <opt>--enable-dbus</opt> in
        which case it defaults to "yes". "warn" behaves like "yes",
        but the daemon starts up even when it fails to connect to a
        D-BUS daemon.</p>
      </option>

      <option>
        <p><opt>add-service-cookie=</opt> Takes a boolean value ("yes"
        or "no"). If set to "yes" an implicit TXT entry will be added
        to all locally registered services, containing a cookie value
        which is chosen randomly on daemon startup. This can be used
        to detect if two services on two different
        interfaces/protocols are actually identical. Defaults to
        "yes".</p>
      </option>


	</section>

	<section name="Section [publish]">
      <option>
        <p><opt>publish-addresses=</opt> Takes a boolean value ("yes"
        or "no"). If set to "yes" avahi-daemon will register mDNS
        address records for all local IP addresses. Unless you want to
        use avahi-daemon exclusively for browsing it's recommended to
        enable this. If you plan to register local services you need
        to enable this option. Defaults to "yes".</p>
      </option>

      <option>
        <p><opt>publish-hinfo=</opt> Takes a boolean value ("yes" or
        "no"). If set to "yes" avahi-daemon will register an mDNS
        HINFO record on all interfaces which contains information
        about the local operating system and CPU, which might be
        useful for administrative purposes. This is recommended by the
        mDNS specification but not required. For the sake of privacy
        you might choose to disable this feature. Defaults to
        "yes."</p>
      </option>

      <option>
        <p><opt>publish-workstation=</opt> Takes a boolean value
        ("yes" or "no"). If set to "yes" avahi-daemon will register a
        service of type "_workstation._tcp" on the local LAN. This
        might be useful for administrative purposes (i.e. browse for
        all PCs on the LAN), but is not required or recommended by any
        specification. Newer MacOS X releases register a service of
        this type. Defaults to "yes".</p>
      </option>

      <option>
        <p><opt>publish-domain=</opt> Takes a boolean value ("yes" or
        "no"). If set to "yes" avahi-daemon will announce the locally
        used domain name (see above) for browsing by other
        hosts. Defaults to "yes".</p>
      </option>

      <option>
        <p><opt>publish-dns-servers=</opt> Takes a comma seperated
        list of IP addresses for unicast DNS servers. You can use this
        to announce unicast DNS servers via mDNS. When used in
        conjunction with avahi-dnsconfd on the client
        side this allows DHCP-like configuration of unicast DNS
        servers.</p>
      </option>

      <option>
        <p><opt>publish-resolv-conf-dns-servers=</opt> Takes a boolean
        value ("yes" or "no"). If set to "yes" avahi-daemon will
        publish the unicast DNS servers specified in
        <file>/etc/resolv.conf</file> in addition to those specified
        with <opt>publish-dns-servers</opt>. Send avahi-daemon a
        SIGHUP to have it reload this file. Defaults to "no".</p>
      </option>

    </section>

	<section name="Section [reflector]">
      <option>
        <p><opt>enable-reflector=</opt> Takes a boolean value ("yes"
        or "no"). If set to "yes" avahi-daemon will reflect incoming
        mDNS requests to all local network interfaces, effectively
        allowing clients to browse mDNS/DNS-SD services on all
        networks connected to the gateway. The gateway is somewhat
        intelligent and should work with all kinds of mDNS traffic,
        though some functionality is lost (specifically the unicast
        reply bit, which is used rarely anyway). Make sure to not run
        multiple reflectors between the same networks, this might
        cause them to play Ping Pong with mDNS packets. Defaults to
        "no".</p>
      </option>

      <option>
        <p><opt>reflect-ipv=</opt> Takes a boolean value ("yes" or
        "no"). If set to "yes" and <opt>enable-reflector</opt> is
        enabled, avahi-daemon will forward mDNS traffic between IPv4
        and IPv6, which is usually not recommended. Defaults to "no".</p>
      </option>
    </section>

    <section name="Section [rlimits]">
      <p>This section is used to define system resource limits for the
      daemon. See <manref section="2" name="setrlimit"/> for more
      information. If any of the options is not specified in the configuration
      file, avahi-daemon does not change it from the system
      defaults.</p>


      <option>
        <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>
      </option>

      <option>
        <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>
      </option>

      <option>
        <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>
      </option>

      <option>
        <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>
      </option>

      <option>
        <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>
      </option>

      <option>
        <p><opt>rlimit-stack=</opt> Value in bytes for RLIMIT_STACK (maximum size of the process stack). Sensible values are heavily system dependent.</p>
      </option>

      <option>
        <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>
      </option>

    </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="avahi-dnsconfd" 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>