Page MenuHomeFreeBSD

Correct instructions for extracting multiple sets to create a jail
ClosedPublic

Authored by emaste on Feb 26 2018, 2:13 PM.

Details

Summary

It looks like the discrepancy (in upper/lowercase, at least) between the base-only case and the multiple-sets case has existed since this was introduced in 2014. The base-only command has been updated to correct paths and typos. The multiple set command has been updated with the removal of certain sets (e.g. games), but the incorrect path and case has remained all along.

Fix the path and case, and also drop <replaceable> from around sets, which is a variable name not replaceable text.

Diff Detail

Repository
rD FreeBSD doc repository
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

emaste created this revision.Feb 26 2018, 2:13 PM

We should probably put 'doc' back in the list, there's no fundamental reason docs shouldn't be installed in a jail, perhaps a follow-up after further investigation.

gjb added inline comments.Feb 26 2018, 3:06 PM
en_US.ISO8859-1/books/handbook/jails/chapter.xml
230 ↗(On Diff #39744)

Should there be mention of the lib32 set as well?

Possibly, but it won't exist on all architectures, and there's also the tests dist, so this needs further work. My first goal here is just to correct the command that AFAICT has been incorrect since it was added 4 years ago.

gjb accepted this revision.Feb 26 2018, 3:56 PM

Fair enough.

This revision is now accepted and ready to land.Feb 26 2018, 3:56 PM
This revision was automatically updated to reflect the committed changes.

We should probably put 'doc' back in the list, there's no fundamental reason docs shouldn't be installed in a jail, perhaps a follow-up after further investigation.

doc.txz is the /usr/share/doc/papers stuff, not actual documentation for the base system. I don't think it serves any purpose, especially in a jail.

doc.txz is the /usr/share/doc/papers stuff, not actual documentation for the base system. I don't think it serves any purpose, especially in a jail.

I don't think it's fair to claim that any part of the system necessarily has less relevance in a jail - the user may want a jail that's completely representative of a released version (e.g., a reference jail). I wasn't aware that's what doc.txz is and I'll grant you it probably has little value in or out of a jail.

The "everything except the kernel" text is incorrect though, it should perhaps just become something like "a more complete system", and we can make reference to the other optional components perhaps. This is why I wanted to just commit the case/path fix first.