broken instructions for buildkernel

Tony Hain tony at hain-global-consulting.com
Wed Jun 19 23:51:08 UTC 2013


The steps in
http://www.freebsd.org/doc/en/books/handbook/kernelconfig-building.html
are simply broken/incomplete. This sequence goes straight from 'get the src'
to 'make buildkernel'. Doing that to build 10-current on a 9.1 fresh install
results in "no previous prototype for yyparse". Searching for that error
string shows it has been a recurring problem; & returns comments like   :::
"you must do make buildworld first" :::
If buildworld is a prereq, why isn't that in the instruction sequence? Even
if it is only required once, on a fresh install it should be possible to
look at the FreeBSD docs and build a custom kernel without hitting errors
and having to search for hints. 

On a separate but related note: the instruction to 'cp GENERIC
/root/kernels/MYKERNEL' seems
pointless/dated/waste-of-disk-space/likely-to-result-in-confusion-over-time.
Direct editing of the entirety of a copy of GENERIC makes it harder to
figure out what changes were made specifically for local functions later
when GENERIC might have changed in an update. In searching for Hyper-V
related builds I stumbled across the mechanism of using 'include' to pull in
a current GENERIC, then isolate all local changes in the system specific
file. It seems like this would be a better example to be using for the main
doc. Something like

# FreeBSD kernel conf local customizations
#                edits to this file allow the GENERIC file to remain
untouched
#
include		/usr/src/sys/PLATFORM/conf/GENERIC

# target kernel name
ident		MYKERNEL

# GENERIC has debug symbols set 
makeopts	MODULES_OVERRIDE=""

# PPS support enable
options		PPS_SYNC



Tony




More information about the freebsd-doc mailing list