Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
kernel-pkg.conf(5)
Edit
PageHistory
Diff
Info
LikePages
KERNEL-PKG.CONF !!!KERNEL-PKG.CONF NAME SYNOPSIS DESCRIPTION FILES SEE ALSO BUGS AUTHOR ---- !!NAME kernel-pkg.conf - site wide configuration file for make-kpkg !!SYNOPSIS ''/etc/kernel-pkg.conf'' or ''~/.kernel-pkg.conf'' !!DESCRIPTION The file ''/etc/kernel-pkg.conf'' or ''~/.kernel-pkg.conf'' is actually a __Makefile__ snippet included during the kernel packages build process, and hence you may put any legal Makefile directive in that file (just make very sure you know what you are doing). If the per user configuration file ''~/.kernel-pkg.conf'' exists, it is laoded in favour of the system wide confguration file ''/etc/kernel-pkg.conf.'' All the variables have reasonable default values, and maybe overridden on a per run or a per individual basis by using environment variables. Some of the variables can further be overridden by options to __make-kpkg.__ At the moment, the user modifiable variables supported are: __maintainer__ Local kernel-* package maintainer. Set up at package installation by the ''postinst.'' Can be overridden by the environment variable __KPKG_MAINTAINER.__ Please note that any apostrophes __ __email__ The email address of that person. Set up at package installation by the ''postinst.'' Can be overridden by the environment variable __KPKG_EMAIL.__ __pgp__ Name to search for in the pgp database __iff__ separate modules (like pcmcia etc) are being built in ''/usr/src/modules/.'' Can be overridden by the environment variable __PGP_SIGNATURE,__ and is overridden (again) by the ''--pgpsign'' option of __make-kpkg.__ Defaults to ''maintainer.'' (Optional) __debian__ The Debian revision of the kernel packages. Can be overridden by the environment variable __DEBIAN_REVISION,__ and is overridden (again) by the ''--revision'' option of __make-kpkg.__ Defaults to ''1.0.0.Custom'' (Optional) __debian_revision_mandatory__ Normally unset. Ifthis, or the environment variable __DEBIAN_REVISION_MANDATORY__ are set, then not providing a debian revision results in an error (and __make-kpkg__ shall not provide a default vvalue of 1.0.0.Custom) __image_in_boot__ Set to True if you want the kernel image ''vmlinuz'' in ''/boot'' rather than the default ''/.'' Can be overridden by the environment variable __IMAGE_IN_BOOT.__ Defaults to undefined. (Optional) __kimage__ The kernel image type (i.e. zImage or bzImage). Can be overridden from the environment variable __IMAGE_TYPE,__ and is overridden (again) by the options ''--zimage'' or ''--bzimage'' of __make-kpkg.__ Defaults to ''bzImage.'' (Optional) __no_symlinks__ Whether to use symlinks to the ''image'' file. Can be overridden by the environment variable __NO_SYMLINK__ Mutualy exclusive to ''reverse_symlinks.'' Can be used with ''image_in_boot.'' The image is placed in vmlinuz (instead of /boot/vmlinuz-X.X.XX). The old vmlinuz is moved to vmlinuz.old unconditionally. (Normally, that is only done if the version of the new image differes from the old one). This restricts you to two images, unless you take additional action and save copies of older images. This is for people who have ''/boot'' on a system that does not use symbolic links (and say, they use loadlin as a boot loader). This is a Hack. Defaults to undefined (optional) __reverse_symlinks__ Whether to use reverse symlinks (that is, the real file is the one without the version number, and the numberd version is the link) to the ''image'' file. Can be overridden by the environment variable __REVERSE_SYMLINK__ Mutualy exclusive to ''no_symlinks.'' Can be used with ''image_in_boot.'' Just like ''no_symlinks,'' except that the /boot/vmlinuz-X.XX is symlinked to the real new image, vmlinuz. This, too, restricts you to just two images unless further action is taken. The older symlinks are left dangling. This is for people with ''/boot'' on umsdos, and who can't see the link in dos, but do want to know the image version when in Linux. This is a Hack. Defaults to undefined. (optional) __patch_the_kernel__ This is an experts only variable. If set to YES (ENV variable __PATCH_THE_KERNEL__ overrides this), the build process causes run-parts to be run over ''/usr/src/kernel-patches/$(architecture)/apply'' and (hopefully) reverses the process during clean by running run-parts over ''/usr/src/kernel-patches/$(architecture)/unpatch.'' The special architecture all is used for arch independent patches. __config_target__ What type of configure step to do. Defaults to oldconfig, which is good for non-interactive (or minimally interactive) runs. If you are setting patch_the_kernel to YES and some of the patches change what configuration settings are available, then you may wish to set this to something else (like menuconfig or xconfig). (ENV variable __CONFIG_TARGET__ overrides this setting.) If the value of config_target is other than config, oldconfig, menuconfig or xconfig then it is reset to oldconfig. __use_saved_config__ This is an experts only variable. If set to NO (ENV variable __USE_SAVED_CONFIG__ overrides this), the file .config.save in the top level directory is ignored. __root_cmd__ This should be set to a means of gaining superuser access (for example, ''`sudo''' or as needed by __dpkg-buildpackages'__ -r option. The environment variable __ROOT_CMD__ overrides this. The environment variable __UNSIGN_SOURCE__ adds to this command an option to have dpkg-buildpackage not sign the source, similarily, the environment variable __UNSIGN_CHANGELOG__ adds to this command an option to have dpkg-buildpackage not sign the changelog. __delete_build_link__ If set to YES, the symbolic link ''/lib/modules/$VERSION/build'' shall be removed from the resulting .deb package. The environment variable __DELETE_BUILD_LINK__ overrides this. __do_clean__ Set to anything but YES, this shall forego the make clean done in the kernel source tree after building the kernel image package. The environment variable __CLEAN_SOURCE__ overrides this. __extra_docs__ This variable should be set to the path of any extra documentation that should be installed in ''/usr/share/doc/kernel-image-X.X.XX/'' directory. There is no checking for name conflicts, and the files are not compressed. Hence, if you want the files to be compressed, please precompress it and provide the path of the compressed file. The environment variable __EXTRA_DOCS__ overrides this, and would most likely be how extra documentation is specified. __make_libc_headers__ This is meant to be used by the ''libc6'' maintainer, when he compiles ''libc6,'' to also package up the corresponding headers. __DO NOT SET THIS__ unless you know what you are doing, since a mismatch between the headers you package and ''libc6'' may well create a subtle instablity in all code compiled on your machine. You have been warned. The environment variable __MAKE_LIBC_HEADERS__ overrides this. __CONCURRENCY_LEVEL__ If defined, this variable sets the concurrency level of make used to compile the kenel and the modules set using ''-j'' flags to the sub make in the __build__ target of __make-kpkg.__ Should be a (small) integer, if used. __ARCH_IN_NAME__ If defined, this variable causes __make-kpkg__ to use an extended name for the kernel image package by embedding the subarchitecture in the image name, so one could write a script to create multiple subarchitectures one after the other. __Please note__ that only the package ''name'' is affected, not module locations etc. __CONFDIR__ This variable should be set to a directory which contains architecture specific ''.config'' files (look at ''/usr/share/kernel-package/Config'' for examples). This is useful for people who need to compile for several architectures. Defaults to ''/usr/share/kernel-package/Config'' __IMAGEDIR__ If you want the image to be stored elsewhere than ''/boot'' set this variable to the dir where you want the image. This may be of help to __loadlin__ users. Defaults to ''/boot.'' __MODULE_LOC__ Set this variable, either in the environment or in the config file, to point to the location where the add-on modules are located. Defaults to ''/usr/src/modules'' __CONFDIR__ Set this variable, either in the environment or in the config file, to point to the location where the kernel config files are located. Defaults to ''/usr/share/kernel-package/Config'' __PATCH_DIR__ Set this variable, either in the environment or in the config file, to point to the location where the add-on kernel patches are located. Defaults to ''/usr/src/kernel-patches/ARCHITECTURE'' __ALL_PATCH_DIR__ Set this variable, either in the environment or in the config file, to point to the location where the add-on arch independent kernel patches are located. Defaults to ''/usr/src/kernel-patches/all'' The value of a variable can be set so: a) Defaults exist in the rules file. These are the values used if no customization is done. b) Variables can be set in the config file ''/etc/kernel-pkg.conf.'' These values override the defaults. c) Variables can also be set by setting a corresponding environment variable. These values override the config file and the defaults. d) Using __make-kpkg__ options, or, if using the rules file directly, on command line__ # xxx/rules DEBIAN_REVISION=2.0a kernel_image__ This overrides all the above methods. !!FILES The file described here is ''/etc/kernel-pkg.conf.'' or ''~/.kernel-pkg.conf.'' !!SEE ALSO make-kpkg(1), __kernel-img.conf__(5), make(1), __The GNU Make manual.__ !!BUGS There are no bugs. Any resemblance thereof is delirium. Really. !!AUTHOR This manual page was written by Manoj Srivastava ----
2 pages link to
kernel-pkg.conf(5)
:
make-kpkg(1)
Man5k
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.