unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

avahi-daemon.conf(5)          File Formats Manual         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  sethost-
       name() 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 pro-
       vides 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 associ-
       ated 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  recon-
       nect.  (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 effec-
       tively 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 differ-
       ent 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  recom-
       mended  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 spec-
       ified  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 use-
       ful 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 use-
       ful 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 some-
       what 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 concur-
       rently.

       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)