Provided by: avahi-daemon_0.6.30-5ubuntu2_amd64 bug

NAME

       avahi-daemon.conf - avahi-daemon configuration file

SYNOPSIS

       /etc/avahi/avahi-daemon.conf

DESCRIPTION

       avahi-daemon.conf is the configuration file for avahi-daemon.

SECTION [SERVER]

       host-name= 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.

       domain-name= Set the default domain name avahi-daemon tries to register its host name  and
       services on the LAN in. If omitted defaults to ".local".

       browse-domains= Set a comma separated list of browsing domains (in addition to the default
       one and those announced inside the default browsing domain). Please note that the user may
       specify   additional   browsing   domains   on   the   client   side,  either  by  setting
       $AVAHI_BROWSE_DOMAINS to a list of colon separated domains or by adding them  to  the  XDG
       config file ~/.config/avahi/browse-domains (separated by newlines).

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

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

       allow-interfaces=  Set a comma separated list of allowed network interfaces that should be
       used by the avahi-daemon. Traffic on other interfaces will be ignored. If set to an  empty
       list all local interfaces except loopback and point-to-point will be used.

       deny-interfaces=  Set  a comma separated list of network interfaces that should be ignored
       by avahi-daemon. Other not specified interfaces will be used, unless allow-interfaces=  is
       set. This option takes precedence over allow-interfaces=.

       check-response-ttl=  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.

       use-iff-running=  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".

       enable-dbus=  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 --enable-dbus 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. In addition,  if
       the  connection to the D-Bus daemon is terminated we try to reconnect. (Unless we are in a
       chroot() environment where this definitely will fail.)

       disallow-other-stacks= Takes a boolean value ("yes" or "no"). If set  to  "yes"  no  other
       process  is  allowed  to bind to UDP port 5353. This effectively impedes other mDNS stacks
       from running on the host. Use this as a security measure to make sure that only  Avahi  is
       responsible  for  mDNS traffic. Please note that we do not recommend running multiple mDNS
       stacks on the same host simultaneously.  This  hampers  reliability  and  is  a  waste  of
       resources. However, to not annoy people this option defaults to "no".

       allow-point-to-point=  Takes a boolean value ("yes" or "no"). If set to "yes" avahi-daemon
       will make use of interfaces with the POINTOPOINT flag set. This option defaults to "no" as
       it  might  make mDNS unreliable due to usually large latencies with such links and opens a
       potential security hole by allowing mDNS access from Internet connections. Use  with  care
       and YMMV!

       cache-entries-max=  Takes  an  unsigned  integer  specifying how many resource records are
       cached per interface. Bigger values allow mDNS work  correctly  in  large  LANs  but  also
       increase memory consumption.

       clients-max=  Takes  an  unsigned  integer. The maximum number of concurrent D-Bus clients
       allowed. If the maximum number is reached further clients will be refused until  at  least
       one existing client disconnects.

       objects-per-client-max=  Takes  an  unsigned integer. The maximum number of objects (entry
       groups, browsers, resolvers) that may be registered per D-Bus client at  a  time.  If  the
       maximum  number  is  reached  further  object  creation will be refused until at least one
       object is freed.

       entries-per-entry-group-max= Takes an unsigned integer.  The  maximum  number  of  entries
       (resource  records) per entry group registered by a D-Bus client at a time. If the maximum
       number is reached further resource records may not be added to an entry group.

       ratelimit-interval-usec= Takes an unsigned integer. Sets the  per-interface  packet  rate-
       limiting  interval  parameter.  Together with ratelimit-burst= this may be used to control
       the maximum number of packets Avahi will generated in a specific  period  of  time  on  an
       interface.

       ratelimit-burst=  Takes  an  unsigned integer. Sets the per-interface packet rate-limiting
       burst parameter. Together with ratelimit-interval-usec= this may be used  to  control  the
       maximum  number  of  packets  Avahi  will  generated  in  a  specific period of time on an
       interface.

SECTION [WIDE-AREA]

       enable-wide-area= Takes a boolean value ("yes" or "no"). Enable wide-area DNS-SD, aka DNS-
       SD  over unicast DNS. If this is enabled only domains ending in .local will be resolved on
       mDNS, all other domains are resolved via unicast DNS. If you  want  to  maintain  multiple
       different  multicast  DNS  domains  even  with this option enabled we encourage you to use
       subdomains of .local, such as "kitchen.local". This option defaults to "yes".

SECTION [PUBLISH]

       disable-publishing= Takes a boolean value ("yes" or "no"). If set to "yes", no record will
       be  published by Avahi, not even address records for the local host. Avahi will be started
       in a querying-only mode. Use this is a security measure. This option defaults to "no"

       disable-user-service-publishing= Takes a boolean value ("yes" or "no"). If set  to  "yes",
       Avahi will still publish address records and suchlike but will not allow user applications
       to publish services. Use this is a security measure. This option defaults to "no"

       add-service-cookie= 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 "no".

       publish-addresses=  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".

       publish-hinfo= 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."

       publish-workstation= 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".

       publish-domain= 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".

       publish-dns-servers= Takes a comma separated 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.

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

       publish-aaaa-on-ipv4= Takes a boolean value ("yes" or "no"). If set to "yes"  avahi-daemon
       will  publish  an IPv6 AAAA record via IPv4, i.e. the local IPv6 addresses can be resolved
       using an IPv4 transport. Only useful when IPv4 is enabled with use-ipv4=true. Defaults  to
       "yes".

       publish-a-on-ipv6=  Takes  a  boolean  value ("yes" or "no"). If set to "yes" avahi-daemon
       will publish an IPv4 A record via IPv6, i.e. the local  IPv4  addresses  can  be  resolved
       using  an IPv6 transport. Only useful when IPv6 is enabled with use-ipv6=true. Defaults to
       "no".

SECTION [REFLECTOR]

       enable-reflector= 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".

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

SECTION [RLIMITS]

       This section is used to define system resource limits for the daemon. See setrlimit(2) 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.

       rlimit-as= Value in bytes for RLIMIT_AS (maximum size of the  process's  virtual  memory).
       Sensible values are heavily system dependent.

       rlimit-core=  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.

       rlimit-data= Value in bytes for RLIMIT_DATA (maximum size of the process's data  segment).
       Sensible values are heavily system dependent.

       rlimit-fsize= 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.

       rlimit-nofile= Value for RLIMIT_NOFILE (open  file  descriptors).  avahi-daemon  shouldn't
       need more than 15 to 20 open file descriptors concurrently.

       rlimit-stack=  Value  in  bytes  for  RLIMIT_STACK  (maximum  size  of the process stack).
       Sensible values are heavily system dependent.

       rlimit-nproc= Value for RLIMIT_NPROC (number of process of user). avahi-daemon forks of  a
       helper process on systems where chroot(2) is available. Therefore this value should not be
       set below 2.

AUTHORS

       The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>;  Avahi  is  available
       from http://avahi.org/

SEE ALSO

       avahi-daemon(8), avahi-dnsconfd(8)

COMMENTS

       This man page was written using xml2man(1) by Oliver Kurth.