From nobody Thu Jul 13 09:37:17 2023 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 4R1qJY2F7Rz4nLnY for ; Thu, 13 Jul 2023 09:37:17 +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 4R1qJY1nFmz3CfG; Thu, 13 Jul 2023 09:37:17 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1689241037; 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=ZqwKaUpAedjKVYNWG37nn5uurHdmWyZtQ1Hyq4snedc=; b=cdGtZqn6pZfToUgfT/1nyX28Sgn90CYm+IqyOBtdddGSXYU+UJhuxmr4ISb9Jz0H1G/1Xi 4m7knnTvioA07HeHM+2qWQU/d4Wvoz4F3c7msmzBGxbdQpiqdSv3njHQYRQ+vt6QzS5YPh i7erRYfBIJLUStb19DHY1NspuLZPOwe2fRxiZKgaAXjHDRzGdmmZafLOV05gYW1HYIXWC1 XMD/HxQZaXx5w6szy02iMJCA+6dOvWV5GBdb9PjwXDm1OLmkkohPb7+P/LLByU5S1xWrau fe+2VRRkaKqcj1jb0McBcAFnfpphK25254bw80lMds8UJq9/BFpYenowfTg70Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1689241037; 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=ZqwKaUpAedjKVYNWG37nn5uurHdmWyZtQ1Hyq4snedc=; b=X7FMc/OFHPw+ncGtyatTKAXE3WvVq9k7QzSz/K+qW5a/HrAxIFCTMitFLs8c3i6ZURm2xL javC11VVXwtGS3LjO4ZPZTCIVBY9HEal08KOhlqX7L3c1pCTPix1UjI7E8irU1YGl/T7cd iewC47jl98XExOlvD0XSgs5nOQnGucVyxOaKoYVbJYUW75Zb8x68K0tzUd+VJP114J/Hds OPR4QvnWeM4M748ADEsJnSy+du2sq7GfPEntd11rxM75mW+DN5Yc/5+XXcvLF6ysSmhQ3H aqb3a7LpEbpaamBmM6almfBFO2RVbmSIVdJt08n6Sa+NtMsOfk2jzKa2WXeZVg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1689241037; a=rsa-sha256; cv=none; b=rTANIijOKm3XqayIdY+9i/8+pgiiBMFhK1FxLe2bXwHLbv7jQ3c0PS4C6CXKVeeaFSstt4 3QOo4OHRT4yzUWPnXrcqnfABN4JdyajLyl/Di4J8SciV0vTj9N08MB8q3Y7d2dkhkpFk95 YRfaOTScS2hQ8MMp6JrcwKTzCQLB+ioYI6Y4jdfo4z2e7JOpqbogovFy48cWy5SCT+5zPc IHu1fXlisVcZ9MD8aZSLrgALy2J+HM5DEnqAPArbYxNJGfgcSOkH2uOwCBRvfHsaIFATJ7 IT16D0OOzJtJFkVWbHvCUFYrW3wTImKH6ubNfzNq6U1qSPpw5Q55sm9L1+AAlg== 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 4R1qJY0qyLzmRZ; Thu, 13 Jul 2023 09:37:17 +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 36D9bHK7033354; Thu, 13 Jul 2023 09:37:17 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 36D9bHGv033353; Thu, 13 Jul 2023 09:37:17 GMT (envelope-from git) Date: Thu, 13 Jul 2023 09:37:17 GMT Message-Id: <202307130937.36D9bHGv033353@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 019993dd43 - main - Typos and improvements in network chapter 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: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 019993dd43ff2c538b440924c2db2c670e665d7d Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=019993dd43ff2c538b440924c2db2c670e665d7d commit 019993dd43ff2c538b440924c2db2c670e665d7d Author: Sergio Carlavilla Delgado AuthorDate: 2023-07-13 09:36:21 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-07-13 09:37:09 +0000 Typos and improvements in network chapter Reported by: karels@ Sponsored by: Daifressh --- .../content/en/books/handbook/network/_index.adoc | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/documentation/content/en/books/handbook/network/_index.adoc b/documentation/content/en/books/handbook/network/_index.adoc index 45e4a1a6bd..2a05310e37 100644 --- a/documentation/content/en/books/handbook/network/_index.adoc +++ b/documentation/content/en/books/handbook/network/_index.adoc @@ -209,7 +209,7 @@ em0: flags=8822 metric 0 mtu 1500 This section provides a guide to configuring a static IPv4 address on a FreeBSD system. -The network interface card (NIC) configuration can be performed from the command line with man:ifconfig[8] but will not persist after a reboot unless the configuration is also added to [.filename]#/etc/rc.conf#. +The network interface card configuration can be performed from the command line with man:ifconfig[8] but will not persist after a reboot unless the configuration is also added to [.filename]#/etc/rc.conf#. [NOTE] ==== @@ -493,20 +493,19 @@ To assign a default router, specify its address executing the following command: === Configuring Dynamic IPv6 Address If the network has a DHCP server, it is very easy to configure the network interface to use DHCP. -FreeBSD uses man:dhclient[8] as the DHCP client. man:dhclient[8] will provide automatically the IP, the netmask and the default router. To make the interface works with DHCP execute the following command: [source,shell] .... -# sysrc ifconfig_em0_ipv6="inet6 DHCP accept_rtadv" +# sysrc ifconfig_em0_ipv6="inet6 accept_rtadv" # sysrc rtsold_enable="YES" .... === Router Advertisement and Host Auto Configuration -This section demonstrates how to setup man:rtadvd[8] to advertise the IPv6 default route. +This section demonstrates how to setup man:rtadvd[8] on an IPv6 router to advertise the IPv6 network prefix and default route. To enable man:rtadvd[8], execute the following command: @@ -793,7 +792,7 @@ The output should be similar to the following: [.programlisting] .... -freebsdhostname +freebsdhostname.example.com .... [[change-hostname]] @@ -803,7 +802,7 @@ To change the hostname of the host and persist it across reboots execute the fol [source,shell] .... -# sysrc hostname="newhostname" +# sysrc hostname="freebsdhostname.example.com" .... [[dns]] @@ -811,10 +810,10 @@ To change the hostname of the host and persist it across reboots execute the fol The DNS could be understanded as a link:https://en.wikipedia.org/wiki/Telephone_directory[telephone directory] in which an IP is identified to a hostname and vice versa. -There are three files who handle how a FreeBSD system interact with the DNS. +There are three files that handle how a FreeBSD system interact with the DNS. These three files are man:hosts[5], man:resolv.conf[5] and man:nsswitch.conf[5] -Unless otherwise stated in the [.filename]#/etc/nsswitch.conf# file, FreeBSD will look at the addresses in the [.filename]#/etc/hosts# file and then the [.filename]#/etc/resolv.conf# file. +Unless otherwise stated in the [.filename]#/etc/nsswitch.conf# file, FreeBSD will look at the addresses in the [.filename]#/etc/hosts# file and then the DNS information in the [.filename]#/etc/resolv.conf# file. [NOTE] ====