FreeBSD Handbook chapter 15.4 (Creating and Controlling Jails).
Since FreeBSD 9.1 the /etc/jail.conf file is the recommended way to configure jails. The Handbook does not mention this in it's present form.
Fix: Patch attached with submission follows:
For bugs matching the following criteria:
Status: In Progress Changed: (is less than) 2014-06-01
Reset to default assignee and clear in-progress tags.
Mail being skipped
Thank you for your submission, and I apologize that nobody has looked at this in four years. I encountered this just now, and will see that this gets in.
I've posted a change based on your patch at https://reviews.freebsd.org/D14524. Given that all supported FreeBSD releases now use jail.conf I think we should just remove documentation of the old configuration.
(In reply to Ed Maste from comment #2)
No worries. I'm just glad if it makes it into the handbook, and that it is helpful.
I also think removing all the old configuration documentation is the best solution. To this all the ezjail documentation should also be removed because ezjail uses the rc.conf configuration.
Documenting how to use a port does not belong in the handbook, it belongs in the port's manual. This had been the original policy of the handbook, but as younger personal replaced the original handbook administration this policy was violated with the addition of the ezjail section.
A second issue is that readers of the jail section of the handbook see the ezjail section and believe that tool is the recommended tool to use just because its in the handbook. This is unfair to the other jail tools which use jail.conf.
For inspiration on a new jail section check out the jail-primer port.
A commit references this bug:
Date: Tue Mar 6 12:55:32 UTC 2018
New revision: 51462
Document jail.conf Jail configuration
jail.conf is the preferred method of configuring jails in all supported
FreeBSD versions. Older rc.conf(5) configuration produces a warning.
Update the handbook example to match based on the submission in the PR,
with a few modifications.
Submitted by: Jack-Benny Persson
Reviewed by: bcr, eadler
Approved by: bcr, eadler
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D14524
(In reply to joeb1 from comment #5)
That may be the case but is outside of the scope of this PR, and I'm not a doc committer or understand the history well enough. We should probably have this discussion on the freebsd-jail mailing list instead.