X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;ds=sidebyside;f=index.html;h=c5f243ea59ab84a3c12fcef4ad37c173ac08a2bd;hb=b51dd7b9ac7376b4d3c5a279eefd7429c21878b9;hp=ccc8b2734169428919b7d911271078a954dadf3c;hpb=8025c1bbe25c79fc7d940db4df042db019222d5e;p=debian-kernel-talk.git
diff --git a/index.html b/index.html
index ccc8b27..c5f243e 100644
--- a/index.html
+++ b/index.html
@@ -298,19 +298,110 @@
-
Custom Linux kernel packages
+
Custom Linux kernel builds
+
+ The official packages work for most users, but not all:
+
+
+ -
+ Different ARM platforms need incompatible configurations,
+ and we cannot build them all
+
+ -
+ New features are not enabled immediately if we are worried
+ about potential regressions
+
+
+
+ Using either upstream source or Debian linux-source package:
+
+
+ -
+ make && make install
+
+ -
+ make deb-pkg - build packages
+
+ -
+ make-kpkg - build packages with more customisation;
+ requires kernel-package
+
+
Out-of-tree modules
+
+ The kernel team does not encourage the use of out-of-tree modules.
+ However, we support them by providing development packages and by
+ avoiding ABI changes during a stable release.
+
+
+ Debian has two packages to aid in building out-of-tree modules:
+
+
+ -
+ dkms - builds and installs modules automatically. Can
+ build packages for installation on other systems. Also
+ supported by Ubuntu and SUSE.
+
+ -
+ module-assistant - builds packages as directed.
+ Uses a separate package name for each kernel ABI.
+
+
Firmware files
+
+ -
+ Most peripherals have microcontroller running non-free
+ firmware; some require host to load it
+
+ -
+ Several drivers used to include firmware, making kernel
+ non-free. Fudged with GRs for a while; finally fixed in squeeze
+
+ -
+ Users with these devices - almost any wifi card, some network
+ controllers and Radeon GPUs - will still need the firmware
+ files installed
+
+ -
+ Kernel team maintains firmware-nonfree source package
+ covering most firmware files that are clearly redistributable
+
+ -
+ Also collected in linux-firmware.git repository maintained by
+ David Woodhouse and myself
+
+
Documentation
+
+ -
+ manpages-dev - the system call API
+
+ -
+ linux-doc-upstream - miscellaneous upstream
+ documentation
+
+ -
+ linux-manual-upstream - the internal API,
+ based on structured comments
+
+ -
+ debian-kernel-handbook - Debian-specific information;
+ currently also Linux-specific but could cover other kernels
+
+ -
+ http://wiki.debian.org/DebianKernel
+ - wiki index page
+
+