[Bug 288535] jail_list variable not mentioned in Jails section of Handbook

From: <bugzilla-noreply_at_freebsd.org>
Date: Tue, 29 Jul 2025 13:22:26 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=288535

            Bug ID: 288535
           Summary: jail_list variable not mentioned in Jails section of
                    Handbook
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: jsmith@resonatingmedia.com

The Handbook second on jails
(https://docs.freebsd.org/en/books/handbook/jails/) mentions that to enable
automatic start-up of jails, the user should run

      sysrc jail_enable="YES"
      sysrc jail_parallel_start="YES"

(Or put the equivalent variables in /etc/rc.conf)

The Handbook omits that for jails to be started the jail_list variable also
needs to be set. Which could be an empty string (in FreeBSD 14.x), but which
needs to explicitly list all jail names when running FreeBSD 13.x. There should
be a comment added to the Handbook to indicate the jail_list variable needs to
be set to automate starting jails.

-- 
You are receiving this mail because:
You are the assignee for the bug.