.\" Hey, Emacs! This is an -*- nroff -*- source file. .\" Copyright (c) 2000 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-img.conf.5,v 1.25 2003/09/28 01:16:52 srivasta Exp $ .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH KERNEL\-IMG.CONF 5 "20. August 2009" 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\-img.conf \- Site\-weite Konfigurationsdatei für Kernel\-Image\-Pakete .SH ÜBERSICHT \fI/etc/kernel\-img.conf\fP .SH BESCHREIBUNG Die Datei \fI/etc/kernel\-img.conf\fP ist eine einfache Datei, die vor dem Installationsprozess des Kernel\-Images eingesehen wird, um lokale Optionen zu ermöglichen, die einige Aspekte der Installation behandeln und die Vorgaben, die im Image selbst eingebaut sind, außer Kraft setzen. .PP Das Format der Datei ist ein einfaches Paar \fBVAR = WERT\fP. Boole'sche Werte können als \fIYes,\fP \fITrue,\fP \fI1\fP und \fINo,\fP \fIFalse,\fP \fI0\fP angegeben werden und berücksichtigen keine Groß\-/Kleinschreibung. Diese Datei wird unter bestimmten Umständen automatisch durch das Installationsskript erstellt. .PP Momentan werden folgende vom Benutzer veränderbaren Variablen unterstützt: .TP \fBpostinst_hook\fP \fBMISSBILLIGT:\fP Setzen Sie diese Variable auf ein Skript, das während der Installation ausgeführt werden soll. Der Pfad kann relativ sein, falls das Skript in einem sicheren Pfad liegt – dies sind /bin, /sbin, /usr/bin, oder /usr/sbin oder es muss stattdessen ein absoluter Pfad sein. Bevor Sie dieses Skript aufrufen, soll die Umgebungsvariable \fBSTEM\fP auf den Wert des Arguments \fI\-\-stem\fP (oder den Standardwert, linux) gesetzt werden und \fBKERNEL_PACKAGE_VERSION\fP soll auf die Version von kernel\-package gesetzt werden, das dieses Paket erstellte. Dieses Skript soll mit zwei Argumenten aufgerufen werden. Das erste ist die \fIVersion\fP des Kernel\-Images und das zweite der Speicherplatz des Kernel\-Images selbst. Fehler im Skript sollen das Fehlschlagen von »postinst« verursachen. Da vor dem Aufruf des Skripts Debconf benutzt wird, sollte das Skript keine Diagnosenachrichten auf die Standardausgabe ausgeben – solange »postinst« \fBdb_stop\fP aufruft, stellt Debconf die Standardausgabe nicht wieder her, daher verschwinden Nachrichten an die Standardausgabe. Ein Beispielskript für Grub\-Benutzer liegt im Verzeichnis /usr/share/doc/kernel\-package/. Dieses Skript wird \fInach\fP den Skripten im Verzeichnis /etc/kernel/postinst.d ausgeführt. .TP \fBpostrm_hook\fP \fBMISSBILLIGT:\fP Setzen Sie diese Variable auf ein Skript, das in »postrm« (das ist, nachdem das Image entfernt wurde) ausgeführt wird, nachdem all Entfernungsaktionen durchgeführt wurden. Der Pfad kann relativ sein, falls das Skript in einem sicheren Pfad liegt – dies sind /bin, /sbin, /usr/bin oder /usr/sbin oder es muss stattdessen ein absoluter Pfad sein. Die Umgebungsvariable \fBKERNEL_PACKAGE_VERSION\fP soll auf die Version von kernel\-package gesetzt werden, das dieses Paket erstellte. Dieses Skript soll mit zwei Argumenten aufgerufen werden. Das erste ist die \fIVersion\fP des Kernel\-Images und das zweite der Speicherplatz des Kernel\-Images selbst. Fehler im Skript sollen ein Warnung ausgeben, aber ansonsten ignoriert werden. Da vor dem Aufruf des Skripts Debconf benutzt wird, sollte das Skript keine Diagnosenachrichten auf die Standardausgabe ausgeben – solange »postinst« \fBdb_stop\fP aufruft, stellt Debconf die Standardausgabe nicht wieder her, daher verschwinden Nachrichten an die Standardausgabe. Dieses Skript wird \fInach\fP den Skripten im Verzeichnis /etc/kernel/postrm.d ausgeführt. .TP \fBpreinst_hook\fP \fBMISSBILLIGT:\fP Setzen Sie diese Variable auf ein Skript, das vor dem Entpacken des Pakets ausgeführt werden soll und benutzt werden kann, um in zusätzliche Prüfungen einzufließen. Der Pfad kann relativ sein, falls das Skript in einem sicheren Pfad liegt – dies sind /bin, /sbin, /usr/bin oder /usr/sbin oder es muss stattdessen ein absoluter Pfad sein. Die Umgebungsvariable \fBKERNEL_PACKAGE_VERSION\fP soll auf die Version von kernel\-package gesetzt werden, das dieses Paket erstellte. Dieses Skript soll mit zwei Argumenten aufgerufen werden. Das erste ist die \fIVersion\fP des Kernel\-Images und das zweite der Speicherplatz des Kernel\-Images selbst. Dieses Skript wird \fInach\fP den Skripten im Verzeichnis /etc/kernel/preinst.d ausgeführt. .TP \fBprerm_hook\fP \fBMISSBILLIGT:\fP Setzen Sie diese Variable auf ein Skript, das vor dem Entfernen der Paketdateien ausgeführt wird (falls irgendwelche hinzugefügten Dateien entfernt werden können). Der Pfad kann relativ sein, falls das Skript in einem sicheren Pfad liegt – dies sind /bin, /sbin, /usr/bin oder /usr/sbin oder es muss stattdessen ein absoluter Pfad sein. Die Umgebungsvariable \fBKERNEL_PACKAGE_VERSION\fP soll auf die Version von kernel\-package gesetzt werden, das dieses Paket erstellte. Dieses Skript soll mit zwei Argumenten aufgerufen werden. Das erste ist die \fIVersion\fP des Kernel\-Images und das zweite der Speicherplatz des Kernel\-Images selbst. Fehler im Skript sollen das Fehlschlagen von »prerm« verursachen. Da vor dem Aufruf des Skripts Debconf benutzt wird, sollte das Skript keine Diagnosenachrichten auf die Standardausgabe ausgeben – solange »postinst« \fBdb_stop\fP aufruft, stellt Debconf die Standardausgabe nicht wieder her, daher verschwinden Nachrichten an die Standardausgabe. Dieses Skript wird \fInach\fP den Skripten im Verzeichnis /etc/kernel/prerm.d ausgeführt. .TP \fBsrc_postinst_hook\fP \fBMISSBILLIGT:\fP Anders als die anderen Hook\-Variablen ist dies für ein Skript gedacht, das während der Vorinstallation (»post inst«) eines Dokumentations\-, Header\- oder Quellpakets ausgeführt wird. Die Verwendung dieses Hooks ist nun missbilligt, das Vorinstallationsskript für das Headers\-Skript soll nur den »header_postinst_hook« ausführen. Der Pfad kann relativ sein, falls das Skript in einem sicheren Pfad liegt – dies sind /bin, /sbin, /usr/bin oder /usr/sbin oder es muss stattdessen ein absoluter Pfad sein. Die Umgebungsvariable \fBKERNEL_PACKAGE_VERSION\fP soll auf die Version von kernel\-package gesetzt werden, das dieses Paket erstellte. Dieses Skript soll mit zwei Argumenten aufgerufen werden. Das erste ist die \fIVersion\fP des Kernel\-Images und das zweite der Speicherplatz des Kernel\-Images selbst. Fehler im Skript sollen das Fehlschlagen von »postinst« verursachen. Dieses Skript wird \fInach\fP den Skripten im Verzeichnis /etc/kernel/postinst.d ausgeführt. .TP \fBheader_postinst_hook\fP \fBMISSBILLIGT:\fP Anders als die anderen Hook\-Variablen ist dies für ein Skript gedacht, das nur während der Vorinastallation (»post inst«) eines Header\-Pakets ausgeführt wird. Der Pfad kann relativ sein, falls das Skript in einem sicheren Pfad liegt – dies sind /bin, /sbin, /usr/bin oder /usr/sbin oder es muss stattdessen ein absoluter Pfad sein. Die Umgebungsvariable \fBKERNEL_PACKAGE_VERSION\fP soll auf die Version von kernel\-package gesetzt werden, das dieses Paket erstellte. Dieses Skript soll mit zwei Argumenten aufgerufen werden. Das erste ist die \fIVersion\fP des Kernel\-Images und das zweite der Speicherplatz des Kernel\-Images selbst. Fehler im Skript sollen das Fehlschlagen von »postinst« verursachen. Dieses Skript wird \fInach\fP den Skripten im Verzeichnis /etc/kernel/header_postinst.d ausgeführt. .TP \fBclobber_modules\fP Falls gesetzt, soll »preinst« stillschweigend versuchen, /lib/modules/version aus dem Weg zu räumen, wenn die gleiche Version wie das Image installiert wird. Benutzung auf eigene Gefahr. Diese Variable ist standardmäßig nicht gesetzt. .TP \fBwarn_reboot\fP Diese Variable kann benutzt werden, um die Warnung abzuschalten, wenn ein Kernel\-Image installiert wird, das die gleiche Version hat wie das aktuell laufende. Falls die Liste der Module geändert wurde, könnten sich die Modulabhängigkeiten geändert haben und die Module für den neuen Kernel werden möglicherweise nicht korrekt auf dem laufenden Kernel ausgeführt, falls sich das ABI in der Zwischenzeit geändert hat. Es ist empfehlenswert, den Rechner neu zu starten und dieser Hinweis soll Sie daran erinnern. Falls Sie wissen, was Sie tun, können Sie diese Variable auf »no« setzen. Standardmäßig ist diese Variable gesetzt. .TP \fBrelink_build_link\fP Diese Option manipuliert den von aktuellen Kerneln erstellten Bauverweis. Falls der Verweis defekt ist und die entsprechenden Kernel\-Header auf dem System installiert zu sein scheinen, soll ein neuer symbolischer Verweis erstellt werden, der darauf zeigt. Vorgabe ist, den Bauverweis erneut zu verknüpfen (YES). .TP \fBforce_build_link\fP Diese Option manipuliert den durch aktuelle Kernel erstellten Bauverweis. Falls der Verweis defekt ist, soll ein neuer symbolischer Verweis erstellt werden, der auf die Kernel\-Header\-Daten in /usr/src verweist, unabhängig davon, ob sie installiert sind oder nicht. Standardmäßig ist sie nicht gesetzt, damit keine potentiell defekten Verweise erstellt werden. .TP \fBrelink_src_link\fP Diese Option manipuliert den durch aktuelle Kernel erstellten Quellverweis. Falls der Verweis defekt ist, wird er bei der Installation gelöscht. Vorgabe ist, den Quellverweis wieder zu verknüpfen (löschen) (YES). .TP \fBsilent_modules\fP Diese Option wurde für die Leute eingebaut, die durch die Warnung über das vorher existierende Verzeichnis \fI/lib/modules/$version\fP erheblich irritiert wurden. Dieses Verzeichnis könnte zu einem alten oder nicht mehr existierenden Kernel\-Image\-Paket gehören. In diesem Fall können Probleme mit übriggebliebenen Modulen in diesem Verzeichnisbaum auftreten oder das Verzeichnis könnte aufgrund eines unabhängigen Modulpakets zu Recht existieren, das für diese Kernel\-Version installiert wird und bereits entpackt wurde. In diesem letzeren Fall ist die Existenz des Verzeichnisses ungefährlich. Falls Sie diese Variable setzen, haben Sie nicht länger die Möglichkeit abzubrechen, falls ein vorher existierendes Modulverzeichnis \fI/lib/modules/$version\fP entdeckt wird. Dies ist standardmäßig nicht gesetzt. .TP \fBignore_depmod_err\fP Falls gesetzt, wird nach einem Depmod\-Problem im Vorinstallationsskript nicht gefragt, ob fortgesetzt werden soll. Dies erleichtert automatische Installationen, könnte allerdings ein Problem mit dem Kernel\-Image verbergen. Eine Diagnose wird immer noch ausgegeben. Dies ist standardmäßig nicht gesetzt. .SH DATEIEN The file described here is \fI/etc/kernel\-img.conf\fP. Also, there are example scripts suitable for dropping into \fI/etc/kernel/*.d\fP installed in \fI/usr/share/doc/kernel\-common/examples.\fP .SH "SIEHE AUCH" \fBmake\fP(1), \fBmake\-kpkg\fP(1), \fBkernel\-pkg.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.