From nobody Sat Apr 8 10:11:25 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 4PtrcG4YMwz44G58 for ; Sat, 8 Apr 2023 10:11:26 +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 4PtrcG0MrKz3wjq; Sat, 8 Apr 2023 10:11:26 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1680948686; 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=3GXizhmaUs1I9qAxnKEjkHQtwYK0ZMBVeLcSZOg6p5E=; b=h+DJXJED5KnVfGq4G1Ag5HYYtwsn3goCzJXhaI0aXRZaZfxTLSZtzhiPmiW44Ig19L24en bugsZcpWKfLngmXxJ3Ea1DY828n6PfZRNNeVu8PBm1gH7f9t3dPdDtxzkSzRKyAJev9FGV UVVjv4b57s6kAXmfdIzPYqgT8sfm624WK/xx5gyRAX8pmZA7eYlkxLwgVCOxIJ4MCEw5ce QLtfjsJMffB7ZfifJ91yhf7ohQFWpF935Akq4aDQCqQRSCXeBzJVHbNGm1TjfU0DqZzM2c CBjrLfPuKogMp7O6Wt27PotEHMhGkSCnP9H4rn6sAi5XpCAZRpI9tNls2JTGOw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1680948686; 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=3GXizhmaUs1I9qAxnKEjkHQtwYK0ZMBVeLcSZOg6p5E=; b=iUsAicvUhz7wjxRaW/hfUyfdeMNRsGkho8Aq1jogl4qIWC8EgrbRQc4A+U2KtwiUuXH/fo /JCEl3VVoLUKmzkIsh+8ut8+kMuUmnulMfKEVGx19FA483WqTVLzQTXnSUBsSUvU2Hgh8I BwCIjgy+2/QA4cgJdVPEGUz42l3uac2dUtcxYdGBknB0XHHKPnzwPOFyUbrjpOUEyC3o+K UD4o1O5cx5GwDLTR4Gso2FcQ7x+wPZ08NgA0KKyVMdCizq/FSZG822aIX8YRWP59VTZCVP JoM2zOHBRV3Qd9t4kzTSzFmwacE4nmUpR0RNST1BJ4Y2ksf5Mo+P39G8D3mVLw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1680948686; a=rsa-sha256; cv=none; b=YK/eJ2oNgJmfinLuiUi1JNHZe9G3G4p8La/XNTvj1Cw0eqD4iS6areQZAQYNPccRpE0ujL gQIThvTcLDSWa9dxgF2jrESImNmMXqdafBY2pYN89Q5WAK6iV6HenVWmYBu7aK+Ru7VTzy xLgbpgZNLOi6ksu2/zdti1DdpSiUiHcbxifRvRZrdaf/U/kiKXDmJRvPxFa61rsMGgLpcS 3nf2zYEQsAJ4T2TL3qBGlWz5fFkHRCB45NpwYPDgdyf91R3uDhu6lMaz75b96ZAGNZQnDb yMM7G3lOIGByOeprUp0PRD/6vs4GO0qE0uUkyIoSSfZFTFDGx/XkFy3P3oDCxg== 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 4PtrcF5K9LzN6M; Sat, 8 Apr 2023 10:11:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 338ABP6u073706; Sat, 8 Apr 2023 10:11:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 338ABPq9073705; Sat, 8 Apr 2023 10:11:25 GMT (envelope-from git) Date: Sat, 8 Apr 2023 10:11:25 GMT Message-Id: <202304081011.338ABPq9073705@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: f74156c411 - main - Handbook - Update FreeBSD versions to 13.1 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: f74156c411c05c9e98fe7b670ca474bfe21bc611 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=f74156c411c05c9e98fe7b670ca474bfe21bc611 commit f74156c411c05c9e98fe7b670ca474bfe21bc611 Author: Minsoo Choo AuthorDate: 2023-04-08 10:10:11 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-04-08 10:10:11 +0000 Handbook - Update FreeBSD versions to 13.1 Differential Revision: https://reviews.freebsd.org/D37184 Reviewed by: lwhsu@, Pau Amma --- .../content/en/books/handbook/bsdinstall/_index.adoc | 2 +- .../content/en/books/handbook/cutting-edge/_index.adoc | 15 ++++++++------- documentation/content/en/books/handbook/jails/_index.adoc | 12 ++++++------ .../content/en/books/handbook/virtualization/_index.adoc | 8 ++++---- 4 files changed, 19 insertions(+), 18 deletions(-) diff --git a/documentation/content/en/books/handbook/bsdinstall/_index.adoc b/documentation/content/en/books/handbook/bsdinstall/_index.adoc index 2ee52c6588..2d610c108b 100644 --- a/documentation/content/en/books/handbook/bsdinstall/_index.adoc +++ b/documentation/content/en/books/handbook/bsdinstall/_index.adoc @@ -216,7 +216,7 @@ Be *very careful* that the correct device is used as this command will destroy t + [source,shell] .... -# dd if=FreeBSD-13.0-RELEASE-amd64-memstick.img of=/dev/da0 bs=1M conv=sync +# dd if=FreeBSD-13.1-RELEASE-amd64-memstick.img of=/dev/da0 bs=1M conv=sync .... + If this command fails, verify that the USB stick is not mounted and that the device name is for the disk, not a partition. diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc index 825c66ee6d..e2e28b1eef 100644 --- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc @@ -257,11 +257,11 @@ If the system is running a custom kernel, make sure that a copy of the [.filenam Refer to <> for instructions on how to get a copy of the [.filename]#GENERIC# kernel. ==== -The following command, when run on a FreeBSD 9.0 system, will upgrade it to FreeBSD 9.1: +The following command, when run on a FreeBSD 13.0 system, will upgrade it to FreeBSD 13.1: [source,shell] .... -# freebsd-update -r 9.1-RELEASE upgrade +# freebsd-update -r 13.1-RELEASE upgrade .... After the command has been received, `freebsd-update` will evaluate the configuration file and current system in an attempt to gather the information necessary to perform the upgrade. @@ -271,7 +271,7 @@ For example: [source,shell] .... Looking up update.FreeBSD.org mirrors... 1 mirrors found. -Fetching metadata signature for 9.0-RELEASE from update1.FreeBSD.org... done. +Fetching metadata signature for 13.0-RELEASE from update1.FreeBSD.org... done. Fetching metadata index... done. Inspecting system... done. @@ -296,7 +296,7 @@ When using a custom kernel, the above step will produce a warning similar to the [source,shell] .... WARNING: This system is running a "MYKERNEL" kernel, which is not a -kernel configuration distributed as part of FreeBSD 9.0-RELEASE. +kernel configuration distributed as part of FreeBSD 13.0-RELEASE. This kernel will not be updated: you MUST update the kernel manually before running "/usr/sbin/freebsd-update install" .... @@ -794,15 +794,16 @@ Determine which version of FreeBSD is being used with man:uname[1]: [source,shell] .... # uname -r -10.3-RELEASE +13.1-RELEASE .... -Based on <>, the source used to update `10.3-RELEASE` has a repository path of `releng/10.3`. That path is used when checking out the source: +Based on <>, the source used to update `13.1-RELEASE` has a repository path of `releng/13.1`. +That path is used when checking out the source: [source,shell] .... # mv /usr/src /usr/src.bak <.> -# git clone --branch releng/10.3 https://git.FreeBSD.org/src.git /usr/src <.> +# git clone --branch releng/13.1 https://git.FreeBSD.org/src.git /usr/src <.> .... <.> Move the old directory out of the way. If there are no local modifications in this directory, it can be deleted. diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc index efc0b4e0c2..a53c90ea97 100644 --- a/documentation/content/en/books/handbook/jails/_index.adoc +++ b/documentation/content/en/books/handbook/jails/_index.adoc @@ -335,11 +335,11 @@ To update the jail to the latest patch release of the version of FreeBSD it is a To upgrade the jail to a new major or minor version, first upgrade the host system as described in crossref:cutting-edge[freebsdupdate-upgrade,“Performing Major and Minor Version Upgrades”]. Once the host has been upgraded and rebooted, the jail can then be upgraded. -For example to upgrade from 12.0-RELEASE to 12.1-RELEASE, on the host run: +For example to upgrade from 12.2-RELEASE to 12.3-RELEASE, on the host run: [source,shell] .... -# freebsd-update -b /here/is/the/jail --currently-running 12.0-RELEASE -r 12.1-RELEASE upgrade +# freebsd-update -b /here/is/the/jail --currently-running 12.2-RELEASE -r 12.3-RELEASE upgrade # freebsd-update -b /here/is/the/jail install # service jail restart myjail # freebsd-update -b /here/is/the/jail install @@ -720,7 +720,7 @@ The ezjailFAQ explains in more detail: http://erdgeist.org/arts/software/ezjail/ . To Populate the Jail with FreeBSD-RELEASE + For a basejail based on the FreeBSD RELEASE matching that of the host computer, use `install`. -For example, on a host computer running FreeBSD 10-STABLE, the latest RELEASE version of FreeBSD -10 will be installed in the jail): +For example, on a host computer running FreeBSD 13-STABLE, the latest RELEASE version of FreeBSD 13 will be installed in the jail) + [source,shell] .... @@ -902,14 +902,14 @@ Use man:file[1] to determine the original version in the basejail: [source,shell] .... # file /usr/jails/basejail/bin/sh -/usr/jails/basejail/bin/sh: ELF 64-bit LSB executable, x86-64, version 1 (FreeBSD), dynamically linked (uses shared libs), for FreeBSD 9.3, stripped +/usr/jails/basejail/bin/sh: ELF 64-bit LSB executable, x86-64, version 1 (FreeBSD), dynamically linked, interpreter /libexec/ld-elf.so.1, for FreeBSD 13.0, FreeBSD-style, stripped .... -Now use this information to perform the upgrade from `9.3-RELEASE` to the current version of the host system: +Now use this information to perform the upgrade from `13.0-RELEASE` to the current version of the host system: [source,shell] .... -# ezjail-admin update -U -s 9.3-RELEASE +# ezjail-admin update -U -s 13.0-RELEASE .... After updating the basejail, man:mergemaster[8] must be run to update each jail's configuration files. diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc index 6d4067d786..f7ed3fab3e 100644 --- a/documentation/content/en/books/handbook/virtualization/_index.adoc +++ b/documentation/content/en/books/handbook/virtualization/_index.adoc @@ -608,8 +608,8 @@ Download an installation image of FreeBSD to install: [source,shell] .... -# fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/ISO-IMAGES/12.2/FreeBSD-12.2-RELEASE-amd64-bootonly.iso -FreeBSD-12.2-RELEASE-amd64-bootonly.iso 100% of 230 MB 570 kBps 06m17s +# fetch https://download.freebsd.org/releases/ISO-IMAGES/13.1/FreeBSD-13.1-RELEASE-amd64-bootonly.iso +FreeBSD-13.1-RELEASE-amd64-bootonly.iso 366 MB 16 MBps 22s .... FreeBSD comes with an example script for running a virtual machine in bhyve. @@ -620,7 +620,7 @@ This example starts the virtual machine in installation mode: [source,shell] .... -# sh /usr/share/examples/bhyve/vmrun.sh -c 1 -m 1024M -t tap0 -d guest.img -i -I FreeBSD-12.2-RELEASE-amd64-bootonly.iso guestname +# sh /usr/share/examples/bhyve/vmrun.sh -c 1 -m 1024M -t tap0 -d guest.img -i -I FreeBSD-13.1-RELEASE-amd64-bootonly.iso guestname .... The virtual machine will boot and start the installer. @@ -1028,7 +1028,7 @@ The ISO installation file is retrieved with man:fetch[1] and saved locally in a [source,shell] .... -# fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/ISO-IMAGES/12.0/FreeBSD-12.0-RELEASE-amd64-bootonly.iso -o freebsd.iso +# fetch https://download.freebsd.org/releases/ISO-IMAGES/13.1/FreeBSD-13.1-RELEASE-amd64-bootonly.iso -o freebsd.iso .... A ZFS volume of 20 GB called [.filename]#xendisk0# is created to serve as the disk space for the VM.