X-Git-Url: http://git.meshlink.io/?a=blobdiff_plain;f=man%2Favahi-daemon.conf.5.xml.in;h=7dff0974c1d957f919fd2045190a7b4ddc25fa75;hb=9541ceb22b5ecd525e16a318b95329a38240a7a4;hp=45fdf9f09b5ac5fc9e964d25c72c301f8b6eba5e;hpb=88a99a094e561b6c87404f4999e61e7b9ed754f6;p=catta
diff --git a/man/avahi-daemon.conf.5.xml.in b/man/avahi-daemon.conf.5.xml.in
index 45fdf9f..7dff097 100644
--- a/man/avahi-daemon.conf.5.xml.in
+++ b/man/avahi-daemon.conf.5.xml.in
@@ -42,9 +42,21 @@
- domain-name= Set the domain name avahi-domain
+
domain-name= Set the default domain name avahi-daemon
tries to register its host name and services on the LAN in. If
- omited defaults to ".local".
+ 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).
+
@@ -83,16 +95,79 @@
- enable-dbus= Takes a boolean value ("yes" or
- "no"). If set to "yes" avahi-daemon connects to DBUS, to offer
- an object oriented client API. Only available if avahi has
- been compiled with --enable-dbus in which case it
- defaults to "yes".
+ 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!
+
+
+ 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".
+
+
+
+
+
+ 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
+ "yes".
+
+
publish-addresses= Takes a boolean value ("yes"
or "no"). If set to "yes" avahi-daemon will register mDNS
@@ -173,6 +248,44 @@
+
+ This section is used to define system resource limits for the
+ daemon. See 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). Since only a single avahi-daemon process is usually running you can set this safely to 1.
+
+
+
+
The avahi developers <@PACKAGE_BUGREPORT@>; avahi is
available from