Date: Thu, 31 Jan 2002 15:12:06 -0500 (EST) From: Tom Rhodes <darklogik@pittgoth.com> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/34499: [PATCH] kernelconfig chapter, cleanup & update Message-ID: <200201312012.g0VKC6v02426@pittgoth.com>
next in thread | raw e-mail | index | archive | help
>Number: 34499
>Category: docs
>Synopsis: [PATCH] kernelconfig chapter, cleanup & update
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Thu Jan 31 12:20:00 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:
>Release: FreeBSD 4.5 i386
>Organization:
>Environment:
System: FreeBSD 4.5
>Description:
This patch does some grammer cleanup, tag cleanup,
adds softupdates to the options, and other minor 'bugs'. This
patch also succeeds in closeing pr: 34137 and pr: 34238 so in
essance, we can apply this patch and close 3 pr's. Thanks!
--Tom Rhodes
>How-To-Repeat:
read the kernel configuration handbook chapter,
read pr: 34137 and pr: 34238 and then review this patch.
>Fix:
apply patch supplied below!
*** chapter.sgml.old Thu Jan 31 11:41:22 2002
--- chapter.sgml Thu Jan 31 13:15:44 2002
***************
*** 162,168 ****
<literal>src</literal>, then <literal>sys</literal>. If you
have an aversion to <application>sysinstall</application> and
you have access to an <quote>official</quote> FreeBSD CDROM, then
! you can also install the source from the command line :</para>
<screen>&prompt.root; <userinput>mount</userinput> /cdrom
&prompt.root; <userinput>mkdir -p</userinput> <filename>/usr/src/sys</filename>
--- 162,168 ----
<literal>src</literal>, then <literal>sys</literal>. If you
have an aversion to <application>sysinstall</application> and
you have access to an <quote>official</quote> FreeBSD CDROM, then
! you can also install the source from the command line:</para>
<screen>&prompt.root; <userinput>mount</userinput> /cdrom
&prompt.root; <userinput>mkdir -p</userinput> <filename>/usr/src/sys</filename>
***************
*** 206,224 ****
<note>
<para>You must execute these and all of the following commands under
! the root account or you will get <errortype>permission
! denied</errortype> errors.</para>
</note>
<para>Now, edit <filename>MYKERNEL</filename> with your favorite text
editor. If you are just starting out, the only editor available
! will probably be <command>vi</command>, which is too complex to
explain here, but is covered well in many books in the <link
linkend="bibliography">bibliography</link>. However, FreeBSD does
! offer an easier editor called <quote>ee</quote> which, if you are a
! beginner, should be your editor of choice. Feel free to change the
! comment lines at the top to reflect your configuration or the
! changes you have made to differentiate it from
<filename>GENERIC</filename>.</para>
<indexterm><primary>SunOS</primary></indexterm>
--- 206,224 ----
<note>
<para>You must execute these and all of the following commands under
! the <username>root</username> account or you will get
! <errortype>permission denied</errortype> errors.</para>
</note>
<para>Now, edit <filename>MYKERNEL</filename> with your favorite text
editor. If you are just starting out, the only editor available
! will probably be <application>vi</application>, which is too complex to
explain here, but is covered well in many books in the <link
linkend="bibliography">bibliography</link>. However, FreeBSD does
! offer an easier editor called <application>ee</application> which, if
! you are a beginner, should be your editor of choice. Feel free to
! change the comment lines at the top to reflect your configuration or
! the changes you have made to differentiate it from
<filename>GENERIC</filename>.</para>
<indexterm><primary>SunOS</primary></indexterm>
***************
*** 256,262 ****
<listitem>
<para>If you are running a FreeBSD version prior to 4.0, and you are
<emphasis>not</emphasis> upgrading to FreeBSD 4.0 or higher using
! the <quote>make world</quote> procedure, use procedure 1.</para>
</listitem>
<listitem>
--- 256,263 ----
<listitem>
<para>If you are running a FreeBSD version prior to 4.0, and you are
<emphasis>not</emphasis> upgrading to FreeBSD 4.0 or higher using
! the <maketarget>make world</maketarget> procedure, use procedure 1.
! </para>
</listitem>
<listitem>
***************
*** 266,273 ****
</listitem>
<listitem>
! <para>If you are rebuilding the kernel as part of a <quote>make
! world</quote> process, use procedure 2.</para>
</listitem>
</itemizedlist>
--- 267,275 ----
</listitem>
<listitem>
! <para>If you are rebuilding the kernel as part of a
! <maketarget>make world</maketarget> process, use procedure 2.
! </para>
</listitem>
</itemizedlist>
***************
*** 305,311 ****
way</title>
<step>
! <para>Change to the <filename>/usr/src</filename> directory</para>
<screen>&prompt.root; <userinput>cd /usr/src</userinput></screen>
</step>
--- 307,313 ----
way</title>
<step>
! <para>Change to the <filename>/usr/src</filename> directory.</para>
<screen>&prompt.root; <userinput>cd /usr/src</userinput></screen>
</step>
***************
*** 327,333 ****
<para>In FreeBSD 4.2 and older you must replace
<literal>KERNCONF=</literal> with <literal>KERNEL=</literal>.
4.2-STABLE that was fetched after Feb 2nd, 2001 does
! recognize <literal>KERNCONF=</literal></para>
</note>
<indexterm>
--- 329,335 ----
<para>In FreeBSD 4.2 and older you must replace
<literal>KERNCONF=</literal> with <literal>KERNEL=</literal>.
4.2-STABLE that was fetched after Feb 2nd, 2001 does
! recognize <literal>KERNCONF=</literal>.</para>
</note>
<indexterm>
***************
*** 344,351 ****
tree in any way (you have not run <application>CVSup</application>,
<application>CTM</application>, or used
<application>anoncvs</application>), then you should use the
! <command>config</command>, <command>make depend</command>,
! <command>make</command>, <command>make install</command> sequence.</para>
<indexterm>
<primary><filename>kernel.old</filename></primary>
--- 346,354 ----
tree in any way (you have not run <application>CVSup</application>,
<application>CTM</application>, or used
<application>anoncvs</application>), then you should use the
! <command>config</command>, <maketarget>make depend</maketarget>,
! <command>make</command>, <maketarget>make install</maketarget> sequence.
! </para>
<indexterm>
<primary><filename>kernel.old</filename></primary>
***************
*** 610,615 ****
--- 613,627 ----
is at a premium and disk access speed is less important, such as a
firewall.</para>
+ <programlisting>options SOFTUPDATES #Enable FFS soft updates support</programlisting>
+
+ <para>This option enables soft updates in the kernel, this will help speed
+ up write access on the disks. They enabled by default in the 4.X branch
+ but may not be turned on. Review the output from &man.mount.8; to see
+ if you have them enabled. If you do not see the soft-updates option then
+ you will need to activate it using the &man.tunefs.8; or &man.newfs.8;
+ for new filesystems.</para>
+
<programlisting>options MFS #Memory Filesystem
options MD_ROOT #MD is a potential root device</programlisting>
***************
*** 737,744 ****
options _KPOSIX_PRIORITY_SCHEDULING</programlisting>
<para>Real-time extensions added in the 1993 POSIX. Certain
! applications in the ports collection use these (such as Star
! Office).</para>
<indexterm>
<primary>kernel options</primary>
--- 749,756 ----
options _KPOSIX_PRIORITY_SCHEDULING</programlisting>
<para>Real-time extensions added in the 1993 POSIX. Certain
! applications in the ports collection use these
! (such as <application>StarOffice</application>).</para>
<indexterm>
<primary>kernel options</primary>
***************
*** 1021,1027 ****
<literal>device miibus</literal> to the kernel config pulls in
support for the generic miibus API and all of the PHY drivers,
including a generic one for PHYs that are not specifically handled
! by an individual driver</para>
<programlisting>device dc # DEC/Intel 21143 and various workalikes
device rl # RealTek 8129/8139
--- 1033,1039 ----
<literal>device miibus</literal> to the kernel config pulls in
support for the generic miibus API and all of the PHY drivers,
including a generic one for PHYs that are not specifically handled
! by an individual driver.</para>
<programlisting>device dc # DEC/Intel 21143 and various workalikes
device rl # RealTek 8129/8139
***************
*** 1303,1315 ****
an excellent mechanism for recovering from incompatible
kernels. Simply choose the kernel you want to boot from at
the FreeBSD boot loader. You can access this when the system
! counts down from 10. Hit any key except for the enter key,
! type <command>unload</command> and then type
! <command>boot
! <replaceable>kernel.old</replaceable></command>, or the
! filename of any other kernel that will boot properly. When
! reconfiguring a kernel, it is always a good idea to keep a
! kernel that is known to work on hand.</para>
<para>After booting with a good kernel you can check over your
configuration file and try to build it again. One helpful
--- 1315,1327 ----
an excellent mechanism for recovering from incompatible
kernels. Simply choose the kernel you want to boot from at
the FreeBSD boot loader. You can access this when the system
! counts down from 10. Hit any key except for the
! <keycap>enter</keycap> key, type <command>unload</command>
! and then type
! <command>boot<replaceable>kernel.old</replaceable></command>,
! or the filename of any other kernel that will boot properly.
! When reconfiguring a kernel, it is always a good idea to keep
! a kernel that is known to work on hand.</para>
<para>After booting with a good kernel you can check over your
configuration file and try to build it again. One helpful
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200201312012.g0VKC6v02426>