Optionen

--help

Gibt eine kurze Hilfe zu den Optionen von make-kpkg aus.

--revision number

Setzt die Revisionsnummer des Debian Pakets auf das angegebene Argument.

Diese Option bewirkt nur eine Änderung der Revisionsnummer während der Konfigurationsphase (also wenn die Datei stamp-configure nicht existiert). Es empfiehlt sich, in jedem Fall vor der Benutzung dieser Option make-kpkg clean aufzurufen. Den gleichen Effekt hat das Löschen der Dateien stamp-configure und stamp-debian.

Nach den Informationen im Debian Policy Manual darf die Zeichenkette für die Version ausschließlich aus Zahlen und den Zeichen + und . bestehen und muss mindestens eine Zahl beinhalten. Die offiziellen Debian Pakete mit Kerneln weichen davon ab, diese beinhalten auch das Zeichen -.

Der voreingestellte Wert für diesen Parameter ist 1.00.Custom. Mit der Umgebungsvariablen DEBIAN_REVISION_MANDATORY kann eine Warnung ausgegeben werden, falls die Revisionsnummer weder auf der Kommandozeile noch in der Konfigurationsdatei gesetzt wird.

--append-to-version foo, --append_to_version foo

Das angegebene Argument „foo“ wird an den Wert der Variablen EXTRAVERSION angehängt, die aus den Angaben im Kernel-Makefile generiert wird. Da EXTRAVERSION ein Bestandteil der Kernel-Version ist, wird diese Angabe auch im Namen des Debian Kernel-Pakets erscheinen und muss somit auch den Richtlinien für Paketnamen entsprechen. Das bedeutet, dass ausschließlich Kleinbuchstaben sowie die Zeichen -, + und . erlaubt sind.

Wird diese Option verwendet, so wird die Umgebungsvariable APPEND_TO_VERSION überschrieben. Bei Verwendung dieser Option muss make-kpkg clean nach der Konfiguration des Kernels aufgerufen werden, da hiermit die Datei include/linux/version.h mit den gewünschten Werten erzeugt wird. Ein einfacher Aufruf von make-kpkg würde eine bestehende Datei include/linux/version.h nicht verändern und so dazu führen, dass der Kernel die Module nicht findet, da diese in einem Verzeichnis abgelegt werden, das sich von der im Kernel festgelegten Syntax unterscheidet.

Wird später noch ein Paket mit den Kernel-Modulen erzeugt, so ist dort auch die verwendete Option anzugeben, damit die Module zum Kernel passen.

--flavor foo

Dies ist eine mittlerweile überflüssige Option, die noch aus Gründen der Kompatibilität mitgeführt wird. Zukünftig sollte nur noch --append_to_version benutzt werden.

--added-modules foo, --added_modules foo

Das Argument zu dieser Option ist ein einzelnes Modul oder eine kommaseparierte Liste von Modulen, die nicht im Standard-Kernel enthalten sind. Dabei muss der komplette Pfad zu den Modulen angegeben werden, falls diese nicht im üblichen Pfad liegen (/usr/src/modules, der auch über die Variable MODULE_LOC gesetzt werden kann).

--added-patches foo, --added_patches foo

Das Argument zu dieser Option ist eine kommaseparierte Liste von Patches, die dem Kernel-Quellcode hinzugefügt werden sollen. Die Verwendung dieser Option setzt automatisch auch die Option patch_the_kernel auf YES.

Abweichend zur Behandlung von Modulen ist es bei Patches ausreichend, den Basisnamen des Patches anzugeben. Der volle Pfad ist nicht erforderlich. Für jeden Namen eines Patches in der Liste wird wie folgt nach der passenden Datei gesucht: Wird die Datei in einem der Verzeichnisse ALL_PATCH_DIR/{apply,unpatch}/ gefunden, so wird die Datei ALL_PATCH_DIR/apply/<patch_name> während des Laufs von „configure“ ausgeführt. Passend dazu wird die Datei ALL_PATCH_DIR/unpatch/<patch_name> ausgeführt, wenn ein „clean“ ausgeführt wird.

Voreingestellt ist, dass alle vorhandenen Patches angewendet werden, in dem die ausführbaren Dateien in ALL_PATCH_DIR/apply/ bearbeitet werden. Dies geschieht durch Setzen der Konfigurationsvariablen patch_the_kernel oder der Umgebungsvariablen PATCH_THE_KERNEL auf den Wert YES. Zu beachten ist, dass alle Patches wieder aus dem Quellcode entfernt werden, wenn clean aufgerufen wird. Dieses Verhalten kann verhindert werden, indem die Umgebungsvariable NO_UNPATCH_BY_DEFAULT gesetzt wird.

Für das bisher Beschriebene gilt, dass die Variable ALL_PATCH_DIR auf das Verzeichnis /usr/src/kernel-patches/ verweist.

Wird später make-kpkg clean aufgerufen, so werden alle Patches wieder entfernt. Dies kann durch Setzen der Umgebungsvariablen NO_UNPATCH_BY_DEFAULT verhindert werden.

--arch foo

Setzt die Hardware-Architektur auf den angegebenen Wert. Diese Option wird nur benötigt, wenn der Kernel nicht auf der Zielplattform erzeugt wird (Cross-Compiling). Derselbe Effekt wird durch Setzen der Variablen KPKG_ARCH auf die gewünschte Zielarchitektur erreicht. Normalerweise wird die Architektur automatisch ermittelt.

--cross-compile foo, --cross_compile foo

Sollte ebenfalls gesetzt werden, wenn der Kernel für eine fremde Hardware-Architektur erzeugt wird. Die Umgebungsvariable hierfür lautet CROSS_COMPILE.

--subarch foo

Auf einigen Hardware-Plattformen (beispielsweise Alpha und m68k) müssen unterschiedliche Kernel für die verschiedenen Prozessoren erzeugt werden. Die dieser Option entsprechende Umgebungsvariable lautet KPKG_SUBARCH.

--arch-in-name, --arch_in_name

Diese Option vergibt einen erweiterten Namen für das Kernel-Image-Paket, so dass in einem Skript mehrere Images für Sub-Architekturen erzeugt werden können. Dies kann auch durch Setzen der Variablen ARCH_IN_NAME erreicht werden. Dies beeinflusst lediglich den Namen des Pakets, nicht das Verzeichnis, in dem die passenden Module abgelegt werden.

--pgpsign name

Setzt die Zeichenkette, mit der die Changes-Dateien für externe Module digital signiert werden. Diese Option überschreibt die Werte, die in /etc/kernel-pkg.conf oder auch ~/.kernel-pkg.conf angegeben sind.

--config target

Ändert die Einstellung für die Kernel-Konfiguration. Normalerweise wird „oldconfig“ benutzt, alternativ kann hier auch „config“, „menuconfig“, „xconfig“, „old“, „menu“ oder auch „x“ angegeben werden.

Sinnvoll ist diese Option im Zusammenhang mit PATCH_THE_KERNEL, wenn von den eingesetzten Patches neue Konfigurationsoptionen hinzugefügt werden.

--targets

Zeigt eine Liste der bekannten „Targets“ (Ziele, hier als Zielpakete zu verstehen) an. Mehr zu den Targets später.

--noexec

Übergibt die Option -n an das Kommando make, so dass keine Kommandos ausgeführt werden. Es wird lediglich angezeigt, was passieren würde.

--initrd

Wenn make-kpkg die Option linux-image übergeben wurde, so werden durch diese Option alle zusätzlichen Aktionen aufgerufen, die notwendig sind, um eine passende Init-RAM-Disk zu erzeugen.

Hierbei ist zu beachten, dass ein zusätzlicher Patch benötigt wird, der bereits in den Debian-Kernel-Sourcen enthalten ist. Wird dieser „cramfs“-Patch nicht verwendet, so muss die Konfiguration von mkinird so angepasst werden, dass cramfs nicht benutzt wird.

--zimage

Erzeugt einen zImage-Kernel statt eines bzImage-Kernels.

--bzimage

Erzeugt einen bzImage-Kernel.

--rootcmd foo

Kommando, mit dem auf dem System besondere Zugriffsrechte erreicht werden können. Dies können beispielsweise sudo oder fakeroot sein. Diese Option wird an das Programm dpkg-buildpackage weitergereicht.

--us

Diese Option wird an dpkg-buildpackage weitergereicht; der Quellcode wird nicht digital signiert.

--uc

Diese Option wird an dpkg-buildpackage weitergereicht; die Datei changelog wird nicht digital signiert.

Ziele (Targets)

clean

Löscht alle nicht benötigten Dateien aus dem Kernel-Quellcode, die zuvor über das Target „build“ erzeugt worden sind, und führt dazu das Kommando make distclean aus.

buildpackage

Führt die Targets „clean“ und „binary“ aus und erzeugt so ein Kernel-Paket.

binary

Erzeugt alle vier möglichen Debian Kernel-Pakete, indem die Targets kernel_source, kernel_headers, kernel_doc und kernel_image ausgeführt werden.

kernel_source

Erzeugt ein Debian Paket mit dem Kernel-Quellcode. Zeigt die Umgebungsvariable SOURCE_CLEAN_HOOK auf eine ausführbare Datei, so wird diese im Quellcode-Verzeichnis des Kernels ausgeführt, bevor das Paket erstellt wird. Auf diesem Weg können nicht benötigte Dateien und Verzeichnisse entfernt werden (beispielsweise Architektur-abhängige Dateien oder auch Verzeichnisse, die der Versionskontrolle dienen (find . -type d -name CVS -prune -exec rm -rf {} )).

Diese Option wirkt sich ausschließlich auf den Kernel-Quellcode aus, der zu einem Debian-Paket gepackt wird. Ähnliche Auswirkungen haben die Umgebungsvariablen HEADER_CLEAN_HOOK und DOC_CLEAN_HOOK: Es wird ein Programm ausgeführt, das die Kernel-Header- bzw. die Kernel-Dokumentationsverzeichnisse bearbeitet.

kernel_headers

Erzeugt ein Paket mit den Kernel-Headern.

kernel_doc

Erzeugt ein Paket mit der Dokumentation für den Kern.

kernel_image

Erzeugt ein Debian Paket mit dem Linux-Kernel, der aus dem Quellcode übersetzt wird. Ist noch keine Konfigurationsdatei für den Kern (.config) vorhanden, so wird eine Konfiguration benutzt, die der der Debian Bootfloppies sehr ähnlich ist.

Das Paket wird so erstellt dass, abhängig von der Hardware-Plattform, der entsprechende Bootloader aufgerufen wird, so dass der neue Kernel auch zuverlässig gestartet wird. Als Bootloader kommt dabei LILO, SILO, QUIK, VMELILO, ZIPL, yaboot, PALO oder auch GRUB zum Einsatz. Während der Installation des Pakets wird dem Administrator angeboten, eine Bootdiskette zu erzeugen. Diese wird formatiert, falls dies notwendig ist.

build

Hiermit wird lediglich der Compiler gestartet und der Kernel aus dem Source-Code übersetzt. Dieses Target wird vom Target kernel_image benutzt.

modules

Erzeugt alle Module und die entsprechenden Debian Pakete, die sehr eng von einer passenden Kernel-Version abhängen. Hierbei wird vorausgesetzt, dass alle Module im Verzeichnis /usr/src/modules abgelegt sind. Es wird ein Debian Modul-Paket erzeugt, eine entsprechende komprimierte tar-Datei, eine komprimierte diff-Datei. Weiterhin werden die MD5-Checksummen in der changes-Datei aktualisiert (mittels dpkg-genchanges). Die Datei wird mit der gleichen Identität digital signiert, mit der auch das Kernel-Paket signiert wurde. Diese Option erlaubt einem Maintainer, das Paket direkt in die Debian Archive zu kopieren.

modules_config

Konfiguriert alle Module, die sich unter /usr/src/modules befinden.

modules_image

Erzeugt Pakete zu den Modulen unter /usr/src/modules, es werden aber keine Quellcode-Pakete oder Diff-Dateien erzeugt. Weiterhin wird die Changes-Datei nicht digital signiert.

modules_clean

Löscht alle nicht benötigten Dateien im Verzeichnis /usr/src/modules.

configure

Diese Option führt ein make configure aus, genauer genommen das mittels --config angegebene config_target. Es ist voreingestellt auf oldconfig. Dies bietet die Möglichkeit, von make config erzeugte Dateien anzupassen, so dass diese später nicht von make-kpkg verändert werden.

debian

Erzeugt das Verzeichnis debian/ innerhalb des Quellcode-Verzeichnisses und wendet vorhandene Patches auf den Quellcode an.

libc-kheaders

Eine spezielle Option für den Betreuer der C-Bibliotheken.