.\" Hey, Emacs! This is an -*- nroff -*- source file. .\" Copyright (c) 1997 Manoj Srivastava .\" .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" published by the Free Software Foundation; either version 2 of .\" the License, or (at your option) any later version. .\" .\" The GNU General Public License's references to "object code" .\" and "executables" are to be interpreted as the output of any .\" document formatting or typesetting system, including .\" intermediate and printed output. .\" .\" This manual is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public .\" License along with this manual; if not, write to the Free .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, .\" USA. .\" .\" $Id: kernel-pkg.conf.5,v 1.37 2003/09/01 17:09:15 srivasta Exp $ .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH KERNEL\-PKG.CONF 5 "7. Januar 1997" Debian Debian\-GNU/Linux\-Handbuch .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection .\" other parms are allowed: see man(7), man(1) .SH BEZEICHNUNG kernel\-pkg.conf \- Konfigurationsdatei für Make\-Kpkg .SH ÜBERSICHT \fI/etc/kernel\-pkg.conf\fP oder \fI~/.kernel\-pkg.conf\fP .SH BESCHREIBUNG Die Datei \fI/etc/kernel\-pkg.conf\fP oder \fI~/.kernel\-pkg.conf\fP ist tatsächlich ein \fBMakefile\fP\-Schnipsel, der während des Bauprozesses der Kernel\-Pakete inbegriffen ist. Daher können Sie jede gültige Makefile\-Direktive in dieser Datei ablegen (stellen Sie nur sicher, dass Sie wissen, was Sie tun). Falls die benutzerabhängige Konfigurationsdatei \fI~/.kernel\-pkg.conf\fP existiert, wird sie gegenüber der systemweiten Konfigurationsdatei \fI/etc/kernel\-pkg.conf\fP bevorzugt geladen. .PP All die Variablen haben vernünftige Vorgabewerte und können pro Ausführung oder auf individueller Basis durch Verwendung einer Umgebungsvariable außer Kraft gesetzt werden. Einige der Variablen können obendrein durch Optionen für \fBmake\-kpkg\fP aufgehoben gesetzt werden. .PP Momentan werden folgende vom Benutzer veränderbaren Variablen unterstützt: .TP \fBmaintainer\fP der lokale Kernel\-Paketbetreuer (Image, Header, Dokumentation, etc.); wird bei der Paketinstallation durch \fIpostinst\fP gesetzt; kann durch die Umgebungsvariable \fBKPKG_MAINTAINER\fP außer Kraft gesetzt werden. Bitte achten Sie darauf, dass jegliche Apostrophe »'« wie folgt maskiert werden sollen: maintainer = John O'\e\*(rqBrien. Ja, das ist hässlich, aber es funktioniert. .TP \fBemail\fP die E\-Mail\-Adresse dieser Person; wird bei der Paketinstallation durch \fIpostinst\fP gesetzt; kann durch die Umgebungsvariable \fBKPKG_EMAIL\fP außer Kraft gesetzt werden .TP \fBpgp\fP eine Schlüsselkennzahl, die beim Signieren von Paketen verwandt wird; wird üblicherweise neben \fIdpkg\-buildpackage\fP unter Benutzung der Option \fI\-k\fP und Modulen Dritter in der Umbebungsvariablen \fBKMAINT\fP mitgegeben, falls separate Module (wie PCMCIA etc.) in \fI$MODULE_PATH\fP gebaut werden; kann durch die Umbebungsvariable \fBPGP_SIGNATURE\fP außer Kraft gesetzt werden und wird (wieder) durch die Option \fI\-\-pgpsign\fP von \fBmake\-kpkg\fP außer Kraft gesetzt. Vorgabe ist \fImaintainer\fP. (optional) .TP \fBdebian\fP die Version der Kernel\-Pakete, schließt sowohl die Version der Originalautoren als auch die Debian\-Überarbeitung ein; kann durch die Umbebungsvariable \fBDEBIAN_REVISION\fP außer Kraft gesetzt werden und wird (wieder) durch die Option \fI\-\-revision\fP von \fBmake\-kpkg\fP außer Kraft gesetzt. Vorgabe ist \fI\-10.0.0.Custom\fP. (optional) .TP \fBdebian_revision_mandatory\fP normalerweise nicht gesetzt. Falls dies oder die Umgebungsvariable \fBDEBIAN_REVISION_MANDATORY\fP gesetzt sind, dann führt es zu einem Fehler, wenn die Debian\-Überarbeitung nicht bereitgestellt wird (und \fBmake\-kpkg\fP keinen Vorgabewert für 10.0.0.Custom bereitstellen soll). .TP \fBkimage\fP der Kernel\-Image\-Typ (d.h. zImage oder bzImage); kann durch die Umbebungsvariable \fBIMAGE_TYPE\fP außer Kraft gesetzt werden und wird (wieder) durch die Optionen \fI\-\-zimage\fP oder \fI\-\-bzimage\fP von \fBmake\-kpkg\fP außer Kraft gesetzt. Vorgabe ist \fIbzImage\fP. (optional) .TP \fBconfig_target\fP welcher Typ von Konfigurationsschritt zu unternehmen ist. Vorgabe ist »oldconfig«, was bei der normalen, nicht interaktiven (oder minimal interaktiven) Ausführung gut ist. (Die Umgebungsvariable \fBCONFIG_TARGET\fP setzt dies außer Kraft.) Falls der Wert von config_target nicht erkannt wird, wird er auf »oldconfig« zurückgesetzt. .TP \fBuse_saved_config\fP Diese Variable ist nur für Experten. Falls sie auf NO gesetzt ist (die Umgebungsvariable \fBUSE_SAVED_CONFIG\fP setzt dies außer Kraft), wird die Datei .config.save auf der obersten Verzeichnisebene ignoriert. .TP \fBroot_cmd\fP Diese Variable ist dazu gedacht, im Ziel \fIbuildpackage\fP an \fBdpkg\-buildpackage\fP übergeben zu werden. Dies sollte als Mittel zum Erlangen von Superuser\-Rechten gesetzt werden (beispielsweise \fI»sudo«\fP oder \fI»fakeroot«),\fP wie es die \fBdpkg\-buildpackages\fP\-Option \-r erfordert. Die Umgebungsvariable \fBROOT_CMD\fP setzt dies außer Kraft. Benutzen Sie die Umgebungsvariable \fBUNSIGN_SOURCE,\fP um eine Option an dpkg\-buildpackage zu übergeben, dass die Quelle nicht signiert wird; verwenden Sie gleichermaßen die Umgebungsvariable \fBUNSIGN_CHANGELOG,\fP um eine Option an dpkg\-buildpackage zu übergeben, dass das Änderungsprotokoll nicht signiert wird. Diese Variable ist wiederum nur nützlich für das \fIbuildpackage\fP\-Ziel. Setzen Sie die Umgebungsvariable \fBROOT_CMD,\fP falls Sie zum Beispiel nur das Kernel\-Image bauen möchten. .TP \fBdelete_build_link\fP Falls dies auf »YES« gesetzt ist, soll der symbolische Verweis \fI/lib/modules/$VERSION/build\fP aus dem resultierenden .deb\-Paket entfernt werden. Die Umgebungsvariable \fBDELETE_BUILD_LINK\fP setzt dies außer Kraft. Standardmäßig ist sie nicht gesetzt. Beachten Sie, dass die Groß\- und Kleinschreibung berücksichtigt wird, »yes« soll nicht funktionieren. .TP \fBdo_clean\fP Auf »YES« gesetzt, hat dies zur Folge, dass »make clean« im Kernel\-Quellverzeichnisbaum ausgeführt wird, nachdem das Kernel\-Image\-Paket gebaut wurde. Die Umgebungsvariable \fBCLEAN_SOURCE\fP setzt dies außer Kraft. Standardmäßig ist sie nicht gesetzt. Beachten Sie, dass die Groß\- und Kleinschreibung berücksichtigt wird, »yes« soll nicht funktionieren. .TP \fBinstall_vmlinux\fP auf »YES« setzen, um das dekomprimierte ELF\-Image zusammen mit dem bootbaren komprimierten Kernel\-Image (vmlinuz) zu installieren. Standardmäßig ist es nicht gesetzt. Beachten Sie, dass die Groß\- und Kleinschreibung berücksichtigt wird, »yes« soll nicht funktionieren. .TP \fBimage_clean_hook\fP gesetzt, dass es auf eine ausführbare Datei zeigt, sollte dies dafür sorgen, dass diese ausführbare Datei von der obersten Verzeichnisebene des (temporären) Kernel\-Image\-Baums ausgeführt wird, bevor das Kernel\-Image gepackt wird. Dies hat auf nichts außer das Image Auswirkungen, das gepackt wird – falls das Skript im aktuellen Verzeichnis und seinen Unterverzeichnissen arbeitet, sollte der Originalquellverzeichnisbaum intakt bleiben. Dies soll Nachrichten des Kernel\-Images erleichtern, das gepackt wird. .TP \fBsource_clean_hook\fP gesetzt, dass es auf eine ausführbare Datei zeigt. Dies soll dafür sorgen, dass diese ausführbare Datei von der obersten Verzeichnisebene des (temporären) Kernel\-Image\-Baums ausgeführt wird, bevor die Quellen gepackt werden, \fI./debian/tmp\-source/usr/src/kernel\-source\-X.X.XX.\fP Dies hat auf nichts außer das Image Auswirkungen, das gepackt wird – falls das Skript im aktuellen Verzeichnis und seinen Unterverzeichnissen arbeitet, sollte der Originalquellverzeichnisbaum intakt bleiben. Dies soll Nachrichten des Kernel\-Images erleichtern, das gepackt wird (um zum Beispiel Verzeichnisse der Versionskontrolle zu entfernen oder unerwünschte Architekturen zu reduzieren). .TP \fBheader_clean_hook\fP gesetzt, dass es auf eine ausführbare Datei zeigt. Dies soll dafür sorgen, dass diese ausführbare Datei von der obersten Verzeichnisebene des Kernel\-Headers ausgeführt wird, bevor die Header gepackt werden. Dies hat auf nichts außer das Image Auswirkungen, das gepackt wird – falls das Skript im aktuellen Verzeichnis und seinen Unterverzeichnissen arbeitet, sollte der Originalquellverzeichnisbaum intakt bleiben. Dies soll Nachrichten des Kernel\-Images erleichtern, das gepackt wird (um zum Beispiel Verzeichnisse der Versionskontrolle zu entfernen oder unerwünschte Architekturen zu reduzieren). .TP \fBdoc_clean_hook\fP gesetzt, dass es auf eine ausführbare Datei zeigt. Dies soll dafür sorgen, dass diese ausführbare Datei von der obersten Verzeichnisebene des Dokumentationsverzeichnisbaums ausgeführt wird, bevor die Kernel\-Dokumentation gepackt wird. Dies hat auf nichts außer das Image Auswirkungen, das gepackt wird – falls das Skript im aktuellen Verzeichnis und seinen Unterverzeichnissen arbeitet, sollte der Originalquellverzeichnisbaum intakt bleiben. Dies soll Nachrichten des Kernel\-Images erleichtern, das gepackt wird (um zum Beispiel Verzeichnisse der Versionskontrolle zu entfernen oder unerwünschte Architekturen zu reduzieren). .TP \fBextra_docs\fP Diese Variable sollte auf den Pfad jeder zusätzlichen Dokumentation gesetzt werden, die im Verzeichnis \fI/usr/share/doc/kernel\-image\-X.X.XX/\fP installiert sein sollte. Es gibt dort keine Überprüfung auf Namenskonflikte und die Dateien werden nicht komprimiert. Falls Sie also wollen, dass die Dateien komprimiert werden, komprimieren Sie sie vorher und stellen den Pfad der komprimierten Datei bereit. Die Umgebungsvariable \fBEXTRA_DOCS\fP setzt dies außer Kraft und wäre höchstwahrscheinlich so wie zusätzliche Dokumentation angegeben. .TP \fBkpkg_follow_symlinks_in_src\fP Diese Option ist insbesondere für die Leute nützlich, die Ansammlungen symbolischer Verweise zum Kompilieren von Kerneln verwenden. Mit dieser Option sollen Kernel\-Quell\- und \-Header\-Pakete nicht voller defekter symbolischer Verweise sein, sondern stattdessen soll den symbolischen Verweisen gefolgt werden. Bitte beachten Sie, dass jegliche symbolische Verweise in den Kernel\-Quellen zusätzlich abgeflacht werden. Die Umgebungsvariable \fBKPKG_FOLLOW_SYMLINKS_IN_SRC\fP setzt dies außer Kraft. Standardmäßig ist sie nicht gesetzt. .TP \fBmake_libc_headers\fP Dies ist für die Verwendung durch den \fIlibc6\fP\-Paketbetreuer gedacht, wenn er \fIlibc6\fP kompiliert bis hin zum Paketieren der zugehörigen Header. \fBSETZEN SIE DIES NICHT,\fP es sei denn, Sie wissen was Sie tun, da eine falsche Zusammenstellung von Headern Ihres Pakets und \fIlibc6\fP eine hintergründige Instabilität in sämtlichem, auf Ihrem Rechner kompilierten Kode erzeugen könnte. Sie wurden gewarnt. Die Umgebungsvariable \fBKPKG_FOLLOW_SYMLINKS_IN_SRC\fP setzt dies außer Kraft. Standardmäßig ist sie nicht gesetzt. .TP \fBCONCURRENCY_LEVEL\fP Diese Variable setzt, falls sie definiert ist, die Nebenläufigkeitsstufe von »make«, das benutzt wird, um den Kernel und die Module zu kompilieren, die mit \fI\-j\fP\-Schaltern zur Untererstellung im Ziel \fBbuild\fP von \fBmake\-kpkg\fP gesetzt sind. Sie sollte, wenn sie benutzt wird, eine (kleine) Ganzzahl sein. .TP \fBARCH_IN_NAME\fP Diese Variable veranlasst \fBmake\-kpkg,\fP falls sie definiert ist, einen erweiterten Namen für das Kernel\-Image\-Paket durch Einbetten der Unterarchitektur in den Image\-Namen zu benutzen. Daher könnte jemand ein Skript schreiben, um nacheinander mehrere Unterarchitekturen zu erstellen. \fBBitte beachten Sie,\fP dass nur der Paket\fIname\fP davon beeinflusst wird, nicht Modulspeicherorte etc. .TP \fBCONFDIR\fP Setzen Sie diese Variable entweder in der Umgebung oder in der Konfigurationsdatei, um auf den Ort zu verweisen, an dem die Kernel\-Konfigurationsdateien liegen. Dies sind architekturspezifische \&\fI.config\fP\-Dateien (Beispiele finden Sie in \fI/usr/share/kernel\-package/Config\fP). Dies ist nützlich für Leute, die für mehrere Architekturen kompilieren müssen. Vorgabe ist \fI/usr/share/kernel\-package/Config\fP. .TP \fBIMAGEDIR\fP Falls Sie das Image anderswo als in \fI/boot\fP speichern möchten, setzen Sie diese Variable auf das Verzeichnis, in das Sie das Image ablegen möchten. Dies könnte \fBloadlin\fP\-Benutzern helfen. Vorgabe ist \fI/boot.\fP .TP \fBMODULE_LOC\fP Setzen Sie diese Variable entweder in der Umgebung oder in der Konfigurationsdatei, um auf den Ort zu verweisen, an dem die Add\-On\-Module liegen. Vorgabe ist \fI/usr/src/modules\fP. .TP .PP Der Wert der Variablen kann wie folgt gesetzt werden: .IP a) In der Regeldatei existieren Vorgaben. Dies sind Werte, die benutzt werden, falls keine Anpassungen vorgenommen werden. .IP b) In der Konfigurationsdatei \fI/etc/kernel\-pkg.conf\fP können Variablen gesetzt werden. Diese Werte setzen die Vorgaben außer Kraft. .IP c) Variablen können außerdem durch das Setzen der entsprechenden Umgebungsvariable gesetzt werden. Diese Werte setzen die Konfigurationsdatei und die Vorgaben außer Kraft. .IP d) Unter Verwendung von \fBmake\-kpkg\fP\-Optionen, oder, bei direkter Benutzung der Regeldatei, auf der Kommandozeile .br \fB# xxx/rules DEBIAN_REVISION=2.0a kernel_image\fP .br Dies setzt alle vorhergehenden Methoden außer Kraft. .SH DATEIEN Die hier beschriebene Datei ist \fI/etc/kernel\-pkg.conf.\fP oder \fI~/.kernel\-pkg.conf.\fP .SH "SIEHE AUCH" \fBmake\fP(1), \fBmake\-kpkg\fP(1), \fBkernel\-img.conf\fP(5), \fBThe GNU Make manual\fP .SH BUGS Es gibt hier keine Bugs. Jede Ähnlichkeit damit ist Wahn. Wirklich. .SH AUTOR Diese Handbuchseite wurde von Manoj Srivastava für das Debian\-GNU/Linux\-System geschrieben.