4 # Copyright 2003 Wichert Akkerman <wichert@wiggy.net>
6 # Simple script to generate a deb package for a Linux kernel. All the
7 # complexity of what to do with a kernel after it is installed or removed
8 # is left to other scripts and packages: they can install scripts in the
9 # /etc/kernel/{pre,post}{inst,rm}.d/ directories (or an alternative location
10 # specified in KDEB_HOOKDIR) that will be called on package install and
16 local pname
="$1" pdir
="$2"
18 mkdir
-m 755 -p "$pdir/DEBIAN"
19 mkdir
-p "$pdir/usr/share/doc/$pname"
20 cp debian
/copyright
"$pdir/usr/share/doc/$pname/"
21 cp debian
/changelog
"$pdir/usr/share/doc/$pname/changelog.Debian"
22 gzip -9 "$pdir/usr/share/doc/$pname/changelog.Debian"
23 sh
-c "cd '$pdir'; find . -type f ! -path './DEBIAN/*' -printf '%P\0' \
24 | xargs -r0 md5sum > DEBIAN/md5sums"
26 # Fix ownership and permissions
27 chown
-R root
:root
"$pdir"
29 # in case we are in a restrictive umask environment like 0077
33 dpkg-gencontrol
$forcearch -Vkernel:debarch
="${debarch}" -p$pname -P"$pdir"
34 dpkg
--build "$pdir" ..
38 # Attempt to find the correct Debian architecture
39 case "$UTS_MACHINE" in
41 debarch
="$UTS_MACHINE" ;;
47 debarch
=s390$
(grep -q CONFIG_64BIT
=y
$KCONFIG_CONFIG && echo x || true
) ;;
49 debarch
=$
(grep -q CPU_LITTLE_ENDIAN
=y
$KCONFIG_CONFIG && echo ppc64el ||
echo powerpc
) ;;
53 debarch
=mips$
(grep -q CPU_LITTLE_ENDIAN
=y
$KCONFIG_CONFIG && echo el || true
) ;;
57 if grep -q CONFIG_AEABI
=y
$KCONFIG_CONFIG; then
58 if grep -q CONFIG_VFP
=y
$KCONFIG_CONFIG; then
68 debarch
=$
(dpkg
--print-architecture)
70 echo "** ** ** WARNING ** ** **" >&2
72 echo "Your architecture doesn't have it's equivalent" >&2
73 echo "Debian userspace architecture defined!" >&2
74 echo "Falling back to using your current userspace instead!" >&2
75 echo "Please add support for $UTS_MACHINE to ${0} ..." >&2
78 if [ -n "$KBUILD_DEBARCH" ] ; then
79 debarch
="$KBUILD_DEBARCH"
81 forcearch
="-DArchitecture=$debarch"
85 # Some variables and settings used throughout the script
86 version
=$KERNELRELEASE
87 revision
=$
(cat .version
)
88 if [ -n "$KDEB_PKGVERSION" ]; then
89 packageversion
=$KDEB_PKGVERSION
91 packageversion
=$version-$revision
93 sourcename
=$KDEB_SOURCENAME
94 tmpdir
="$objtree/debian/tmp"
95 fwdir
="$objtree/debian/fwtmp"
96 kernel_headers_dir
="$objtree/debian/hdrtmp"
97 libc_headers_dir
="$objtree/debian/headertmp"
98 dbg_dir
="$objtree/debian/dbgtmp"
99 packagename
=linux-image-
$version
100 fwpackagename
=linux-firmware-image-
$version
101 kernel_headers_packagename
=linux-headers-
$version
102 libc_headers_packagename
=linux-libc-dev
103 dbg_packagename
=$packagename-dbg
108 if [ "$ARCH" = "um" ] ; then
109 packagename
=user-mode-linux-
$version
112 # Not all arches have the same installed path in debian
113 # XXX: have each arch Makefile export a variable of the canonical image install
117 installed_image_path
="usr/bin/linux-$version"
120 installed_image_path
="boot/vmlinux-$version"
123 installed_image_path
="boot/vmlinuz-$version"
126 BUILD_DEBUG
="$(grep -s '^CONFIG_DEBUG_INFO=y' $KCONFIG_CONFIG || true)"
128 # Setup the directory structure
129 rm -rf "$tmpdir" "$fwdir" "$kernel_headers_dir" "$libc_headers_dir" "$dbg_dir" $objtree/debian
/files
130 mkdir
-m 755 -p "$tmpdir/DEBIAN"
131 mkdir
-p "$tmpdir/lib" "$tmpdir/boot"
132 mkdir
-p "$fwdir/lib/firmware/$version/"
133 mkdir
-p "$kernel_headers_dir/lib/modules/$version/"
135 # Build and install the kernel
136 if [ "$ARCH" = "um" ] ; then
137 mkdir
-p "$tmpdir/usr/lib/uml/modules/$version" "$tmpdir/usr/bin" "$tmpdir/usr/share/doc/$packagename"
139 cp System.map
"$tmpdir/usr/lib/uml/modules/$version/System.map"
140 cp $KCONFIG_CONFIG "$tmpdir/usr/share/doc/$packagename/config"
141 gzip "$tmpdir/usr/share/doc/$packagename/config"
143 cp System.map
"$tmpdir/boot/System.map-$version"
144 cp $KCONFIG_CONFIG "$tmpdir/boot/config-$version"
146 # Not all arches include the boot path in KBUILD_IMAGE
147 if [ -e $KBUILD_IMAGE ]; then
148 cp $KBUILD_IMAGE "$tmpdir/$installed_image_path"
150 cp arch
/$ARCH/boot
/$KBUILD_IMAGE "$tmpdir/$installed_image_path"
153 if grep -q "^CONFIG_OF=y" $KCONFIG_CONFIG ; then
154 # Only some architectures with OF support have this target
155 if grep -q dtbs_install
"${srctree}/arch/$SRCARCH/Makefile"; then
156 $MAKE KBUILD_SRC
= INSTALL_DTBS_PATH
="$tmpdir/usr/lib/$packagename" dtbs_install
160 if grep -q '^CONFIG_MODULES=y' $KCONFIG_CONFIG ; then
161 INSTALL_MOD_PATH
="$tmpdir" $MAKE KBUILD_SRC
= modules_install
162 rm -f "$tmpdir/lib/modules/$version/build"
163 rm -f "$tmpdir/lib/modules/$version/source"
164 if [ "$ARCH" = "um" ] ; then
165 mv "$tmpdir/lib/modules/$version"/* "$tmpdir/usr/lib/uml/modules/$version/"
166 rmdir "$tmpdir/lib/modules/$version"
168 if [ -n "$BUILD_DEBUG" ] ; then
169 for module
in $
(find $tmpdir/lib
/modules
/ -name *.ko
-printf '%P\n'); do
170 module
=lib
/modules
/$module
171 mkdir
-p $
(dirname $dbg_dir/usr
/lib
/debug
/$module)
172 # only keep debug symbols in the debug file
173 $OBJCOPY --only-keep-debug $tmpdir/$module $dbg_dir/usr
/lib
/debug
/$module
174 # strip original module from debug symbols
175 $OBJCOPY --strip-debug $tmpdir/$module
176 # then add a link to those
177 $OBJCOPY --add-gnu-debuglink=$dbg_dir/usr
/lib
/debug
/$module $tmpdir/$module
180 # resign stripped modules
181 MODULE_SIG_ALL
="$(grep -s '^CONFIG_MODULE_SIG_ALL=y' $KCONFIG_CONFIG || true)"
182 if [ -n "$MODULE_SIG_ALL" ]; then
183 INSTALL_MOD_PATH
="$tmpdir" $MAKE KBUILD_SRC
= modules_sign
188 if [ "$ARCH" != "um" ]; then
189 $MAKE headers_check KBUILD_SRC
=
190 $MAKE headers_install KBUILD_SRC
= INSTALL_HDR_PATH
="$libc_headers_dir/usr"
193 # Install the maintainer scripts
194 # Note: hook scripts under /etc/kernel are also executed by official Debian
195 # kernel packages, as well as kernel packages built using make-kpkg.
196 # make-kpkg sets $INITRD to indicate whether an initramfs is wanted, and
197 # so do we; recent versions of dracut and initramfs-tools will obey this.
198 debhookdir
=${KDEB_HOOKDIR:-/etc/kernel}
199 if grep -q '^CONFIG_BLK_DEV_INITRD=y' $KCONFIG_CONFIG; then
204 for script in postinst postrm preinst prerm
; do
205 mkdir
-p "$tmpdir$debhookdir/$script.d"
206 cat <<EOF > "$tmpdir/DEBIAN/$script"
211 # Pass maintainer script parameters to hook scripts
212 export DEB_MAINT_PARAMS="\$*"
214 # Tell initramfs builder whether it's wanted
215 export INITRD=$want_initrd
217 test -d $debhookdir/$script.d && run-parts --arg="$version" --arg="/$installed_image_path" $debhookdir/$script.d
220 chmod 755 "$tmpdir/DEBIAN/$script"
223 # Try to determine maintainer and email values
224 if [ -n "$DEBEMAIL" ]; then
226 elif [ -n "$EMAIL" ]; then
229 email
=$
(id
-nu)@$
(hostname
-f 2>/dev
/null || hostname
)
231 if [ -n "$DEBFULLNAME" ]; then
233 elif [ -n "$NAME" ]; then
238 maintainer
="$name <$email>"
240 # Try to determine distribution
241 if [ -n "$KDEB_CHANGELOG_DIST" ]; then
242 distribution
=$KDEB_CHANGELOG_DIST
243 # In some cases lsb_release returns the codename as n/a, which breaks dpkg-parsechangelog
244 elif distribution
=$
(lsb_release
-cs 2>/dev
/null
) && [ -n "$distribution" ] && [ "$distribution" != "n/a" ]; then
245 : # nothing to do in this case
247 distribution
="unstable"
248 echo >&2 "Using default distribution of 'unstable' in the changelog"
249 echo >&2 "Install lsb-release or set \$KDEB_CHANGELOG_DIST explicitly"
252 # Generate a simple changelog template
253 cat <<EOF > debian/changelog
254 $sourcename ($packageversion) $distribution; urgency=low
256 * Custom built Linux kernel.
258 -- $maintainer $(date -R)
261 # Generate copyright file
262 cat <<EOF > debian/copyright
263 This is a packacked upstream version of the Linux kernel.
265 The sources may be found at most Linux ftp sites, including:
266 ftp://ftp.kernel.org/pub/linux/kernel
268 Copyright: 1991 - 2015 Linus Torvalds and others.
270 The git repository for mainline kernel development is at:
271 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
273 This program is free software; you can redistribute it and/or modify
274 it under the terms of the GNU General Public License as published by
275 the Free Software Foundation; version 2 dated June, 1991.
277 On Debian GNU/Linux systems, the complete text of the GNU General Public
278 License version 2 can be found in \`/usr/share/common-licenses/GPL-2'.
282 build_depends
="bc, kmod, cpio "
284 # Generate a control file
285 cat <<EOF > debian/control
289 Maintainer: $maintainer
290 Build-Depends: $build_depends
291 Standards-Version: 3.8.4
292 Homepage: http://www.kernel.org/
295 if [ "$ARCH" = "um" ]; then
296 cat <<EOF >> debian/control
298 Package: $packagename
299 Provides: linux-image, linux-image-2.6, linux-modules-$version
301 Description: User Mode Linux kernel, version $version
302 User-mode Linux is a port of the Linux kernel to its own system call
303 interface. It provides a kind of virtual machine, which runs Linux
304 as a user process under another Linux kernel. This is useful for
305 kernel development, sandboxes, jails, experimentation, and
308 This package contains the Linux kernel, modules and corresponding other
309 files, version: $version.
313 cat <<EOF >> debian/control
315 Package: $packagename
316 Provides: linux-image, linux-image-2.6, linux-modules-$version
317 Suggests: $fwpackagename
319 Description: Linux kernel, version $version
320 This package contains the Linux kernel, modules and corresponding other
321 files, version: $version.
326 # Build kernel header package
327 (cd $srctree; find .
-name Makefile\
* -o -name Kconfig\
* -o -name \
*.pl
) > "$objtree/debian/hdrsrcfiles"
328 (cd $srctree; find arch
/*/include include scripts
-type f
) >> "$objtree/debian/hdrsrcfiles"
329 (cd $srctree; find arch
/$SRCARCH -name module.lds
-o -name Kbuild.platforms
-o -name Platform
) >> "$objtree/debian/hdrsrcfiles"
330 (cd $srctree; find $
(find arch
/$SRCARCH -name include
-o -name scripts
-type d
) -type f
) >> "$objtree/debian/hdrsrcfiles"
331 if grep -q '^CONFIG_STACK_VALIDATION=y' $KCONFIG_CONFIG ; then
332 (cd $objtree; find tools
/objtool
-type f
-executable) >> "$objtree/debian/hdrobjfiles"
334 (cd $objtree; find arch
/$SRCARCH/include Module.symvers include scripts
-type f
) >> "$objtree/debian/hdrobjfiles"
335 if grep -q '^CONFIG_GCC_PLUGINS=y' $KCONFIG_CONFIG ; then
336 (cd $objtree; find scripts
/gcc-plugins
-name \
*.so
-o -name gcc-common.h
) >> "$objtree/debian/hdrobjfiles"
338 destdir
=$kernel_headers_dir/usr
/src
/linux-headers-
$version
340 (cd $srctree; tar -c -f - -T -) < "$objtree/debian/hdrsrcfiles" |
(cd $destdir; tar -xf -)
341 (cd $objtree; tar -c -f - -T -) < "$objtree/debian/hdrobjfiles" |
(cd $destdir; tar -xf -)
342 (cd $objtree; cp $KCONFIG_CONFIG $destdir/.config
) # copy .config manually to be where it's expected to be
343 ln -sf "/usr/src/linux-headers-$version" "$kernel_headers_dir/lib/modules/$version/build"
344 rm -f "$objtree/debian/hdrsrcfiles" "$objtree/debian/hdrobjfiles"
346 cat <<EOF >> debian/control
348 Package: $kernel_headers_packagename
349 Provides: linux-headers, linux-headers-2.6
351 Description: Linux kernel headers for $KERNELRELEASE on \${kernel:debarch}
352 This package provides kernel header files for $KERNELRELEASE on \${kernel:debarch}
354 This is useful for people who need to build external modules
357 # Do we have firmware? Move it out of the way and build it into a package.
358 if [ -e "$tmpdir/lib/firmware" ]; then
359 mv "$tmpdir/lib/firmware"/* "$fwdir/lib/firmware/$version/"
360 rmdir "$tmpdir/lib/firmware"
362 cat <<EOF >> debian/control
364 Package: $fwpackagename
366 Description: Linux kernel firmware, version $version
367 This package contains firmware from the Linux kernel, version $version.
370 create_package
"$fwpackagename" "$fwdir"
373 cat <<EOF >> debian/control
375 Package: $libc_headers_packagename
377 Provides: linux-kernel-headers
379 Description: Linux support headers for userspace development
380 This package provides userspaces headers from the Linux kernel. These headers
381 are used by the installed headers for GNU glibc and other system libraries.
384 if [ "$ARCH" != "um" ]; then
385 create_package
"$kernel_headers_packagename" "$kernel_headers_dir"
386 create_package
"$libc_headers_packagename" "$libc_headers_dir"
389 create_package
"$packagename" "$tmpdir"
391 if [ -n "$BUILD_DEBUG" ] ; then
392 # Build debug package
393 # Different tools want the image in different locations
395 mkdir
-p $dbg_dir/usr
/lib
/debug
/lib
/modules
/$version/
396 cp vmlinux
$dbg_dir/usr
/lib
/debug
/lib
/modules
/$version/
398 mkdir
-p $dbg_dir/usr
/lib
/debug
/boot
/
399 ln -s ..
/lib
/modules
/$version/vmlinux
$dbg_dir/usr
/lib
/debug
/boot
/vmlinux-
$version
401 ln -s lib
/modules
/$version/vmlinux
$dbg_dir/usr
/lib
/debug
/vmlinux-
$version
403 cat <<EOF >> debian/control
405 Package: $dbg_packagename
407 Provides: linux-debug, linux-debug-$version
409 Description: Linux kernel debugging symbols for $version
410 This package will come in handy if you need to debug the kernel. It provides
411 all the necessary debug symbols for the kernel and its modules.
414 create_package
"$dbg_packagename" "$dbg_dir"
417 if [ "x$1" = "xdeb-pkg" ]
419 cat <<EOF > debian/rules
426 \$(MAKE) KDEB_SOURCENAME=${sourcename} KDEB_PKGVERSION=${packageversion} bindeb-pkg
429 rm -rf debian/*tmp debian/files
430 mv debian/ debian.backup # debian/ might be cleaned away
432 mv debian.backup debian
436 mv ${sourcename}.tar.gz ../${sourcename}_${version}.orig.
tar.gz
437 tar caf ..
/${sourcename}_${packageversion}.debian.tar.gz debian/{copyright,rules,changelog,control}
438 dpkg-source
-cdebian/control
-ldebian/changelog
--format="3.0 (custom)" --target-format="3.0 (quilt)" \
439 -b / ..
/${sourcename}_${version}.orig.tar.gz ../${sourcename}_${packageversion}.debian.
tar.gz
440 mv ${sourcename}_
${packageversion}*dsc ..
441 dpkg-genchanges
> ..
/${sourcename}_${packageversion}_${debarch}.changes
443 dpkg-genchanges
-b > ..
/${sourcename}_${packageversion}_${debarch}.changes