Provided by: avahi-daemon_0.6.22-2ubuntu4_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  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".

       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 no 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!

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