From owner-svn-doc-all@FreeBSD.ORG Wed Mar 19 15:55:03 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 50F97E99; Wed, 19 Mar 2014 15:55:03 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 32762A2F; Wed, 19 Mar 2014 15:55:03 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s2JFt3FG010724; Wed, 19 Mar 2014 15:55:03 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s2JFt3C3010723; Wed, 19 Mar 2014 15:55:03 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201403191555.s2JFt3C3010723@svn.freebsd.org> From: Dru Lavigne Date: Wed, 19 Mar 2014 15:55:03 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44287 - head/en_US.ISO8859-1/books/handbook/kernelconfig X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 19 Mar 2014 15:55:03 -0000 Author: dru Date: Wed Mar 19 15:55:02 2014 New Revision: 44287 URL: http://svnweb.freebsd.org/changeset/doc/44287 Log: Comment out the kernel walk-through as it is out-of-date and architecture specific. Comment out the PAE section as it deals with ancient hardware. Some small editorial fixes. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml Wed Mar 19 14:08:07 2014 (r44286) +++ head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml Wed Mar 19 15:55:02 2014 (r44287) @@ -250,7 +250,7 @@ ath_hal(4) - Atheros Hardw If /usr/src/ does not exist or it is empty, source has not been installed. Source can be installed - using Subversion, which is described + using Subversion and the instructions in . Once source is installed, review the contents of @@ -268,25 +268,13 @@ ath_hal(4) - Atheros Hardw The convention is to use a name with all capital letters. When maintaining multiple &os; machines with different hardware, it is a good idea to name it after the machine's hostname. This - example creates a custom configuration file for the + example creates a copy, named MYKERNEL, of the + GENERIC configuration file for the amd64 architecture: &prompt.root; cd /usr/src/sys/amd64/conf &prompt.root; cp GENERIC MYKERNEL - - When finished customizing the kernel configuration file, - save a backup copy to a location outside of /usr/src. - - Alternately, keep the kernel configuration file elsewhere - and create a symbolic link to the file: - - &prompt.root; cd /usr/src/sys/amd64/conf -&prompt.root; mkdir /root/kernels -&prompt.root; cp GENERIC /root/kernels/MYKERNEL -&prompt.root; ln -s /root/kernels/MYKERNEL - - The configuration file MYKERNEL can now be customized with any ASCII text editor. The default editor is @@ -320,13 +308,26 @@ ath_hal(4) - Atheros Hardw For architecture independent options, refer to /usr/src/sys/conf/NOTES. + + When finished customizing the kernel configuration file, + save a backup copy to a location outside of /usr/src. + + Alternately, keep the kernel configuration file elsewhere + and create a symbolic link to the file: + + &prompt.root; cd /usr/src/sys/amd64/conf +&prompt.root; mkdir /root/kernels +&prompt.root; cp GENERIC /root/kernels/MYKERNEL +&prompt.root; ln -s /root/kernels/MYKERNEL + + An include directive is available for use in configuration files. This allows another configuration file to be included in the current one, making it easy to maintain - small changes relative to an existing file. For example, if + small changes relative to an existing file. If only a small number of additional options or drivers are required, this allows a delta to be maintained with respect - to GENERIC: + to GENERIC, as seen in this example: include GENERIC ident MYKERNEL @@ -351,12 +352,14 @@ options IPDIVERT&prompt.root; cd /usr/src/sys/arch/conf && make LINT - + + +