git: 785bd1d3d8 - main - handbook: network-servers: Add a section about zeroconf and Avahi

From: Mateusz Piotrowski <0mp_at_FreeBSD.org>
Date: Thu, 18 Apr 2024 08:48:47 UTC
The branch main has been updated by 0mp:

URL: https://cgit.FreeBSD.org/doc/commit/?id=785bd1d3d84ca772b77f24b72bf08ab155fc56fe

commit 785bd1d3d84ca772b77f24b72bf08ab155fc56fe
Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
AuthorDate: 2024-04-18 08:43:28 +0000
Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
CommitDate: 2024-04-18 08:46:28 +0000

    handbook: network-servers: Add a section about zeroconf and Avahi
    
    Sponsored by:   Klara, Inc.
---
 .../en/books/handbook/network-servers/_index.adoc  | 24 ++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/documentation/content/en/books/handbook/network-servers/_index.adoc b/documentation/content/en/books/handbook/network-servers/_index.adoc
index 07ee163b17..fb4eeaa2b6 100644
--- a/documentation/content/en/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/en/books/handbook/network-servers/_index.adoc
@@ -2007,6 +2007,30 @@ freebsd.org. (A)
 FreeBSD does not provide authoritative name server software in the base system.
 Users are encouraged to install third party applications, like package:dns/nsd[] or package:dns/bind918[] package or port.
 
+[[network-zeroconf]]
+== Zero-configuration networking (mDNS/DNS-SD)
+
+https://en.wikipedia.org/wiki/Zero-configuration_networking[Zero-configuration networking] (sometimes referred to as zeroconf) is a set of technologies, which simplify network configuration by providing:
+
+* automatic assignment of numeric network addresses (mDNS),
+* automatic distribution and resolution of hostnames (mDNS), and
+* automatic discovery of service instances (DNS-SD).
+
+=== Configuring and Starting Avahi
+
+One of the popular implementations of zeroconf is https://avahi.org/[Avahi].
+Avahi can be installed and configured with the following commands:
+
+[source,shell]
+....
+# pkg install avahi-app nss_mdns
+# grep -q '^hosts:.*\<mdns\>' /etc/nsswitch.conf || sed -i "" 's/^hosts: .*/& mdns/' /etc/nsswitch.conf
+# service dbus enable
+# service avahi-daemon enable
+# service dbus start
+# service avahi-daemon start
+....
+
 [[network-apache]]
 == Apache HTTP Server