From nobody Thu Apr 18 08:48:47 2024 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4VKrzM50Tqz5J8j8 for ; Thu, 18 Apr 2024 08:48:47 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4VKrzM4LSrz4f2k; Thu, 18 Apr 2024 08:48:47 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1713430127; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=v2i/nfs6/EFJ231Cjd+dlN7WC7YLRRHPyL6ke7zvnZo=; b=FLuIjGoc3ZVO8LSEh7gYVnp97gjdfuN/yZTDpF+M2FxgpbnbbbIBcjEJNplTd9OPGmCTg0 Hn3TBojIxBaA4oTJCbbVo0AME0UAKU50dKzUsP1MLABGc/XVZyqqpBN6YrWqxPXJAk40sr r89ioe3xvKhSKWgQRvUdw35cwn4e4y0T4/bjKQQhn0rqNryw+qJtLyWD69BtLpBkLteb81 jtoTxltRSDvuYrgtfHEHxuQ/wblPF9vO0//MJEa27JJRWJlHbk8J3kUAu+zmRKnDUucD0U HGi7q2EGbwgwUKb6r7sMuo4C0scHz/IVL9H1F9vTtAHBWw92pfbncTvfsC8buQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1713430127; a=rsa-sha256; cv=none; b=iEldl2fKYzKP+wVvnRZNRQpKSMpDyOY8fNwhW970Ntni8Rp0mvd8HjHCH0zpnSnIxLDCT3 wITaVqZpYgdNZd9dmpiHbktCk0uQU3RFeAjxkvCtNDh2lvdgEOpWsXCh9NiVFXczyMDz7o cOQi0AB/z9Jq+p5bm3YMh8k/lepmUozxtIjN1IR7Odt+vsQfAlWnsVaQ0UjHsICoosOR+Z hZgSBhXS4W3yfsPRpBifXtkPUYij+xGKV5urls9IpE2zOtxljPtRZqhD2O1L1Ch8JNlATC LJmSHPRf4Bz2wLe1TnvD5pJJzb44vbHt1cd4N3IA2rgJoay9OOdMGG/xVsy6Rw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1713430127; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=v2i/nfs6/EFJ231Cjd+dlN7WC7YLRRHPyL6ke7zvnZo=; b=ubMGXeTB5RGG9LqiyIYE5QDAaofnhSNxz9aAz+YI6M1bRGqqiLcaxN6uDZL3KULwoYuiet CxbvvBQ31yZlP/SBlh6y+FRkuNQ0DLA0U4CAAs0QS1OobeIlzwx57DnoONaXZBtW+UC/r1 JRqVtoVfWMVZNiRnj6APTd/twg6mrjTGZ9zh91Xq8TnKRfYQ2mzdcBN692c4GdFJag7BgQ YEP71LpAMgKF0HpED61pCLReNIZG9gF4V2XOxUBu8JEjgwPMhbOX3zenW2tb/yCx1TlP9i 9Ehsshj3M5so6lJAeYaf92We9a3e623Kr6i92oX4ttRox0yF0qb93Aq0TTLMBA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4VKrzM3tlBz12wh; Thu, 18 Apr 2024 08:48:47 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 43I8mlBI046668; Thu, 18 Apr 2024 08:48:47 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 43I8mlZM046665; Thu, 18 Apr 2024 08:48:47 GMT (envelope-from git) Date: Thu, 18 Apr 2024 08:48:47 GMT Message-Id: <202404180848.43I8mlZM046665@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 785bd1d3d8 - main - handbook: network-servers: Add a section about zeroconf and Avahi List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 785bd1d3d84ca772b77f24b72bf08ab155fc56fe Auto-Submitted: auto-generated 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:.*\' /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