From nobody Sun Dec 21 19:24:54 2025 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 4dZB6t4nmtz6LNJc for ; Sun, 21 Dec 2025 19:24:54 +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 "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dZB6t0v0vz3Ynp for ; Sun, 21 Dec 2025 19:24:54 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1766345094; 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=5fhnWIo9pDgFIXEJlXmNczNh63cExl4T5GikiNDbNg0=; b=yASO3Ag+pqoZWJy9q1Om3igPrDXx70Yf+52+C8KgWZqZmlBN7wV3wq/5D/RQiMOMaFDBH5 +CdO62xLofD+usKprlELFIvdLYbGBqXx7Y89+U/4zuY3BfieUFuOEhkf8Qy+b2jALPdCrP vkNY7kqhlrA2psIcHFri09k0ZAiJr8EUdQH2lz/0kC1DXSiIC/GkPqMS7uAM2W363quv/W Lup1cn4wf22bsBcGfJeayb92gsNWNaP/sm3vNoL2g7hIlG51rdsaj6yzopf/Ki36+Ua+hd Z2K8wpJaTRt8nT+QJlpGkHPbaNJWnUzMUKENwOh9QoMWahm/qz+ezj7OgWL13A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1766345094; 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=5fhnWIo9pDgFIXEJlXmNczNh63cExl4T5GikiNDbNg0=; b=gA3WW/lkWVclBIQmYNEMO/kVVCAjctwSekmkfL6qVYxK2cKfJHFmy4WcGcFgDgbmvtkxu2 CCqcJzqN2IhFvDsaEB7EF/SoMcUVY2iZHsoncO0mB6DlUm119DvtecIn+iuIRju/s44Ddo UDx9GdatjT9+n49P+78NIU5mZHBFXxTReQLSeSBQ3WnfcM5y7KNoMBvIkCJ2B808VF/1cl z0QrqU1+PQxNLr7ZvZJYOad4mXPhfpXC+UbDk/l7Bi4+QUwRU2TqxylPpSuPzfx2WPZ3Uw DVCyhhxLxhgAP3ds5z8hdr6IDUReQEJk9v9SsKLHhdWWuUkrcTnW4ugFyQyD+A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1766345094; a=rsa-sha256; cv=none; b=MJ8UzbZzny+y2tPX79KbA3Zccl9eBnl1Y8v3h+K0B2Gkx841pCf0Oa1t4X1ZxI5yMAZrGt eGz33eaFE/NKEoh8MzlBOq5W1NY/1wdpayQMAsvyzhej1WX9aa4GZjiCnqdk3xkL/dlaog aHIgVZCG07nduPp6HQgJ/w+iyt1uAq8hx3dyM3mEQuXdIcsws+E7oTfnoAnFZoJ6M97tzk 7QXS/B9KeF/a9u7jonGxR7guoOLwJjJu0JXAsU+YClsv3WLzcoYJgvmIHPsaAWlqlFijyU MgwVhufRGgfTHm2KwnuP3NhafduGCApvOnYm0Mr0MDc7kRYl8oqLGMNJ2+eM5w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dZB6t0VYrztdf for ; Sun, 21 Dec 2025 19:24:54 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 34acc by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sun, 21 Dec 2025 19:24:54 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Alexander Ziaee Subject: git: 6c85dc012a - main - handbook/jails: Use latest release macro 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: ziaee X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6c85dc012a980a1b525d026142c867aae2ecbb2a Auto-Submitted: auto-generated Date: Sun, 21 Dec 2025 19:24:54 +0000 Message-Id: <69484986.34acc.1a58752b@gitrepo.freebsd.org> The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/doc/commit/?id=6c85dc012a980a1b525d026142c867aae2ecbb2a commit 6c85dc012a980a1b525d026142c867aae2ecbb2a Author: Alexander Ziaee AuthorDate: 2025-12-21 19:00:14 +0000 Commit: Alexander Ziaee CommitDate: 2025-12-21 19:23:41 +0000 handbook/jails: Use latest release macro Fixes: dbac0b5f5208 (Use betarel-current variable in commands) Reported by: George Timms --- .../content/en/books/handbook/jails/_index.adoc | 62 +++++++++++----------- 1 file changed, 31 insertions(+), 31 deletions(-) diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc index 35813488ef..302791d767 100644 --- a/documentation/content/en/books/handbook/jails/_index.adoc +++ b/documentation/content/en/books/handbook/jails/_index.adoc @@ -363,7 +363,7 @@ Execute the following command to download the userland: [source,shell,subs=attributes] .... -# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/{betarel-current}-RELEASE/base.txz -o /usr/local/jails/media/{betarel-current}-RELEASE-base.txz +# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/{rel-latest}-RELEASE/base.txz -o /usr/local/jails/media/{rel-latest}-RELEASE-base.txz .... Once the download is complete, it will be necessary to extract the contents into the jail directory. @@ -373,7 +373,7 @@ Execute the following commands to extract the userland into the jail's directory [source,shell,subs=attributes] .... # mkdir -p /usr/local/jails/containers/classic -# tar -xf /usr/local/jails/media/{betarel-current}-RELEASE-base.txz -C /usr/local/jails/containers/classic --unlink +# tar -xf /usr/local/jails/media/{rel-latest}-RELEASE-base.txz -C /usr/local/jails/containers/classic --unlink .... With the userland extracted in the jail directory, it will be necessary to copy the timezone and DNS server files: @@ -451,36 +451,36 @@ To create the dataset for the template, execute the following command: [source,shell,subs=attributes] .... -# zfs create -p zroot/jails/templates/{betarel-current}-RELEASE +# zfs create -p zroot/jails/templates/{rel-latest}-RELEASE .... Then execute the following command to download the userland: [source,shell,subs=attributes] .... -# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/{betarel-current}-RELEASE/base.txz -o /usr/local/jails/media/{betarel-current}-RELEASE-base.txz +# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/{rel-latest}-RELEASE/base.txz -o /usr/local/jails/media/{rel-latest}-RELEASE-base.txz .... Once the download is complete, it will be necessary to extract the contents in the template directory by executing the following command: [source,shell,subs=attributes] .... -# tar -xf /usr/local/jails/media/{betarel-current}-RELEASE-base.txz -C /usr/local/jails/templates/{betarel-current}-RELEASE --unlink +# tar -xf /usr/local/jails/media/{rel-latest}-RELEASE-base.txz -C /usr/local/jails/templates/{rel-latest}-RELEASE --unlink .... With the userland extracted in the templates directory, it will be necessary to copy the timezone and DNS server files to the template directory by executing the following command: [source,shell,subs=attributes] .... -# cp /etc/resolv.conf /usr/local/jails/templates/{betarel-current}-RELEASE/etc/resolv.conf -# cp /etc/localtime /usr/local/jails/templates/{betarel-current}-RELEASE/etc/localtime +# cp /etc/resolv.conf /usr/local/jails/templates/{rel-latest}-RELEASE/etc/resolv.conf +# cp /etc/localtime /usr/local/jails/templates/{rel-latest}-RELEASE/etc/localtime .... The next thing to do is update to the latest patch level by executing the following command: [source,shell,subs=attributes] .... -# freebsd-update -b /usr/local/jails/templates/{betarel-current}-RELEASE/ fetch install +# freebsd-update -b /usr/local/jails/templates/{rel-latest}-RELEASE/ fetch install .... Once the update is finished, the template is ready. @@ -489,7 +489,7 @@ To create an OpenZFS Snapshot from the template, execute the following command: [source,shell,subs=attributes] .... -# zfs snapshot zroot/jails/templates/{betarel-current}-RELEASE@base +# zfs snapshot zroot/jails/templates/{rel-latest}-RELEASE@base .... Once the OpenZFS Snapshot has been created, infinite jails can be created using the OpenZFS clone function. @@ -498,7 +498,7 @@ To create a Thin Jail named `thinjail`, execute the following command: [source,shell,subs=attributes] .... -# zfs clone zroot/jails/templates/{betarel-current}-RELEASE@base zroot/jails/containers/thinjail +# zfs clone zroot/jails/templates/{rel-latest}-RELEASE@base zroot/jails/containers/thinjail .... The last step is to configure the jail. @@ -548,43 +548,43 @@ The first step is to create the dataset to save the template, execute the follow [source,shell,subs=attributes] .... -# zfs create -p zroot/jails/templates/{betarel-current}-RELEASE-base +# zfs create -p zroot/jails/templates/{rel-latest}-RELEASE-base .... Or this one if using UFS: [source,shell,subs=attributes] .... -# mkdir /usr/local/jails/templates/{betarel-current}-RELEASE-base +# mkdir /usr/local/jails/templates/{rel-latest}-RELEASE-base .... Then execute the following command to download the userland: [source,shell,subs=attributes] .... -# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/{betarel-current}-RELEASE/base.txz -o /usr/local/jails/media/{betarel-current}-RELEASE-base.txz +# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/{rel-latest}-RELEASE/base.txz -o /usr/local/jails/media/{rel-latest}-RELEASE-base.txz .... Once the download is complete, it will be necessary to extract the contents in the template directory by executing the following command: [source,shell,subs=attributes] .... -# tar -xf /usr/local/jails/media/{betarel-current}-RELEASE-base.txz -C /usr/local/jails/templates/{betarel-current}-RELEASE-base --unlink +# tar -xf /usr/local/jails/media/{rel-latest}-RELEASE-base.txz -C /usr/local/jails/templates/{rel-latest}-RELEASE-base --unlink .... Once the userland is extracted in the templates directory, it will be necessary to copy the timezone and DNS server files to the template directory by executing the following command: [source,shell,subs=attributes] .... -# cp /etc/resolv.conf /usr/local/jails/templates/{betarel-current}-RELEASE-base/etc/resolv.conf -# cp /etc/localtime /usr/local/jails/templates/{betarel-current}-RELEASE-base/etc/localtime +# cp /etc/resolv.conf /usr/local/jails/templates/{rel-latest}-RELEASE-base/etc/resolv.conf +# cp /etc/localtime /usr/local/jails/templates/{rel-latest}-RELEASE-base/etc/localtime .... With the files moved to the template, the next thing to do is update to the latest patch level by executing the following command: [source,shell,subs=attributes] .... -# freebsd-update -b /usr/local/jails/templates/{betarel-current}-RELEASE-base/ fetch install +# freebsd-update -b /usr/local/jails/templates/{rel-latest}-RELEASE-base/ fetch install .... In addition to the base template, it is also necessary to create a directory where the `skeleton` will be located. @@ -594,14 +594,14 @@ Execute the following command to create the dataset for the `skeleton` in case o [source,shell,subs=attributes] .... -# zfs create -p zroot/jails/templates/{betarel-current}-RELEASE-skeleton +# zfs create -p zroot/jails/templates/{rel-latest}-RELEASE-skeleton .... Or this one in case of using UFS: [source,shell,subs=attributes] .... -# mkdir /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton +# mkdir /usr/local/jails/templates/{rel-latest}-RELEASE-skeleton .... Then create the `skeleton` directories. @@ -611,20 +611,20 @@ Execute the following commands to create the directories: [source,shell,subs=attributes] .... -# mkdir -p /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/home -# mkdir -p /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/usr -# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/etc /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/etc -# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/usr/local /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/usr/local -# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/tmp /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/tmp -# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/var /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/var -# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/root /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/root +# mkdir -p /usr/local/jails/templates/{rel-latest}-RELEASE-skeleton/home +# mkdir -p /usr/local/jails/templates/{rel-latest}-RELEASE-skeleton/usr +# mv /usr/local/jails/templates/{rel-latest}-RELEASE-base/etc /usr/local/jails/templates/{rel-latest}-RELEASE-skeleton/etc +# mv /usr/local/jails/templates/{rel-latest}-RELEASE-base/usr/local /usr/local/jails/templates/{rel-latest}-RELEASE-skeleton/usr/local +# mv /usr/local/jails/templates/{rel-latest}-RELEASE-base/tmp /usr/local/jails/templates/{rel-latest}-RELEASE-skeleton/tmp +# mv /usr/local/jails/templates/{rel-latest}-RELEASE-base/var /usr/local/jails/templates/{rel-latest}-RELEASE-skeleton/var +# mv /usr/local/jails/templates/{rel-latest}-RELEASE-base/root /usr/local/jails/templates/{rel-latest}-RELEASE-skeleton/root .... The next step is to create the symlinks to the `skeleton` by executing the following commands: [source,shell,subs=attributes] .... -# cd /usr/local/jails/templates/{betarel-current}-RELEASE-base/ +# cd /usr/local/jails/templates/{rel-latest}-RELEASE-base/ # mkdir skeleton # ln -s skeleton/etc etc # ln -s skeleton/home home @@ -640,15 +640,15 @@ In case of using OpenZFS, OpenZFS snapshots can be used to easily create as many [source,shell,subs=attributes] .... -# zfs snapshot zroot/jails/templates/{betarel-current}-RELEASE-skeleton@base -# zfs clone zroot/jails/templates/{betarel-current}-RELEASE-skeleton@base zroot/jails/containers/thinjail +# zfs snapshot zroot/jails/templates/{rel-latest}-RELEASE-skeleton@base +# zfs clone zroot/jails/templates/{rel-latest}-RELEASE-skeleton@base zroot/jails/containers/thinjail .... In case of using UFS the man:cp[1] program can be used by executing the following command: [source,shell,subs=attributes] .... -# cp -R /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton /usr/local/jails/containers/thinjail +# cp -R /usr/local/jails/templates/{rel-latest}-RELEASE-skeleton /usr/local/jails/containers/thinjail .... Then create the directory in which the base template and the skeleton will be mounted: @@ -690,7 +690,7 @@ Then the create the [.filename]#/usr/local/jails/thinjail-nullfs-base.fstab# fil [.programlisting,subs=attributes] .... -/usr/local/jails/templates/{betarel-current}-RELEASE-base /usr/local/jails/thinjail-nullfs-base/ nullfs ro 0 0 +/usr/local/jails/templates/{rel-latest}-RELEASE-base /usr/local/jails/thinjail-nullfs-base/ nullfs ro 0 0 /usr/local/jails/containers/thinjail /usr/local/jails/thinjail-nullfs-base/skeleton nullfs rw 0 0 ....