Index: head/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml =================================================================== --- head/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml (revision 51151) +++ head/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml (revision 51152) @@ -1,86 +1,70 @@ Building and Installing a &os; Kernel Being a kernel developer requires understanding of the kernel build process. To debug the &os; kernel it is required to be able to build one. There are two known ways to do so: - - - The Traditional Way - + The supported procedure to build and install a kernel + is documented in the + Building and + Installing a Custom Kernel chapter of the &os; + Handbook. - - The New Way - - - It is supposed that the reader of this chapter is familiar with the information described in the Building and Installing a Custom Kernel chapter of the &os; Handbook. If this is not the case, please read through the above mentioned chapter to understand how the build process works. - Building a Kernel the <quote>Traditional</quote> Way + Building the Faster but Brittle Way - Up to version 4.X of &os; this was the recommended way to - build a new kernel. It can still be used on newer versions - (instead of the buildkernel target of the toplevel - /usr/src/ makefiles). - Building the kernel this way may be useful when working on the + Building the kernel this way may be useful when working on + the kernel code and it may actually be faster than the - New procedure when only a single option or two were - tweaked in the kernel configuration file. On the other hand, it - might lead to unexpected kernel build breakage when used by - beginners on newer versions of &os;. + documented procedure when only a single option or two were + tweaked in the kernel configuration file. On the other hand, + it might lead to unexpected kernel build breakage. Run &man.config.8; to generate the kernel source code: &prompt.root; /usr/sbin/config MYKERNEL Change into the build directory. &man.config.8; will print the name of this directory after being run as above. &prompt.root; cd ../compile/MYKERNEL Compile the kernel: &prompt.root; make depend &prompt.root; make Install the new kernel: &prompt.root; make install - - Building a Kernel the <quote>New</quote> Way - - This procedure is well supported and recommended under the - latest &os; releases and is documented in the Building and - Installing a Custom Kernel chapter of the &os; - Handbook. -