Man Pages

avahi-daemon.conf(5) - phpMan avahi-daemon.conf(5) - phpMan

Command: man perldoc info search(apropos)  


avahi-daemon.conf(5)                                      avahi-daemon.conf(5)



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  seperated  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 seperated domains or by
       adding them to the XDG config file ~/.config/avahi/browse-domains (seperated 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 seperated list of allowed network interfaces that should be used by the avahi-
       daemon. Other interfaces will be ignored. If set to the empty list all local  interfaces  except  loopback  and
       point-to-point will be used.

       deny-interfaces= Set a comma seperated 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  deny-
       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 secu-
       rity 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 Inter-
       net 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 client at a time. If the maximum number is reached  further  object  cre-
       ation 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 at a time. If the maximum number is reached further resource records may not be added to  an  entry
       group.

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 pub-
       lish address records and suchlike but will not allow user applications to publish services. Use this is a secu-
       rity 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 ser-
       vice 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 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.

       publish-resolv-conf-dns-servers=  Takes a boolean value ("yes" or "no"). If set to "yes" avahi-daemon will pub-
       lish 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  any-
       way).  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-dae-
       mon 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.



Manuals                              User                 avahi-daemon.conf(5)