linux/debian
Maximilian Attems a187104de6 unify token ring variable settings to toplevel config,
also enable newly added 3c359 and smctr.
sparc and hppa explicitly disable tokenring are they lazy?!
(more understable on some arm and mips configs)

svn path=/dists/trunk/linux-2.6/; revision=8719
2007-05-22 15:22:31 +00:00
..
arch unify token ring variable settings to toplevel config, 2007-05-22 15:22:31 +00:00
bin Merge /dists/sid/linux-2.6. 2007-04-24 07:01:08 +00:00
lib/python/debian_linux debian/lib/python/debian_linux/config.py: 2007-05-18 15:55:01 +00:00
modules * debian/changelog: Update. 2007-04-01 11:14:09 +00:00
patches fix includes 2007-05-22 12:03:43 +00:00
templates bugscript: put header on it's on own line, 2007-05-21 20:54:58 +00:00
README * Set compiler build dependencies from config informations. 2006-01-06 22:32:16 +00:00
README.Debian * Add a "Scope of security support" section to README.Debian, recommended 2006-11-13 07:45:45 +00:00
README.build Merge /dists/sid/linux-2.6. 2006-03-21 22:48:04 +00:00
changelog unify token ring variable settings to toplevel config, 2007-05-22 15:22:31 +00:00
compat Initial commit of common kernel-image infrastructure. 2005-05-10 04:16:53 +00:00
copyright debian/copyright: Update FSF address. 2005-09-14 09:41:50 +00:00
rules debian/rules: Ignore changelog changes for binnmus. 2007-03-08 23:18:38 +00:00
rules.defs * Use generated rules, effectively remove second flavour resolver. 2005-08-14 19:59:43 +00:00
rules.real * debian/changelog: Update. 2007-05-18 12:46:35 +00:00

README

Migrating to the common kernel-image package
-------------------------------------------- 
Files for architecture <arch> should be placed into arch/<arch>. This
directory normally contains a common config file for this architecture
('config'), flavour-specific config files, Makefile.inc file,
controlling the build for this arch, and the defines file, containing
the machine descriptions for various flavours.  For arches with
subarches the subdirectory arch/<arch>/<subarch> with the same file
structure must be created for each subarch.

Kernel config files
-------------------
Configuration files are constructed dynamically by concatenating a number
of config files as described below. 

For architecture without subarches:

  arch/config
  arch/<arch>/config 
  arch/<arch>/config.<flavour>
  
For architecture with subarches:

  arch/config
  arch/<arch>/config
  arch/<arch>/<subarch>/config
  arch/<arch>/<subarch>/config.<flavour>

Control file
------------
The master control file debian/control must be generated before
the package is uploaded. debian/rules contains the debian/control 
target, which generates the control file by invoking the 
debian/bin/gencontrol.py script, which combines the templates from
the templates directory and arch/subarch specific defines file to
produce the debian/control file. Note that this target is intentionally
made to fail with a non-zero exit code to make sure that it is never
run during an automatic build. The following variables are substituted
into the templates:

@version@      Upstream kernel version, for example 2.6.11.
@major@        The major version, for example 2.6
@arch@         The Debian arch name, such as powerpc or i386.
@subarch@      The subarch - only used by powerpc right now.
@flavour@      The build flavour, such as 686 or k7-smp.
@class@        The CPU/architecture class; displayed in synopsis.  It should
               be fairly short, as the synopsis is supposed to be <80 chars.
               It should be in the form "foo class", and will show up in the
	       description as "foo class machines".
@longclass@    The CPU/architecture class; displayed in the extended
               description.  The same rules apply as in @class@.  If
	       this is unset, it will default to @class@.
@desc@         (Potentially) multi-line verbiage that's appended to
               -image descriptions.
@abiname@      Current abiname, a single digit.

Normally, the arch-specific contents should be controlled by
adjusting the corresponding defines file.

Makefile.inc
------------
Each architecture subdirectory in arch may contain a Makefile.inc
file, which is included by debian/rules after definining all the
variables. It may be used to override the standard variables on
per-architecture basis and other evil things. So far the valid uses of
this file include the setting of the following variables:

image_postproc

  A command to be run after the kernel image is built. As far as I know,
  it only required on sparc for stripping of the kernel which is too big
  to be booted otherwise. Typical use is too ugly to be presented here.