Provided by: avahi-daemon_0.6.30-5ubuntu2_i386 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.