summaryrefslogtreecommitdiff
path: root/docs/services/mdns-repeater.rst
diff options
context:
space:
mode:
authorYuriy Andamasov <andamasov@gmail.com>2019-01-20 16:17:30 +0100
committerGitHub <noreply@github.com>2019-01-20 16:17:30 +0100
commit612ab4def61755afc369c8e226588b15db0bc751 (patch)
tree8356346a5b7a4b51339a4975f10da3f4b9123ef9 /docs/services/mdns-repeater.rst
parentce02006259e45ea9b0ab5f30ac3f1639d2338505 (diff)
parent1ac4afa392eb4c077507cf3866ebc1b8b3cb1793 (diff)
downloadvyos-documentation-612ab4def61755afc369c8e226588b15db0bc751.tar.gz
vyos-documentation-612ab4def61755afc369c8e226588b15db0bc751.zip
Merge pull request #7 from kmpm/festures/split-services
services in own folder
Diffstat (limited to 'docs/services/mdns-repeater.rst')
-rw-r--r--docs/services/mdns-repeater.rst30
1 files changed, 30 insertions, 0 deletions
diff --git a/docs/services/mdns-repeater.rst b/docs/services/mdns-repeater.rst
new file mode 100644
index 00000000..0afdc90a
--- /dev/null
+++ b/docs/services/mdns-repeater.rst
@@ -0,0 +1,30 @@
+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
+
+.. note:: You can not run this in a VRRP setup, if multiple mDNS repeaters
+ are launched in a subnet you will experience the mDNS packet storm death!
+
+
+.. _`Multicast DNS`: https://en.wikipedia.org/wiki/Multicast_DNS