Diff for /wikisrc/guide/kernel.mdwn between versions 1.4 and 1.5

version 1.4, 2013/04/23 00:15:00 version 1.5, 2015/06/19 19:18:31
Line 98  The easiest way to create a new file is  Line 98  The easiest way to create a new file is 
 Usually the best choice on most platforms is the GENERIC configuration, as it  Usually the best choice on most platforms is the GENERIC configuration, as it
 contains most drivers and options. In the configuration file there are comments  contains most drivers and options. In the configuration file there are comments
 describing the options; a more detailed description is found in the  describing the options; a more detailed description is found in the
 [options(4)](http://netbsd.gw.com/cgi-bin/man-cgi?options+4+NetBSD-5.0.1+i386)  [[!template id=man name="options" section="4"]]
 man page. So, the usual procedure is:  man page. So, the usual procedure is:
   
     $ cp GENERIC MYKERNEL      $ cp GENERIC MYKERNEL
Line 117  and enabled by removing the comment char Line 117  and enabled by removing the comment char
 instead of deleting them; it is always possible uncomment them later.  instead of deleting them; it is always possible uncomment them later.
   
 The output of the  The output of the
 [dmesg(8)](http://netbsd.gw.com/cgi-bin/man-cgi?dmesg+8+NetBSD-5.0.1+i386)  [[!template id=man name="dmesg" section="8"]]
 command can be used to determine which lines can be disabled. For each line of  command can be used to determine which lines can be disabled. For each line of
 the type:  the type:
   
Line 131  You should also examine the options in t Line 131  You should also examine the options in t
 ones that you don't need. Each option has a short comment describing it, which  ones that you don't need. Each option has a short comment describing it, which
 is normally sufficient to understand what the option does. Many options have a  is normally sufficient to understand what the option does. Many options have a
 longer and more detailed description in the  longer and more detailed description in the
 [options(4)](http://netbsd.gw.com/cgi-bin/man-cgi?options+4+NetBSD-5.0.1+i386)  [[!template id=man name="options" section="4"]]
 man page. While you are at it you should set correctly the options for local  man page. While you are at it you should set correctly the options for local
 time on the CMOS clock. For example:  time on the CMOS clock. For example:
   
Line 162  When you've finished modifying the kerne Line 162  When you've finished modifying the kerne
     $ config MYKERNEL      $ config MYKERNEL
   
 If `MYKERNEL` contains no errors, the  If `MYKERNEL` contains no errors, the
 [config(1)](http://netbsd.gw.com/cgi-bin/man-cgi?config+1+NetBSD-5.0.1+i386)  [[!template id=man name="config" section="1"]]
 program will create the necessary files for the compilation of the kernel,  program will create the necessary files for the compilation of the kernel,
 otherwise it will be necessary to correct the errors before running  otherwise it will be necessary to correct the errors before running
 [config(1)](http://netbsd.gw.com/cgi-bin/man-cgi?config+1+NetBSD-5.0.1+i386)  [[!template id=man name="config" section="1"]]
 again.  again.
   
 ### Notes for crosscompilings  ### Notes for crosscompilings
   
 As the  As the
 [config(1)](http://netbsd.gw.com/cgi-bin/man-cgi?config+1+NetBSD-5.0.1+i386)  [[!template id=man name="config" section="1"]]
 program used to create header files and Makefile for a kernel build is platform  program used to create header files and Makefile for a kernel build is platform
 specific, it is necessary to use the `nbconfig` program that's part of a newly  specific, it is necessary to use the `nbconfig` program that's part of a newly
 created toolchain (created for example with  created toolchain (created for example with
Line 200  commands: Line 200  commands:
 It can happen that the compilation stops with errors; there can be a variety of  It can happen that the compilation stops with errors; there can be a variety of
 reasons but the most common cause is an error in the configuration file which  reasons but the most common cause is an error in the configuration file which
 didn't get caught by  didn't get caught by
 [config(1)](http://netbsd.gw.com/cgi-bin/man-cgi?config+1+NetBSD-5.0.1+i386).  [[!template id=man name="config" section="1"]].
 Sometimes the failure is caused by a hardware problem (often faulty RAM chips):  Sometimes the failure is caused by a hardware problem (often faulty RAM chips):
 the compilation puts a higher stress on the system than most applications do.  the compilation puts a higher stress on the system than most applications do.
 Another typical error is the following: option B, active, requires option A  Another typical error is the following: option B, active, requires option A
Line 214  directory, ready to be installed. Line 214  directory, ready to be installed.
   
 For crosscompiling a sparc64 kernel, it is necessary to use the crosscompiler  For crosscompiling a sparc64 kernel, it is necessary to use the crosscompiler
 toolchain's `nbmake-sparc64` shell wrapper, which calls  toolchain's `nbmake-sparc64` shell wrapper, which calls
 [make(1)](http://netbsd.gw.com/cgi-bin/man-cgi?make+1+NetBSD-5.0.1+i386) with  [[!template id=man name="make" section="1"]] with
 all the necessary settings for crosscompiling for a sparc64 platform:  all the necessary settings for crosscompiling for a sparc64 platform:
   
     % cd ../compile/MYKERNEL/      % cd ../compile/MYKERNEL/

Removed from v.1.4  
changed lines
  Added in v.1.5


CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb