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"
31 dpkg-gencontrol $forcearch -Vkernel:debarch="${debarch}" -p$pname -P"$pdir"
32 dpkg --build "$pdir" ..
36 # Attempt to find the correct Debian architecture
37 case "$UTS_MACHINE" in
39 debarch="$UTS_MACHINE" ;;
45 debarch=s390$(grep -q CONFIG_64BIT=y $KCONFIG_CONFIG && echo x || true) ;;
47 debarch=$(grep -q CPU_LITTLE_ENDIAN=y $KCONFIG_CONFIG && echo ppc64el || echo powerpc) ;;
51 debarch=mips$(grep -q CPU_LITTLE_ENDIAN=y $KCONFIG_CONFIG && echo el || true) ;;
55 if grep -q CONFIG_AEABI=y $KCONFIG_CONFIG; then
56 if grep -q CONFIG_VFP=y $KCONFIG_CONFIG; then
66 debarch=$(dpkg --print-architecture)
68 echo "** ** ** WARNING ** ** **" >&2
70 echo "Your architecture doesn't have it's equivalent" >&2
71 echo "Debian userspace architecture defined!" >&2
72 echo "Falling back to using your current userspace instead!" >&2
73 echo "Please add support for $UTS_MACHINE to ${0} ..." >&2
76 if [ -n "$KBUILD_DEBARCH" ] ; then
77 debarch="$KBUILD_DEBARCH"
79 forcearch="-DArchitecture=$debarch"
83 # Some variables and settings used throughout the script
84 version=$KERNELRELEASE
85 revision=$(cat .version)
86 if [ -n "$KDEB_PKGVERSION" ]; then
87 packageversion=$KDEB_PKGVERSION
89 packageversion=$version-$revision
91 sourcename=$KDEB_SOURCENAME
92 tmpdir="$objtree/debian/tmp"
93 fwdir="$objtree/debian/fwtmp"
94 kernel_headers_dir="$objtree/debian/hdrtmp"
95 libc_headers_dir="$objtree/debian/headertmp"
96 dbg_dir="$objtree/debian/dbgtmp"
97 packagename=linux-image-$version
98 fwpackagename=linux-firmware-image-$version
99 kernel_headers_packagename=linux-headers-$version
100 libc_headers_packagename=linux-libc-dev
101 dbg_packagename=$packagename-dbg
106 if [ "$ARCH" = "um" ] ; then
107 packagename=user-mode-linux-$version
110 # Not all arches have the same installed path in debian
111 # XXX: have each arch Makefile export a variable of the canonical image install
115 installed_image_path="usr/bin/linux-$version"
118 installed_image_path="boot/vmlinux-$version"
121 installed_image_path="boot/vmlinuz-$version"
124 BUILD_DEBUG="$(grep -s '^CONFIG_DEBUG_INFO=y' $KCONFIG_CONFIG || true)"
126 # Setup the directory structure
127 rm -rf "$tmpdir" "$fwdir" "$kernel_headers_dir" "$libc_headers_dir" "$dbg_dir" $objtree/debian/files
128 mkdir -m 755 -p "$tmpdir/DEBIAN"
129 mkdir -p "$tmpdir/lib" "$tmpdir/boot"
130 mkdir -p "$fwdir/lib/firmware/$version/"
131 mkdir -p "$kernel_headers_dir/lib/modules/$version/"
133 # Build and install the kernel
134 if [ "$ARCH" = "um" ] ; then
135 mkdir -p "$tmpdir/usr/lib/uml/modules/$version" "$tmpdir/usr/bin" "$tmpdir/usr/share/doc/$packagename"
137 cp System.map "$tmpdir/usr/lib/uml/modules/$version/System.map"
138 cp $KCONFIG_CONFIG "$tmpdir/usr/share/doc/$packagename/config"
139 gzip "$tmpdir/usr/share/doc/$packagename/config"
141 cp System.map "$tmpdir/boot/System.map-$version"
142 cp $KCONFIG_CONFIG "$tmpdir/boot/config-$version"
144 # Not all arches include the boot path in KBUILD_IMAGE
145 if [ -e $KBUILD_IMAGE ]; then
146 cp $KBUILD_IMAGE "$tmpdir/$installed_image_path"
148 cp arch/$ARCH/boot/$KBUILD_IMAGE "$tmpdir/$installed_image_path"
151 if grep -q "^CONFIG_OF=y" $KCONFIG_CONFIG ; then
152 # Only some architectures with OF support have this target
153 if grep -q dtbs_install "${srctree}/arch/$SRCARCH/Makefile"; then
154 $MAKE KBUILD_SRC= INSTALL_DTBS_PATH="$tmpdir/usr/lib/$packagename" dtbs_install
158 if grep -q '^CONFIG_MODULES=y' $KCONFIG_CONFIG ; then
159 INSTALL_MOD_PATH="$tmpdir" $MAKE KBUILD_SRC= modules_install
160 rm -f "$tmpdir/lib/modules/$version/build"
161 rm -f "$tmpdir/lib/modules/$version/source"
162 if [ "$ARCH" = "um" ] ; then
163 mv "$tmpdir/lib/modules/$version"/* "$tmpdir/usr/lib/uml/modules/$version/"
164 rmdir "$tmpdir/lib/modules/$version"
166 if [ -n "$BUILD_DEBUG" ] ; then
167 for module in $(find $tmpdir/lib/modules/ -name *.ko -printf '%P\n'); do
168 module=lib/modules/$module
169 mkdir -p $(dirname $dbg_dir/usr/lib/debug/$module)
170 # only keep debug symbols in the debug file
171 $OBJCOPY --only-keep-debug $tmpdir/$module $dbg_dir/usr/lib/debug/$module
172 # strip original module from debug symbols
173 $OBJCOPY --strip-debug $tmpdir/$module
174 # then add a link to those
175 $OBJCOPY --add-gnu-debuglink=$dbg_dir/usr/lib/debug/$module $tmpdir/$module
178 # resign stripped modules
179 MODULE_SIG_ALL="$(grep -s '^CONFIG_MODULE_SIG_ALL=y' $KCONFIG_CONFIG || true)"
180 if [ -n "$MODULE_SIG_ALL" ]; then
181 INSTALL_MOD_PATH="$tmpdir" $MAKE KBUILD_SRC= modules_sign
186 if [ "$ARCH" != "um" ]; then
187 $MAKE headers_check KBUILD_SRC=
188 $MAKE headers_install KBUILD_SRC= INSTALL_HDR_PATH="$libc_headers_dir/usr"
191 # Install the maintainer scripts
192 # Note: hook scripts under /etc/kernel are also executed by official Debian
193 # kernel packages, as well as kernel packages built using make-kpkg.
194 # make-kpkg sets $INITRD to indicate whether an initramfs is wanted, and
195 # so do we; recent versions of dracut and initramfs-tools will obey this.
196 debhookdir=${KDEB_HOOKDIR:-/etc/kernel}
197 if grep -q '^CONFIG_BLK_DEV_INITRD=y' $KCONFIG_CONFIG; then
202 for script in postinst postrm preinst prerm ; do
203 mkdir -p "$tmpdir$debhookdir/$script.d"
204 cat <<EOF > "$tmpdir/DEBIAN/$script"
209 # Pass maintainer script parameters to hook scripts
210 export DEB_MAINT_PARAMS="\$*"
212 # Tell initramfs builder whether it's wanted
213 export INITRD=$want_initrd
215 test -d $debhookdir/$script.d && run-parts --arg="$version" --arg="/$installed_image_path" $debhookdir/$script.d
218 chmod 755 "$tmpdir/DEBIAN/$script"
221 # Try to determine maintainer and email values
222 if [ -n "$DEBEMAIL" ]; then
224 elif [ -n "$EMAIL" ]; then
227 email=$(id -nu)@$(hostname -f 2>/dev/null || hostname)
229 if [ -n "$DEBFULLNAME" ]; then
231 elif [ -n "$NAME" ]; then
236 maintainer="$name <$email>"
238 # Try to determine distribution
239 if [ -n "$KDEB_CHANGELOG_DIST" ]; then
240 distribution=$KDEB_CHANGELOG_DIST
241 elif distribution=$(lsb_release -cs 2>/dev/null) && [ -n "$distribution" ]; then
242 : # nothing to do in this case
244 distribution="unstable"
245 echo >&2 "Using default distribution of 'unstable' in the changelog"
246 echo >&2 "Install lsb-release or set \$KDEB_CHANGELOG_DIST explicitly"
249 # Generate a simple changelog template
250 cat <<EOF > debian/changelog
251 $sourcename ($packageversion) $distribution; urgency=low
253 * Custom built Linux kernel.
255 -- $maintainer $(date -R)
258 # Generate copyright file
259 cat <<EOF > debian/copyright
260 This is a packacked upstream version of the Linux kernel.
262 The sources may be found at most Linux ftp sites, including:
263 ftp://ftp.kernel.org/pub/linux/kernel
265 Copyright: 1991 - 2015 Linus Torvalds and others.
267 The git repository for mainline kernel development is at:
268 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
270 This program is free software; you can redistribute it and/or modify
271 it under the terms of the GNU General Public License as published by
272 the Free Software Foundation; version 2 dated June, 1991.
274 On Debian GNU/Linux systems, the complete text of the GNU General Public
275 License version 2 can be found in \`/usr/share/common-licenses/GPL-2'.
279 build_depends="bc, kmod, cpio "
281 # Generate a control file
282 cat <<EOF > debian/control
286 Maintainer: $maintainer
287 Build-Depends: $build_depends
288 Standards-Version: 3.8.4
289 Homepage: http://www.kernel.org/
292 if [ "$ARCH" = "um" ]; then
293 cat <<EOF >> debian/control
295 Package: $packagename
296 Provides: linux-image, linux-image-2.6, linux-modules-$version
298 Description: User Mode Linux kernel, version $version
299 User-mode Linux is a port of the Linux kernel to its own system call
300 interface. It provides a kind of virtual machine, which runs Linux
301 as a user process under another Linux kernel. This is useful for
302 kernel development, sandboxes, jails, experimentation, and
305 This package contains the Linux kernel, modules and corresponding other
306 files, version: $version.
310 cat <<EOF >> debian/control
312 Package: $packagename
313 Provides: linux-image, linux-image-2.6, linux-modules-$version
314 Suggests: $fwpackagename
316 Description: Linux kernel, version $version
317 This package contains the Linux kernel, modules and corresponding other
318 files, version: $version.
323 # Build kernel header package
324 (cd $srctree; find . -name Makefile\* -o -name Kconfig\* -o -name \*.pl) > "$objtree/debian/hdrsrcfiles"
325 if grep -q '^CONFIG_STACK_VALIDATION=y' $KCONFIG_CONFIG ; then
326 (cd $srctree; find tools/objtool -type f -executable) >> "$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 (cd $objtree; find arch/$SRCARCH/include Module.symvers include scripts -type f) >> "$objtree/debian/hdrobjfiles"
332 destdir=$kernel_headers_dir/usr/src/linux-headers-$version
334 (cd $srctree; tar -c -f - -T -) < "$objtree/debian/hdrsrcfiles" | (cd $destdir; tar -xf -)
335 (cd $objtree; tar -c -f - -T -) < "$objtree/debian/hdrobjfiles" | (cd $destdir; tar -xf -)
336 (cd $objtree; cp $KCONFIG_CONFIG $destdir/.config) # copy .config manually to be where it's expected to be
337 ln -sf "/usr/src/linux-headers-$version" "$kernel_headers_dir/lib/modules/$version/build"
338 rm -f "$objtree/debian/hdrsrcfiles" "$objtree/debian/hdrobjfiles"
340 cat <<EOF >> debian/control
342 Package: $kernel_headers_packagename
343 Provides: linux-headers, linux-headers-2.6
345 Description: Linux kernel headers for $KERNELRELEASE on \${kernel:debarch}
346 This package provides kernel header files for $KERNELRELEASE on \${kernel:debarch}
348 This is useful for people who need to build external modules
351 # Do we have firmware? Move it out of the way and build it into a package.
352 if [ -e "$tmpdir/lib/firmware" ]; then
353 mv "$tmpdir/lib/firmware"/* "$fwdir/lib/firmware/$version/"
354 rmdir "$tmpdir/lib/firmware"
356 cat <<EOF >> debian/control
358 Package: $fwpackagename
360 Description: Linux kernel firmware, version $version
361 This package contains firmware from the Linux kernel, version $version.
364 create_package "$fwpackagename" "$fwdir"
367 cat <<EOF >> debian/control
369 Package: $libc_headers_packagename
371 Provides: linux-kernel-headers
373 Description: Linux support headers for userspace development
374 This package provides userspaces headers from the Linux kernel. These headers
375 are used by the installed headers for GNU glibc and other system libraries.
378 if [ "$ARCH" != "um" ]; then
379 create_package "$kernel_headers_packagename" "$kernel_headers_dir"
380 create_package "$libc_headers_packagename" "$libc_headers_dir"
383 create_package "$packagename" "$tmpdir"
385 if [ -n "$BUILD_DEBUG" ] ; then
386 # Build debug package
387 # Different tools want the image in different locations
389 mkdir -p $dbg_dir/usr/lib/debug/lib/modules/$version/
390 cp vmlinux $dbg_dir/usr/lib/debug/lib/modules/$version/
392 mkdir -p $dbg_dir/usr/lib/debug/boot/
393 ln -s ../lib/modules/$version/vmlinux $dbg_dir/usr/lib/debug/boot/vmlinux-$version
395 ln -s lib/modules/$version/vmlinux $dbg_dir/usr/lib/debug/vmlinux-$version
397 cat <<EOF >> debian/control
399 Package: $dbg_packagename
401 Provides: linux-debug, linux-debug-$version
403 Description: Linux kernel debugging symbols for $version
404 This package will come in handy if you need to debug the kernel. It provides
405 all the necessary debug symbols for the kernel and its modules.
408 create_package "$dbg_packagename" "$dbg_dir"
411 if [ "x$1" = "xdeb-pkg" ]
413 cat <<EOF > debian/rules
420 \$(MAKE) KDEB_SOURCENAME=${sourcename} KDEB_PKGVERSION=${packageversion} bindeb-pkg
423 rm -rf debian/*tmp debian/files
424 mv debian/ debian.backup # debian/ might be cleaned away
426 mv debian.backup debian
430 mv ${sourcename}.tar.gz ../${sourcename}_${version}.orig.tar.gz
431 tar caf ../${sourcename}_${packageversion}.debian.tar.gz debian/{copyright,rules,changelog,control}
432 dpkg-source -cdebian/control -ldebian/changelog --format="3.0 (custom)" --target-format="3.0 (quilt)" \
433 -b / ../${sourcename}_${version}.orig.tar.gz ../${sourcename}_${packageversion}.debian.tar.gz
434 mv ${sourcename}_${packageversion}*dsc ..
435 dpkg-genchanges > ../${sourcename}_${packageversion}_${debarch}.changes
437 dpkg-genchanges -b > ../${sourcename}_${packageversion}_${debarch}.changes