[Bug 206300] /boot/defaults/loader.conf nextboot_enable should have a doc comment

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=206300

            Bug ID: 206300
           Summary: /boot/defaults/loader.conf nextboot_enable should have
                    a doc comment
           Product: Base System
           Version: 10.2-STABLE
          Hardware: i386
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: conf
          Assignee: freebsd-bugs at FreeBSD.org
          Reporter: joelh at piquan.org
                CC: freebsd-i386 at FreeBSD.org
                CC: freebsd-i386 at FreeBSD.org

In /boot/defaults/loader.conf, there is an option nextboot_enable="NO".  From
this name, I thought that this would need to be enabled for the nextboot(8)
command to work.

In actuality, it needs to be "NO" under normal circumstances, and is changed to
"YES" by nextboot(8).  Turning it on when nextboot.conf isn't written used to
be harmless, but after some recent loader.4th changes, it now causes the
bootloader to get a stack underflow and fail.

It would be useful to add a comment to /boot/defaults/loader.conf describing
the variable's correct use.  For instance:

# Temporarily set to "YES" by nextboot(8) in nextboot_conf to request special
processing

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