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 its 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 cp "$($MAKE -s image_name)" "$tmpdir/$installed_image_path"
148 if grep -q "^CONFIG_OF=y" $KCONFIG_CONFIG ; then
149 # Only some architectures with OF support have this target
150 if grep -q dtbs_install "${srctree}/arch/$SRCARCH/Makefile"; then
151 $MAKE KBUILD_SRC= INSTALL_DTBS_PATH="$tmpdir/usr/lib/$packagename" dtbs_install
155 if grep -q '^CONFIG_MODULES=y' $KCONFIG_CONFIG ; then
156 INSTALL_MOD_PATH="$tmpdir" $MAKE KBUILD_SRC= modules_install
157 rm -f "$tmpdir/lib/modules/$version/build"
158 rm -f "$tmpdir/lib/modules/$version/source"
159 if [ "$ARCH" = "um" ] ; then
160 mv "$tmpdir/lib/modules/$version"/* "$tmpdir/usr/lib/uml/modules/$version/"
161 rmdir "$tmpdir/lib/modules/$version"
163 if [ -n "$BUILD_DEBUG" ] ; then
164 for module in $(find $tmpdir/lib/modules/ -name *.ko -printf '%P\n'); do
165 module=lib/modules/$module
166 mkdir -p $(dirname $dbg_dir/usr/lib/debug/$module)
167 # only keep debug symbols in the debug file
168 $OBJCOPY --only-keep-debug $tmpdir/$module $dbg_dir/usr/lib/debug/$module
169 # strip original module from debug symbols
170 $OBJCOPY --strip-debug $tmpdir/$module
171 # then add a link to those
172 $OBJCOPY --add-gnu-debuglink=$dbg_dir/usr/lib/debug/$module $tmpdir/$module
175 # resign stripped modules
176 MODULE_SIG_ALL="$(grep -s '^CONFIG_MODULE_SIG_ALL=y' $KCONFIG_CONFIG || true)"
177 if [ -n "$MODULE_SIG_ALL" ]; then
178 INSTALL_MOD_PATH="$tmpdir" $MAKE KBUILD_SRC= modules_sign
183 if [ "$ARCH" != "um" ]; then
184 $MAKE headers_check KBUILD_SRC=
185 $MAKE headers_install KBUILD_SRC= INSTALL_HDR_PATH="$libc_headers_dir/usr"
188 # Install the maintainer scripts
189 # Note: hook scripts under /etc/kernel are also executed by official Debian
190 # kernel packages, as well as kernel packages built using make-kpkg.
191 # make-kpkg sets $INITRD to indicate whether an initramfs is wanted, and
192 # so do we; recent versions of dracut and initramfs-tools will obey this.
193 debhookdir=${KDEB_HOOKDIR:-/etc/kernel}
194 if grep -q '^CONFIG_BLK_DEV_INITRD=y' $KCONFIG_CONFIG; then
199 for script in postinst postrm preinst prerm ; do
200 mkdir -p "$tmpdir$debhookdir/$script.d"
201 cat <<EOF > "$tmpdir/DEBIAN/$script"
206 # Pass maintainer script parameters to hook scripts
207 export DEB_MAINT_PARAMS="\$*"
209 # Tell initramfs builder whether it's wanted
210 export INITRD=$want_initrd
212 test -d $debhookdir/$script.d && run-parts --arg="$version" --arg="/$installed_image_path" $debhookdir/$script.d
215 chmod 755 "$tmpdir/DEBIAN/$script"
218 # Try to determine maintainer and email values
219 if [ -n "$DEBEMAIL" ]; then
221 elif [ -n "$EMAIL" ]; then
224 email=$(id -nu)@$(hostname -f 2>/dev/null || hostname)
226 if [ -n "$DEBFULLNAME" ]; then
228 elif [ -n "$NAME" ]; then
233 maintainer="$name <$email>"
235 # Try to determine distribution
236 if [ -n "$KDEB_CHANGELOG_DIST" ]; then
237 distribution=$KDEB_CHANGELOG_DIST
238 # In some cases lsb_release returns the codename as n/a, which breaks dpkg-parsechangelog
239 elif distribution=$(lsb_release -cs 2>/dev/null) && [ -n "$distribution" ] && [ "$distribution" != "n/a" ]; then
240 : # nothing to do in this case
242 distribution="unstable"
243 echo >&2 "Using default distribution of 'unstable' in the changelog"
244 echo >&2 "Install lsb-release or set \$KDEB_CHANGELOG_DIST explicitly"
247 # Generate a simple changelog template
248 cat <<EOF > debian/changelog
249 $sourcename ($packageversion) $distribution; urgency=low
251 * Custom built Linux kernel.
253 -- $maintainer $(date -R)
256 # Generate copyright file
257 cat <<EOF > debian/copyright
258 This is a packacked upstream version of the Linux kernel.
260 The sources may be found at most Linux archive sites, including:
261 https://www.kernel.org/pub/linux/kernel
263 Copyright: 1991 - 2017 Linus Torvalds and others.
265 The git repository for mainline kernel development is at:
266 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
268 This program is free software; you can redistribute it and/or modify
269 it under the terms of the GNU General Public License as published by
270 the Free Software Foundation; version 2 dated June, 1991.
272 On Debian GNU/Linux systems, the complete text of the GNU General Public
273 License version 2 can be found in \`/usr/share/common-licenses/GPL-2'.
277 build_depends="bc, kmod, cpio "
279 # Generate a control file
280 cat <<EOF > debian/control
284 Maintainer: $maintainer
285 Build-Depends: $build_depends
286 Homepage: http://www.kernel.org/
289 if [ "$ARCH" = "um" ]; then
290 cat <<EOF >> debian/control
292 Package: $packagename
294 Description: User Mode Linux kernel, version $version
295 User-mode Linux is a port of the Linux kernel to its own system call
296 interface. It provides a kind of virtual machine, which runs Linux
297 as a user process under another Linux kernel. This is useful for
298 kernel development, sandboxes, jails, experimentation, and
301 This package contains the Linux kernel, modules and corresponding other
302 files, version: $version.
306 cat <<EOF >> debian/control
308 Package: $packagename
309 Suggests: $fwpackagename
311 Description: Linux kernel, version $version
312 This package contains the Linux kernel, modules and corresponding other
313 files, version: $version.
318 # Build kernel header package
319 (cd $srctree; find . -name Makefile\* -o -name Kconfig\* -o -name \*.pl) > "$objtree/debian/hdrsrcfiles"
320 (cd $srctree; find arch/*/include include scripts -type f) >> "$objtree/debian/hdrsrcfiles"
321 (cd $srctree; find arch/$SRCARCH -name module.lds -o -name Kbuild.platforms -o -name Platform) >> "$objtree/debian/hdrsrcfiles"
322 (cd $srctree; find $(find arch/$SRCARCH -name include -o -name scripts -type d) -type f) >> "$objtree/debian/hdrsrcfiles"
323 if grep -q '^CONFIG_STACK_VALIDATION=y' $KCONFIG_CONFIG ; then
324 (cd $objtree; find tools/objtool -type f -executable) >> "$objtree/debian/hdrobjfiles"
326 (cd $objtree; find arch/$SRCARCH/include Module.symvers include scripts -type f) >> "$objtree/debian/hdrobjfiles"
327 if grep -q '^CONFIG_GCC_PLUGINS=y' $KCONFIG_CONFIG ; then
328 (cd $objtree; find scripts/gcc-plugins -name \*.so -o -name gcc-common.h) >> "$objtree/debian/hdrobjfiles"
330 destdir=$kernel_headers_dir/usr/src/linux-headers-$version
332 (cd $srctree; tar -c -f - -T -) < "$objtree/debian/hdrsrcfiles" | (cd $destdir; tar -xf -)
333 (cd $objtree; tar -c -f - -T -) < "$objtree/debian/hdrobjfiles" | (cd $destdir; tar -xf -)
334 (cd $objtree; cp $KCONFIG_CONFIG $destdir/.config) # copy .config manually to be where it's expected to be
335 ln -sf "/usr/src/linux-headers-$version" "$kernel_headers_dir/lib/modules/$version/build"
336 rm -f "$objtree/debian/hdrsrcfiles" "$objtree/debian/hdrobjfiles"
338 cat <<EOF >> debian/control
340 Package: $kernel_headers_packagename
342 Description: Linux kernel headers for $KERNELRELEASE on \${kernel:debarch}
343 This package provides kernel header files for $KERNELRELEASE on \${kernel:debarch}
345 This is useful for people who need to build external modules
348 # Do we have firmware? Move it out of the way and build it into a package.
349 if [ -e "$tmpdir/lib/firmware" ]; then
350 mv "$tmpdir/lib/firmware"/* "$fwdir/lib/firmware/$version/"
351 rmdir "$tmpdir/lib/firmware"
353 cat <<EOF >> debian/control
355 Package: $fwpackagename
357 Description: Linux kernel firmware, version $version
358 This package contains firmware from the Linux kernel, version $version.
361 create_package "$fwpackagename" "$fwdir"
364 cat <<EOF >> debian/control
366 Package: $libc_headers_packagename
368 Provides: linux-kernel-headers
370 Description: Linux support headers for userspace development
371 This package provides userspaces headers from the Linux kernel. These headers
372 are used by the installed headers for GNU glibc and other system libraries.
375 if [ "$ARCH" != "um" ]; then
376 create_package "$kernel_headers_packagename" "$kernel_headers_dir"
377 create_package "$libc_headers_packagename" "$libc_headers_dir"
380 create_package "$packagename" "$tmpdir"
382 if [ -n "$BUILD_DEBUG" ] ; then
383 # Build debug package
384 # Different tools want the image in different locations
386 mkdir -p $dbg_dir/usr/lib/debug/lib/modules/$version/
387 cp vmlinux $dbg_dir/usr/lib/debug/lib/modules/$version/
389 mkdir -p $dbg_dir/usr/lib/debug/boot/
390 ln -s ../lib/modules/$version/vmlinux $dbg_dir/usr/lib/debug/boot/vmlinux-$version
392 ln -s lib/modules/$version/vmlinux $dbg_dir/usr/lib/debug/vmlinux-$version
394 cat <<EOF >> debian/control
396 Package: $dbg_packagename
399 Description: Linux kernel debugging symbols for $version
400 This package will come in handy if you need to debug the kernel. It provides
401 all the necessary debug symbols for the kernel and its modules.
404 create_package "$dbg_packagename" "$dbg_dir"
407 if [ "x$1" = "xdeb-pkg" ]
409 cat <<EOF > debian/rules
416 \$(MAKE) KDEB_SOURCENAME=${sourcename} KDEB_PKGVERSION=${packageversion} bindeb-pkg
419 rm -rf debian/*tmp debian/files
420 mv debian/ debian.backup # debian/ might be cleaned away
422 mv debian.backup debian
426 mv ${sourcename}.tar.gz ../${sourcename}_${version}.orig.tar.gz
427 tar caf ../${sourcename}_${packageversion}.debian.tar.gz debian/{copyright,rules,changelog,control}
428 dpkg-source -cdebian/control -ldebian/changelog --format="3.0 (custom)" --target-format="3.0 (quilt)" \
429 -b / ../${sourcename}_${version}.orig.tar.gz ../${sourcename}_${packageversion}.debian.tar.gz
430 mv ${sourcename}_${packageversion}*dsc ..
431 dpkg-genchanges > ../${sourcename}_${packageversion}_${debarch}.changes
433 dpkg-genchanges -b > ../${sourcename}_${packageversion}_${debarch}.changes