.\" Hey, Emacs! This is an -*- nroff -*- source file. .\" Copyright (c) 2000 Manoj Srivastava .\" Copyright 2019 Ben Hutchings .\" .\" 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. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH KERNEL\-IMG.CONF 5 "24. März 2019" 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 \- Konfigurationsdatei für Linux\-Kernel\-Image\-Pakete .SH ÜBERSICHT \fI/etc/kernel\-img.conf\fP .SH BESCHREIBUNG The file \fI/etc/kernel\-img.conf\fP is used by the kernel package installation and removal process to allow local options for handling some aspects of the installation. Most configuration variables apply only to kernel image packages. .PP Not all kernel image package creators support this file, or all the configuration variables. Support status for the file itself is: .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package supported Ubuntu linux source package supported kernel\-package supported make deb\-pkg ignored .TE .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 \fBdo_symlinks\fP If set, the postinst and postrm scripts will maintain symlinks to default kernel and initramfs images, as described in \fIlinux\-update\-symlinks\fP(8). This variable is set by default. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package supported Ubuntu linux source package supported kernel\-package ignored since v12.001; previously supported .TE .TP \fBimage_dest\fP Set this variable to the directory in which symlinks to the default kernel and initramfs images should be maintained. The default value is \fI/\fP. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package supported Ubuntu linux source package supported kernel\-package ignored since v12.001; previously supported .TE .TP \fBlink_in_boot\fP If set, this has the same effect as \fIimage_dest\ =\ /boot\fP and overrides any other setting of \fBimage_dest\fP. This variable is unset by default. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package supported Ubuntu linux source package supported kernel\-package ignored since v12.001; previously supported .TE .TP \fBpostinst_hook\fP \fBDEPRECATED\fP: Set this variable to a script to be executed during installation. The path can be a relative path if the script lives in a safe path \-\- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. Before calling this script, the environment variable \fBSTEM\fP shall be set to the value of the \fI\-\-stem\fP argument (or the default value, linux), and in packages created by kernel\-package \fBKERNEL_PACKAGE_VERSION\fP shall be set to the version of the kernel\-package that created the package. This script shall be called with two arguments, the first being the \fIversion\fP of the kernel image, and the second argument being the \fIlocation\fP of the kernel image itself. Errors in the script shall cause the postinst to fail. Since debconf is in use before the script is called, this script should issue no diagnostic messages to stdout \-\- while the postinst does call \fBdb_stop\fP, debconf does not restore stdout, so messages to stdout disappear. An example script for grub users is present in /usr/share/doc/kernel\-package/ directory. This script is run \fIafter\fP the scripts in /etc/kernel/postinst.d directory. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package unsupported since v4.6.1\-1; previously supported Ubuntu linux source package unsupported since v4.15.0\-18.19; previously supported kernel\-package deprecated .TE .TP \fBpostrm_hook\fP \fBDEPRECATED\fP: Set this variable to a script to be executed in the postrm (that is, after the image has been removed) after all the remove actions have been performed. The path can be a relative path if the script lives in a safe path \-\- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. In packages created by kernel\-package, the environment variable \fBKERNEL_PACKAGE_VERSION\fP shall be set to the version of the kernel\-package that created the package. This script shall be called with two arguments, the first being the \fIversion\fP of the kernel image, and the second argument being the \fIlocation\fP of the kernel image itself. Errors in the script shall produce a warning message, but shall be otherwise ignored. Since debconf is in use before the script is called, this script should issue no diagnostic messages to stdout \-\- while the postinst does call \fBdb_stop\fP, debconf does not restore stdout, so messages to stdout disappear. This script is run \fIafter\fP the scripts in /etc/kernel/postrm.d directory. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package unsupported since v4.6.1\-1; previously supported Ubuntu linux source package unsupported since v4.15.0\-18.19; previously supported kernel\-package deprecated .TE .TP \fBpreinst_hook\fP \fBDEPRECATED\fP: Set this variable to a script to be executed before the package is unpacked, and can be used to put in additional checks. The path can be a relative path if the script lives in a safe path \-\- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. In packages created by kernel\-package, the environment variable \fBKERNEL_PACKAGE_VERSION\fP shall be set to the version of the kernel\-package that created the package. This script shall be called with two arguments, the first being the \fIversion\fP of the kernel image, and the second argument being the \fIlocation\fP of the kernel image itself. This script is run \fIafter\fP the scripts in /etc/kernel/preinst.d directory. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package unsupported since v4.6.1\-1; previously supported Ubuntu linux source package unsupported since v4.15.0\-18.19; previously supported kernel\-package deprecated .TE .TP \fBprerm_hook\fP \fBDEPRECATED\fP: Set this variable to a script to be executed before the package files are removed (so any added files may be removed) . The path can be a relative path if the script lives in a safe path \-\- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. In packages created by kernel\-package, the environment variable \fBKERNEL_PACKAGE_VERSION\fP shall be set to the version of the kernel\-package that created the package. This script shall be called with two arguments, the first being the \fIversion\fP of the kernel image, and the second argument being the \fIlocation\fP of the kernel image itself. Errors in the script shall cause the prerm to fail. Since debconf is in use before the script is called, this script should issue no diagnostic messages to stdout \-\- while the postinst does call \fBdb_stop\fP, debconf does not restore stdout, so messages to stdout disappear. This script is run \fIafter\fP the scripts in /etc/kernel/prerm.d directory. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package unsupported since v4.6.1\-1; previously supported Ubuntu linux source package unsupported since v4.15.0\-18.19; previously supported kernel\-package deprecated .TE .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. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package unsupported Ubuntu linux source package unsupported kernel\-package deprecated .TE .TP \fBheader_postinst_hook\fP \fBDEPRECATED\fP: Unlike the other hook variables, this is meant for a script run during the post inst of a headers package only. The path can be a relative path if the script lives in a safe path \-\- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. In packages created by kernel\-package, the environment variable \fBKERNEL_PACKAGE_VERSION\fP shall be set to the version of the kernel\-package that created the package. This script shall be called with two arguments, the first being the \fIname\fP of the package being installed, and the second argument being the \fIversion\fP of the package being installed. Errors in the script shall cause the postinst to fail. This script is run \fIafter\fP the scripts in /etc/kernel/header_postinst.d directory. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package unsupported Ubuntu linux source package unsupported since v4.15.0\-18.19; previously supported kernel\-package deprecated .TE .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. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package ignored Ubuntu linux source package ignored kernel\-package supported .TE .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. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package ignored Ubuntu linux source package ignored kernel\-package supported .TE .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). .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package ignored Ubuntu linux source package ignored kernel\-package supported .TE .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. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package ignored Ubuntu linux source package ignored kernel\-package supported .TE .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). .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package ignored Ubuntu linux source package ignored kernel\-package supported .TE .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. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package ignored Ubuntu linux source package ignored kernel\-package supported .TE .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. .TS nokeep; l l. \fBPackage creator\fP \fBStatus\fP Debian linux source package unsupported since v4.4.1\-1~exp1; previously supported Ubuntu linux source package unsupported since v4.15.0\-18.19; previously ignored kernel\-package supported .TE .SH DATEIEN The file described here is \fI/etc/kernel\-img.conf\fP. \fBkernel\-common\fP includes example scripts suitable for dropping into \fI/etc/kernel/*.d\fP installed in \fI/usr/share/doc/kernel\-common/examples\fP. .SH "SIEHE AUCH" \fBlinux\-update\-symlinks\fP(8), \fBmake\-kpkg\fP(1), \fBkernel\-pkg.conf\fP(5) .SH AUTOR Diese Handbuchseite wurde von Manoj Srivastava und Ben Hutchings für das Debian\-GNU/Linux\-System geschrieben.