83 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			83 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
 | 
						|
		Kernel package tips & tricks.
 | 
						|
		~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 | 
						|
 | 
						|
The kernel is one of the more complicated packages in the distro, and
 | 
						|
for the newcomer, some of the voodoo in the spec file can be somewhat scary.
 | 
						|
This file attempts to document some of the magic.
 | 
						|
 | 
						|
 | 
						|
Speeding up make prep
 | 
						|
---------------------
 | 
						|
The kernel is nearly 500MB of source code, and as such, 'make prep'
 | 
						|
takes a while. The spec file employs some trickery so that repeated
 | 
						|
invocations of make prep don't take as long.  Ordinarily the %prep
 | 
						|
phase of a package will delete the tree it is about to untar/patch.
 | 
						|
The kernel %prep keeps around an unpatched version of the tree,
 | 
						|
and makes a symlink tree clone of that clean tree and than applies
 | 
						|
the patches listed in the spec to the symlink tree.
 | 
						|
This makes a huge difference if you're doing multiple make preps a day.
 | 
						|
As an added bonus, doing a diff between the clean tree and the symlink
 | 
						|
tree is slightly faster than it would be doing two proper copies of the tree.
 | 
						|
 | 
						|
 | 
						|
build logs.
 | 
						|
-----------
 | 
						|
There's a convenience helper script in scripts/grab-logs.sh
 | 
						|
that will grab the build logs from koji for the kernel version reported
 | 
						|
by make verrel
 | 
						|
 | 
						|
 | 
						|
config heirarchy.
 | 
						|
-----------------
 | 
						|
Instead of having to maintain a config file for every arch variant we build on,
 | 
						|
the kernel spec uses a nested system of configs.  At the top level, is
 | 
						|
config-generic. Add options here that should be present in every possible
 | 
						|
config on all architectures.
 | 
						|
 | 
						|
Beneath this are per-arch overrides. For example config-x86-generic add
 | 
						|
additional x86 specific options, and also _override_ any options that were
 | 
						|
set in config-generic.
 | 
						|
 | 
						|
The heirarchy looks like this..
 | 
						|
 | 
						|
                           config-generic
 | 
						|
                                 |
 | 
						|
                         config-x86-generic
 | 
						|
                         |                |
 | 
						|
             config-x86-32-generic   config-x86-64-generic
 | 
						|
 | 
						|
An option set in a lower level will override the same option set in one
 | 
						|
of the higher levels.
 | 
						|
 | 
						|
 | 
						|
There exist two additional overrides, config-debug, and config-nodebug,
 | 
						|
which override -generic, and the per-arch overrides. It is documented
 | 
						|
further below.
 | 
						|
 | 
						|
 | 
						|
debug options.
 | 
						|
--------------
 | 
						|
This is a little complicated, as the purpose & meaning of this changes
 | 
						|
depending on where we are in the release cycle.
 | 
						|
If we are building for a current stable release, 'make release' has
 | 
						|
typically been run already, which sets up the following..
 | 
						|
- Two builds occur, a 'kernel' and a 'kernel-debug' flavor.
 | 
						|
- kernel-debug will get various heavyweight debugging options like
 | 
						|
  lockdep etc turned on.
 | 
						|
 | 
						|
If we are building for rawhide, 'make debug' has been run, which changes
 | 
						|
the status quo to:
 | 
						|
- We only build one kernel 'kernel'
 | 
						|
- The debug options from 'config-debug' are always turned on.
 | 
						|
This is done to increase coverage testing, as not many people actually
 | 
						|
run kernel-debug.
 | 
						|
 | 
						|
To add new debug options, add an option to _both_ config-debug and config-nodebug,
 | 
						|
and also new stanzas to the Makefile 'debug' and 'release' targets.
 | 
						|
 | 
						|
Sometimes debug options get added to config-generic, or per-arch overrides
 | 
						|
instead of config-[no]debug. In this instance, the options should have no
 | 
						|
discernable performance impact, otherwise they belong in the debug files.
 | 
						|
 |