Bug 200803 - Change instructions in Jail(8) to use prebuilt distfiles to build a jail
Summary: Change instructions in Jail(8) to use prebuilt distfiles to build a jail
Status: In Progress
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Alexander Ziaee
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-06-12 02:06 UTC by Sevan Janiyan
Modified: 2025-11-14 02:35 UTC (History)
4 users (show)

See Also:


Attachments
handbook (877 bytes, patch)
2015-06-12 02:06 UTC, Sevan Janiyan
no flags Details | Diff
jail(8) (1.79 KB, patch)
2015-06-12 02:08 UTC, Sevan Janiyan
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Sevan Janiyan 2015-06-12 02:06:29 UTC
Created attachment 157659 [details]
handbook

Instead of walking the reader through a time-consuming process of building world with a specific destination directory, instruct them to extract the prebuilt base archive from install media.

In the jail section of the Handbook, do not reference jail(8) as the place where instructions on building from source are from
Comment 1 Sevan Janiyan 2015-06-12 02:08:00 UTC
Created attachment 157660 [details]
jail(8)
Comment 2 Wout Decré 2015-06-15 21:05:30 UTC
(In reply to Sevan Janiyan from comment #1)
Personally, I would like to have the build instructions to be available inside the jail(8) page as well.

The proposed patch uses $DESTDIR when extracting to the jail dir, but this should be $D.
Comment 3 Sevan Janiyan 2015-07-13 02:46:03 UTC
(In reply to wout from comment #2)
Worth mentioning that you just need to use the canonical build method with DESTDIR defined?
Will update diff to fix mistake with variable names
Comment 4 Allan Jude freebsd_committer freebsd_triage 2015-07-13 03:39:36 UTC
the handbook already covers how to do it with the distfiles:

https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/jails-build.html

When using FreeBSD 9.x and newer:

# for sets in BASE PORTS; do tar -xf /mnt/FREEBSD_INSTALL/USR/FREEBSD_DIST/$sets.TXZ -C $DESTDIR ; done
Comment 5 Sevan Janiyan 2015-07-13 12:40:18 UTC
(In reply to Allan Jude from comment #4)
Indeed, but that's the fruits from the 2014 doc sprint at BSDCan.
Comment 6 Wout Decré 2016-09-29 09:05:25 UTC
I always appreciate "close to src" instructions.

Future/binary wise, I guess having instructions to do this with pkg would be nice :)
Comment 7 Pau Amma 2022-04-11 05:39:30 UTC
(In reply to Sevan Janiyan from comment #5)

Do you still intend/have time to work on this? (If still relevant.)
Comment 8 Pau Amma 2022-05-17 22:24:10 UTC
(In reply to Sevan Janiyan from comment #5)
Changing component and marking doc patch obsolete since only the manual page is involved now. Feel free to undo if I'm wrong.
Comment 9 Mark Linimon freebsd_committer freebsd_triage 2024-01-05 03:47:52 UTC
^Triage: commit bit was taken in for safekeeping.
Comment 10 commit-hook freebsd_committer freebsd_triage 2025-11-07 18:39:54 UTC
A commit in branch main references this bug:

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

commit d59903481dbaef9ef7e91ea4945d2355ae17c53a
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-07 18:38:54 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-11-07 18:38:59 +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

 usr.sbin/jail/jail.8 | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)
Comment 11 commit-hook freebsd_committer freebsd_triage 2025-11-14 00:16:03 UTC
A commit in branch stable/15 references this bug:

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

commit 5d7cd576d99b99f460263d93929828d584d8f80c
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-07 18:38:54 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-11-14 00:10:14 +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(-)
Comment 12 commit-hook freebsd_committer freebsd_triage 2025-11-14 02:35:29 UTC
A commit in branch releng/15.0 references this bug:

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

commit 16d599da7bfad78894844d1eea164c5ba0ef9f4a
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-07 18:38:54 +0000
Commit:     Colin Percival <cperciva@FreeBSD.org>
CommitDate: 2025-11-14 02:34:41 +0000

    jail.8: Add creating a jail from distribution set

    Approved by:    re (cperciva)
    PR:                     200803
    MFC after:              3 days
    Reviewed by:            jamie
    Differential Revision:  https://reviews.freebsd.org/D53631

    (cherry picked from commit d59903481dbaef9ef7e91ea4945d2355ae17c53a)
    (cherry picked from commit 5d7cd576d99b99f460263d93929828d584d8f80c)

 usr.sbin/jail/jail.8 | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)