← Back to branch summary

~ubuntu-branches/ubuntu/quantal/linux-lowlatency/quantal

« back to all changes in this revision

Viewing changes to debian/docs/README.inclusion-list

  • Committer: Package Import Robot
  • Author(s): Alessio Igor Bogani
  • Date: 2011-10-26 11:13:05 UTC
  • Revision ID: package-import@ubuntu.com-20111026111305-04kado7d1u2er2rl
Tags: 3.2.0-16.25
Add new lowlatency kernel flavour

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/docs/README.inclusion-list
 
1
This README describes the reason for, and the use of, module
 
2
inclusion lists.
 
3
 
 
4
The original Hardy release had the notion of sub-flavours,
 
5
e.g., a flavour that was constructed as a subset of an existing flavour.
 
6
For example, the virtual flavour was extracted from the server flavour using
 
7
a subset of the server flavour modules. However, there were some difficult
 
8
mainteneance issues with regard to packaging, make rules, and scripts. This
 
9
re-implementation of the sub-flavours philosophy is hopefully simpler,
 
10
and retrofitable to all releases.
 
11
 
 
12
A module inclusion list looks at the problem of of constructing a package
 
13
from the perspective of what modules do we _want_ in the package, as opposed
 
14
to what modules we _don't_ want. As the kernel matures, more and more devices are added
 
15
which makes the problem of configuration maintenance a real pain in the ass.
 
16
If we took the approach of disabling all of the config options that we don't want,
 
17
then the differences between flavours will quickly become quite large, making
 
18
it difficult to quickly compare the individual flavour configs.  Each time a
 
19
new config option is added then we also have to make a decision about disabling in
 
20
order to continue to keep the minimal number of modules.
 
21
 
 
22
A module inclusion list is applied on a per-flavour basis. For example,
 
23
debian.<BRANCH>/control.d/${flavour}.inclusion-list. For example, the
 
24
config for virtual is very close to server and generic, but the inclusion list
 
25
causes the virtual package to be constructed with _only_ the modules described 
 
26
in the inclusion list.
 
27
 
 
28
The inclusion list format is a simple bash regular expression list of files. For example,
 
29
 
 
30
arch/*/{crypto,kernel,oprofile}
 
31
drivers/acpi/*
 
32
drivers/ata/ahci.ko
 
33
 
 
34
These 3 regular expression forms are suitable for expansion by bash and as inputs to 'find'.
 
35
See debian/scripts/module-inclusion for details.
 
36
 
 
37
There are 2 log files created as a side effect of the application of the module
 
38
inclusion list; $(flavour).inclusion-list.log and $(flavour).depmod.log.
 
39
 
 
40
$(flavour).inclusion-list.log : This log is created while the inclusion list
 
41
modules are being copied. If any are missing, then those warnings go in this log.
 
42
While its not considered a fatal error, you should endevour to correct your inclusion
 
43
list such that there are no missing modules.
 
44
 
 
45
$(flavour).depmod.log : The log is created as a result of running depmod on the
 
46
resulting set of modules. If there are missing symbols then you'll find that information
 
47
here. Again, you should modify your inclusion list such that there are no missing
 
48
symbols.
 
49
 
 
50
Tim Gardner <tim.gardner@canonical.com>
 
51
June 2, 2010