KERNEL-IMG.CONF(5)					      Debian GNU/Linux manual						KERNEL-IMG.CONF(5)

NAME

       kernel-img.conf - site wide configuration file for kernel image packages

SYNOPSIS

       /etc/kernel-img.conf

DESCRIPTION

       The  file /etc/kernel-img.conf is a simple file looked at by the kernel image post installation process to allow local options for handling
       some aspects of the installation, overriding the defaults built into the image itself.

       The format of the file is a simple VAR=VALUE pair. Boolean values may be specified as Yes, True, 1, and No, False, 0, and are case insensi-
       tive.  This file is automatically created by the installation script in certain circumstances.

       At the moment, the user modifiable variables supported are:

       postinst_hook
	      DEPRECATED: 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  env  variable  STEM  shall	be set to the value of the --stem argument (or the default value, linux), and KERNEL_PACK-
	      AGE_VERSION shall be set to the version of the kernel-package that created the package.  This script shall be called with two  argu-
	      ments,  the  first  being  the  version  of the kernel image, and the second argument being the location 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 db_stop, 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	after  the
	      scripts in /etc/kernel/postinst.d directory.

       postrm_hook
	      DEPRECATED:  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. The environment variable KERNEL_PACKAGE_VERSION 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  version  of the kernel image, and the second argument being the location 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 db_stop, debconf does not restore stdout, so messages to
	      stdout disappear.  This script is run after the scripts in /etc/kernel/postrm.d directory.

       preinst_hook
	      DEPRECATED: 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. The environment variable KERNEL_PACKAGE_VERSION 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 version of the kernel
	      image, and the second argument being the location of the kernel image itself.  This script is run after  the  scripts  in  /etc/ker-
	      nel/preinst.d directory.

       prerm_hook
	      DEPRECATED:  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. The environment variable KERNEL_PACKAGE_VERSION shall be set to the version of the kernel-pack-
	      age that created the package. This script shall be called with two arguments, the first being the version of the kernel  image,  and
	      the second argument being the location 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
	      db_stop,	debconf  does  not  restore  stdout,  so  messages to stdout disappear.  This script is run after the scripts in /etc/ker-
	      nel/prerm.d directory.

       src_postinst_hook
	      DEPRECATED: Unlike the other hook variables, this is meant for a script run during the post inst of a  docs,  headers  or  a  source
	      package.	Using  this hook for the headers package is now being deprecated, at some point the headers post install script shall only
	      run the header_postinst_hook.  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. The environment variable KERNEL_PACKAGE_VERSION 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
	      name  of	the  package being installed (could be kernel source or headers), and the second argument being the version of the package
	      being installed. Errors in the script shall cause the postinst to  fail.	 This  script  is  run	after  the  scripts  in  /etc/ker-
	      nel/src_postinst.d directory.

       header_postinst_hook
	      DEPRECATED: 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.  The environment variable KERNEL_PACKAGE_VERSION 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 name of the package  being  installed,  and
	      the  second  argument being the version of the package being installed. Errors in the script shall cause the postinst to fail.  This
	      script is run after the scripts in /etc/kernel/header_postinst.d directory.

       clobber_modules
	      If set, the preinst shall silently try to move /lib/modules/version out of the way if it is the same  version  as  the  image  being
	      installed. Use at your own risk.	This variable is unset by default.

       warn_reboot
	      This  variable  can  be used to turn off the warning given when installing a kernel image which is the same version as the currently
	      running version. If the modules list is changed, the modules dependencies may have been changed, and the modules for the new  kernel
	      may not run correctly on the running kernel if the kernel ABI has changed in the meanwhile. It is a good idea to reboot, and this is
	      a note to remind you. If you know what you are doing, you can set this variable to no. This variable is set by default.

       relink_build_link
	      This option manipulates the build link created by recent kernels. If the link is a dangling link, and if a the corresponding  kernel
	      headers  appear  to have been installed on the system, a new symlink shall be created to point to them. The default is to relink the
	      build link (YES).

       force_build_link
	      This option manipulates the build link created by recent kernels. If the link is a dangling link, a new symlink shall be created	to
	      point to kernel headers data in /usr/src, whether they have been installed or not. The default is unset, we don't create potentially
	      dangling symlinks by default.

       relink_src_link
	      This option manipulates the source link created by recent kernels. If the link is a dangling link it is deleted at install time. The
	      default is to relink (delete) the source link (YES).

       silent_modules
	      This  option  has  been put in for the people who are vastly irritated on being warned about preexisting modules directory /lib/mod-
	      ules/$version.  That directory may belong to an old or defunct kernel image package, in which case problems may arise with  leftover
	      modules  in  that  directory  tree, or the directory may legitimately exist due to a independent modules package being installed for
	      this kernel version that has already been unpacked.  In this latter case the existence of the directory is benign.  If you set  this
	      variable, you shall no longer be given a chance to abort if a preexisting modules directory /lib/modules/$version is detected.  This
	      is unset by default.

       ignore_depmod_err
	      If set, does not prompt to continue after a depmod problem in the postinstall script. This facilitates automated installs, though it
	      may mask a problem with the kernel image. A diagnostic is still issued. This is unset be default.

FILES

       The file described here is /etc/kernel-img.conf.

SEE ALSO

       make(1), make-kpkg(1), kernel-pkg.conf(5), The GNU Make manual

BUGS

       There are no bugs.  Any resemblance thereof is delirium. Really.

AUTHOR

       This manual page was written by Manoj Srivastava <srivasta@debian.org>, for the Debian GNU/Linux system.

Debian								    Aug 20 2009 						KERNEL-IMG.CONF(5)