From nobody Tue Jun 23 14:59:09 2026 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 4gl7WL3T2Hz6hXrg for ; Tue, 23 Jun 2026 14:59:10 +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 "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gl7WL10sZz44f0 for ; Tue, 23 Jun 2026 14:59:10 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1782226750; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=gKD75BJaS0q4s9wa9zzXTvcVkvdsejUmNVoUvNkFqsc=; b=O7aWAQALfgZMKDtYFZrkoPrnL56bfog7bXXfLl+C69mJS30UTWX9MIZy8o8iyzdG0LJ0NJ eIN3d3/tR4b6891gAxNsdO3uWQFzia4HB71kCCY0cOfQWHzuitLDe7tECV+DxREtsBMiOu YehUDBzOjyfxxK5P30g11C6KD0QTEFzJvk1AWZL+NJCvR93C8DQ683JiuGo6w6mN5L8R8d TKWaCQNX+ZChR+q4ewFN02o6CZdAukelupQLkBbgnqeLXjqzDbCBimPe+RReH91lpCK8qY 0Xd2ecr2bdJKOpCEbpoFm5OjblfkwWdrikvONqLXG1ghH1I2uJVFWlvsZbBBfg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1782226750; a=rsa-sha256; cv=none; b=IOfbm2zN/sgMf2LpVrTYRl/N4jGmChJrF1rqPbkjhrdj/YkxzWNq/w7rcuffo44WUCv4Hr /FbhtbDKWLawDHZai0Ypf1JTsi79GS+b0WsGbw/cMqCABtL8DbwgRyQLfFNy4htRcEQmRc aYOTSolHxeILamKcMJPCUNyBy710p1zMNNLxvxhVzx+pMUfw5ZUWqHT7xVHQOJWrJJgiQ9 7D+BVj2qh5aX3gh+CfN/+atqkWVNnDDOMcnsf9QzZSl7MyUQ1QsCYjef00CnCsTWfdchLw vOKikyG8LDsKUwbdeWXqy7psqvfJnLhFBozxAOmfB1dl5F+4je2Dl9Jq4ZT6xg== 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=1782226750; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=gKD75BJaS0q4s9wa9zzXTvcVkvdsejUmNVoUvNkFqsc=; b=fTN9LWH/mDnnsvXjLu3f6f4XJVMuJDswCzZDUvs9e60DrfpJH4LathZaPdnojNv0JMGYi3 8ftVM6wy/hKele30LILIh66lry0EQIZX+qNRheWbF0RPPfYvi28PAeSN0IxLQbeNnTwtoJ fHmcOxIK4VEljUQVpD1bCYr9mdtu6x4n0om9tf96nNRtDxE2J2jnBK2kenGf4IMFdSo9x4 SnvUq+Vf6ZL3B1LOPehDhVBwdfllOnKbyZFVDNri7mTpn3gZzmiD7MhMf+QWZJ1CDkQOLk ZcZ+5hPQcPXEXPCyZ3pf/OYBm0hVzQDYG6NBelDkHjSGQlKan2lzwtRXrE6/PQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gl7WK6DYBzfGR for ; Tue, 23 Jun 2026 14:59:09 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 1d442 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Tue, 23 Jun 2026 14:59:09 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Cc: Alfredo Cruz From: Benedict Reuschling Subject: git: 9dfeda70dd - main - handbook/jails: Small fixes to the Linux jail section 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 List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9dfeda70dd59b61f43455b76afed50a6d52d9ced Auto-Submitted: auto-generated Date: Tue, 23 Jun 2026 14:59:09 +0000 Message-Id: <6a3a9f3d.1d442.4734390d@gitrepo.freebsd.org> The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=9dfeda70dd59b61f43455b76afed50a6d52d9ced commit 9dfeda70dd59b61f43455b76afed50a6d52d9ced Author: Alfredo Cruz AuthorDate: 2026-06-23 14:48:30 +0000 Commit: Benedict Reuschling CommitDate: 2026-06-23 14:58:56 +0000 handbook/jails: Small fixes to the Linux jail section - Add missing containers/ path in one instance - Move the jail.conf creation to the beginning of this section (slightly modified from the original patch), because it fits better there instead of letting the reader know about it when starting the jail - Use sh as the shell executed when running jexec to ensure it is a jail that is present in Linux - Rephrase a sentence to avoid a comma and instead use "and" to connect the two packages to install (also modified from the original submission) Event: Halifax Hackathon 202606 PR: 295777 Differential Revision: https://reviews.freebsd.org/D57771 --- documentation/content/en/books/handbook/jails/_index.adoc | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc index f3e6eef17f..49f38720b2 100644 --- a/documentation/content/en/books/handbook/jails/_index.adoc +++ b/documentation/content/en/books/handbook/jails/_index.adoc @@ -818,6 +818,13 @@ The next step will be to create a jail as indicated above, for example in crossref:jails[creating-thin-jail-openzfs-snapshots, Creating a Thin Jail Using OpenZFS Snapshots], but *without* performing the configuration. FreeBSD Linux jails require a specific configuration that will be detailed below. +Create an empty [.filename]#/etc/jail.conf# to prevent failures when trying to stop the jail: + +[source,shell] +.... +# touch /etc/jail.conf +.... + Once the jail has been created as explained above, execute the following command to perform required configuration for the jail and start it: [source,shell] @@ -825,7 +832,7 @@ Once the jail has been created as explained above, execute the following command # jail -cm \ name=ubuntu \ host.hostname="ubuntu.example.com" \ - path="/usr/local/jails/ubuntu" \ + path="/usr/local/jails/containers/ubuntu" \ interface="em0" \ ip4.addr="192.168.1.150" \ exec.start="/bin/sh /etc/rc" \ @@ -848,10 +855,10 @@ Execute the following command to access the FreeBSD Linux jail: [source,shell] .... -# jexec -u root ubuntu +# jexec -u root ubuntu sh .... -Inside the jail, execute the following commands to install package:sysutils/debootstrap[] and prepare the Ubuntu environment: +Inside the jail, execute the following commands to install man:pkg[7] and package:sysutils/debootstrap[] to prepare the Ubuntu environment: [source,shell] ....