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
       /home/lennart/tmp/avahi/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.

       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 "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 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	/usr/local/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  (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)

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.0-RELEASE+and+Ports>

home | help