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.

   host-name-from-machine-id=  Takes  a  boolean value ("yes" or "no"). If
   set to "yes" avahi-daemon will use the machine-id as name on the LAN.

   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 "no".

   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 "no".

   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.





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.