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: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Sevan Janiyan
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-06-12 02:06 UTC by Sevan Janiyan
Modified: 2016-10-05 14:54 UTC (History)
2 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 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 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 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 :)