git: cf16565eb929 - stable/14 - jail.8: Add creating a jail from distribution set

The branch stable/14 has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=cf16565eb92924e213fae3fa393ef8b7cb1c3dd7

commit cf16565eb92924e213fae3fa393ef8b7cb1c3dd7
Author:     Alexander Ziaee <[email protected]>
AuthorDate: 2025-11-07 18:38:54 +0000
Commit:     Alexander Ziaee <[email protected]>
CommitDate: 2026-08-06 22:15:03 +0000

    jail.8: Add creating a jail from distribution set
    
    PR:                     200803
    MFC after:              3 days
    Reviewed by:            jamie
    Differential Revision:  https://reviews.freebsd.org/D53631
    
    (cherry picked from commit d59903481dbaef9ef7e91ea4945d2355ae17c53a)
---
 usr.sbin/jail/jail.8 | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/usr.sbin/jail/jail.8 b/usr.sbin/jail/jail.8
index 6d3b071496bf..4c7db4d9dd4f 100644
--- a/usr.sbin/jail/jail.8
+++ b/usr.sbin/jail/jail.8
@@ -1,3 +1,6 @@
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2000, 2003 Robert N. M. Watson
 .\" Copyright (c) 2008-2012 James Gritton
 .\" All rights reserved.
@@ -23,7 +26,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd August 7, 2025
+.Dd November 6, 2025
 .Dt JAIL 8
 .Os
 .Sh NAME
@@ -1062,7 +1065,7 @@ process.
 This manual page documents the configuration steps necessary to support
 either of these steps, although the configuration steps may need to be
 refined based on local requirements.
-.Ss "Setting up a Jail Directory Tree"
+.Ss Setting up a Jail Directory Tree From Source
 To set up a jail directory tree containing an entire
 .Fx
 distribution, the following
@@ -1075,8 +1078,19 @@ mkdir -p $D
 make world DESTDIR=$D
 make distribution DESTDIR=$D
 .Ed
+.Ss Setting up a Jail Directory Tree from Distribution Files
+To set up a jail directory tree containing an entire
+.Fx
+distribution, the following
+.Xr sh 1
+command script can be used:
+.Bd -literal -offset indent
+D=/here/is/the/jail
+mkdir -p $D
+tar -xf /usr/freebsd-dist/base.txz -C $D --unlink
+.Ed
 .Pp
-In many cases this example would put far more in the jail than needed.
+In many cases these examples would put far more in the jail than needed.
 In the other extreme case a jail might contain only one file:
 the executable to be run in the jail.
 .Pp