summaryrefslogtreecommitdiff
path: root/docs/ch11-services.rst
diff options
context:
space:
mode:
authorChristian Poessinger <christian@poessinger.com>2018-10-03 14:55:29 +0200
committerChristian Poessinger <christian@poessinger.com>2018-10-03 14:55:29 +0200
commit77d07bfd6ed102a1b70e1dbfffdbfcc6cbe87ed5 (patch)
tree879018d19fab18e7d3af1afd3b98d9e6a639633c /docs/ch11-services.rst
parent4b076095a74003342450fd7fa5c660f4831609e4 (diff)
downloadvyos-documentation-77d07bfd6ed102a1b70e1dbfffdbfcc6cbe87ed5.tar.gz
vyos-documentation-77d07bfd6ed102a1b70e1dbfffdbfcc6cbe87ed5.zip
Service: Add Multicast DNS repeater chapter
Diffstat (limited to 'docs/ch11-services.rst')
-rw-r--r--docs/ch11-services.rst26
1 files changed, 26 insertions, 0 deletions
diff --git a/docs/ch11-services.rst b/docs/ch11-services.rst
index 43397d38..2cdafa2b 100644
--- a/docs/ch11-services.rst
+++ b/docs/ch11-services.rst
@@ -789,5 +789,31 @@ ddclient_ will load the webpage at `[url]` and will try to extract an IP
address for the response. ddclient_ will skip any address located before the
string set in `[skip]`.
+mDNS Repeater
+=============
+
+Starting with VyOS 1.2 a `Multicast DNS`_ (mDNS) repeater functionality is
+provided.
+
+Multicast DNS uses the 224.0.0.51 address, which is "administratively scoped"
+and does not leave the subnet. It re-broadcast mDNS packets from one interface
+to other interfaces. This enables support for e.g. Apple Airplay devices across
+multiple VLANs.
+
+To enable mDNS repeater you need to configure at least two interfaces. To re-
+broadcast all mDNS packets from `eth0` to `eth1` and vice versa run:
+
+.. code-block:: sh
+
+ set service mdns repeater interface eth0
+ set service mdns repeater interface eth1
+
+mDNS repeater can be temporarily disabled without deleting the service using
+
+.. code-block:: sh
+
+ set service mdns repeater disable
+
.. _ddclient: http://sourceforge.net/p/ddclient/wiki/Home/
.. _RFC2136: https://www.ietf.org/rfc/rfc2136.txt
+.. _`Multicast DNS`: https://en.wikipedia.org/wiki/Multicast_DNS