Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
avahi-daemon.conf(5)	      File Formats Manual	  avahi-daemon.conf(5)

NAME
       avahi-daemon.conf - avahi-daemon	configuration file

SYNOPSIS
       /usr/local/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.

       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 ".lo-
       cal".

       browse-domains= Set a comma separated list of browsing domains (in  ad-
       dition to the default one and those announced inside the	default	brows-
       ing 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	inter-
       faces that should be used by the	avahi-daemon. Traffic on other	inter-
       faces will be ignored. If set to	an empty list all local	interfaces ex-
       cept 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 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 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  re-
       source  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  concur-
       rent  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-inter-
       face  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 do-
       mains 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	recom-
       mended  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 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 lo-
       cal 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 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 be-
       tween 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 be-
       tween  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 (max number of processes	a user
       can launch). avahi-daemon forks of a helper process  on	systems	 where
       chroot(2)  is available therefore this value should not be set below 2.
       Note that while the process limit only applies to this process, the to-
       tal  count  of  processes to reach that limit includes all processes on
       the system with the same	UID,  including	 any  containers  without  UID
       remapping  (such	 as lxd	containers with	security.privileged=true). The
       default configuration of	3 was removed to prevent problems in this sce-
       nario.

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)

NAME | SYNOPSIS | DESCRIPTION | SECTION [SERVER] | SECTION [WIDE-AREA] | SECTION [PUBLISH] | SECTION [REFLECTOR] | SECTION [RLIMITS] | AUTHORS | SEE ALSO | COMMENTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=avahi-daemon.conf&sektion=5&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help