For 3.x -> 4.x upgrading and 4.x or later kernel builds, mention the

buildkernel/installkernel targets.

Add a note about /usr/src/UPDATING also in this section, since it also
affects kernels and the other entry in the ``make world'' part can be
overlooked if one is only looking for kernel help.
This commit is contained in:
Alexander Langer 2000-07-15 09:38:36 +00:00
parent 7ea95b9737
commit 85e8182fd5
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=7616
2 changed files with 52 additions and 16 deletions

View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/kernelconfig/chapter.sgml,v 1.27 2000/06/12 23:57:35 murray Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/kernelconfig/chapter.sgml,v 1.28 2000/06/14 00:47:35 jim Exp $
-->
<chapter id="kernelconfig">
@ -127,16 +127,26 @@
section slowly and carefully.</para>
<note>
<para>If you are trying to upgrade your kernel from an older version
of FreeBSD, you will probably have to get a new version of
&man.config.8; from the same place you got the new kernel sources.
It is located in <filename>/usr/src/usr.sbin</filename>, so you
will need to download those sources as well. Re-build and install
it before running the next commands.</para>
<para>Be sure to always check the file
<filename>/usr/src/UPDATING</filename>, before you perform any update
steps! In this file all important issues with updating FreeBSD
are written down. <filename>/usr/src/UPDATING</filename> always fits
to your version of the FreeBSD source, and is therefore more accurate
for those information than the handbook.</para>
</note>
<para>When you are finished, type the following to compile and install
your kernel:</para>
your kernel if you are using FreeBSD prior FreeBSD 4.0 and don't
want to upgrade to FreeBSD 4.0 or higher with this step.</para>
<note>
<para>If you are trying to upgrade your kernel from an older version
of FreeBSD, you will probably have to get a new version of
&man.config.8; from the same place you got the new kernel sources.
It is located in <filename>/usr/src/usr.sbin</filename>, so you
will need to download those sources as well. Re-build and install
it before running the next commands.</para>
</note>
<screen>&prompt.root; <userinput>/usr/sbin/config MYKERNEL</userinput>
&prompt.root; <userinput>cd ../../compile/MYKERNEL</userinput>
@ -144,6 +154,14 @@
&prompt.root; <userinput>make</userinput>
&prompt.root; <userinput>make install</userinput></screen>
<para>For FreeBSD 4.x or later (or upgrading from FreeBSD 3.x to
FreeBSD 4.x or higher), use the following commands (be sure you
have built world before!):</para>
<screen>&prompt.root; <userinput>cd /usr/src</userinput>
&prompt.root; <userinput>make buildkernel KERNEL=MYKERNEL</userinput>
&prompt.root; <userinput>make installkernel KERNEL=MYKERNEL</userinput></screen>
<para>The new kernel will be copied to the root directory as
<filename>/kernel</filename> and the old kernel will be moved to
<filename>/kernel.old</filename>. Now, shutdown the system and

View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/kernelconfig/chapter.sgml,v 1.27 2000/06/12 23:57:35 murray Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/kernelconfig/chapter.sgml,v 1.28 2000/06/14 00:47:35 jim Exp $
-->
<chapter id="kernelconfig">
@ -127,16 +127,26 @@
section slowly and carefully.</para>
<note>
<para>If you are trying to upgrade your kernel from an older version
of FreeBSD, you will probably have to get a new version of
&man.config.8; from the same place you got the new kernel sources.
It is located in <filename>/usr/src/usr.sbin</filename>, so you
will need to download those sources as well. Re-build and install
it before running the next commands.</para>
<para>Be sure to always check the file
<filename>/usr/src/UPDATING</filename>, before you perform any update
steps! In this file all important issues with updating FreeBSD
are written down. <filename>/usr/src/UPDATING</filename> always fits
to your version of the FreeBSD source, and is therefore more accurate
for those information than the handbook.</para>
</note>
<para>When you are finished, type the following to compile and install
your kernel:</para>
your kernel if you are using FreeBSD prior FreeBSD 4.0 and don't
want to upgrade to FreeBSD 4.0 or higher with this step.</para>
<note>
<para>If you are trying to upgrade your kernel from an older version
of FreeBSD, you will probably have to get a new version of
&man.config.8; from the same place you got the new kernel sources.
It is located in <filename>/usr/src/usr.sbin</filename>, so you
will need to download those sources as well. Re-build and install
it before running the next commands.</para>
</note>
<screen>&prompt.root; <userinput>/usr/sbin/config MYKERNEL</userinput>
&prompt.root; <userinput>cd ../../compile/MYKERNEL</userinput>
@ -144,6 +154,14 @@
&prompt.root; <userinput>make</userinput>
&prompt.root; <userinput>make install</userinput></screen>
<para>For FreeBSD 4.x or later (or upgrading from FreeBSD 3.x to
FreeBSD 4.x or higher), use the following commands (be sure you
have built world before!):</para>
<screen>&prompt.root; <userinput>cd /usr/src</userinput>
&prompt.root; <userinput>make buildkernel KERNEL=MYKERNEL</userinput>
&prompt.root; <userinput>make installkernel KERNEL=MYKERNEL</userinput></screen>
<para>The new kernel will be copied to the root directory as
<filename>/kernel</filename> and the old kernel will be moved to
<filename>/kernel.old</filename>. Now, shutdown the system and