Bug 206300 - /boot/defaults/loader.conf nextboot_enable should have a doc comment
Summary: /boot/defaults/loader.conf nextboot_enable should have a doc comment
Status: New
Alias: None
Product: Base System
Classification: Unclassified
Component: conf (show other bugs)
Version: 10.2-STABLE
Hardware: i386 Any
: --- Affects Some People
Assignee: freebsd-bugs mailing list
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-01-15 23:21 UTC by Joel Ray Holveck
Modified: 2016-10-25 08:52 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Joel Ray Holveck 2016-01-15 23:21:07 UTC
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