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 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 kernel_headers_dir
="$objtree/debian/hdrtmp"
96 libc_headers_dir
="$objtree/debian/headertmp"
97 dbg_dir
="$objtree/debian/dbgtmp"
98 packagename
=linux-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" "$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 "$kernel_headers_dir/lib/modules/$version/"
132 # Build and install the kernel
133 if [ "$ARCH" = "um" ] ; then
134 mkdir
-p "$tmpdir/usr/lib/uml/modules/$version" "$tmpdir/usr/bin" "$tmpdir/usr/share/doc/$packagename"
136 cp System.map
"$tmpdir/usr/lib/uml/modules/$version/System.map"
137 cp $KCONFIG_CONFIG "$tmpdir/usr/share/doc/$packagename/config"
138 gzip "$tmpdir/usr/share/doc/$packagename/config"
140 cp System.map
"$tmpdir/boot/System.map-$version"
141 cp $KCONFIG_CONFIG "$tmpdir/boot/config-$version"
143 cp "$($MAKE -s image_name)" "$tmpdir/$installed_image_path"
145 if grep -q "^CONFIG_OF=y" $KCONFIG_CONFIG ; then
146 # Only some architectures with OF support have this target
147 if grep -q dtbs_install
"${srctree}/arch/$SRCARCH/Makefile"; then
148 $MAKE KBUILD_SRC
= INSTALL_DTBS_PATH
="$tmpdir/usr/lib/$packagename" dtbs_install
152 if grep -q '^CONFIG_MODULES=y' $KCONFIG_CONFIG ; then
153 INSTALL_MOD_PATH
="$tmpdir" $MAKE KBUILD_SRC
= modules_install
154 rm -f "$tmpdir/lib/modules/$version/build"
155 rm -f "$tmpdir/lib/modules/$version/source"
156 if [ "$ARCH" = "um" ] ; then
157 mv "$tmpdir/lib/modules/$version"/* "$tmpdir/usr/lib/uml/modules/$version/"
158 rmdir "$tmpdir/lib/modules/$version"
160 if [ -n "$BUILD_DEBUG" ] ; then
161 for module
in $
(find $tmpdir/lib
/modules
/ -name *.ko
-printf '%P\n'); do
162 module
=lib
/modules
/$module
163 mkdir
-p $
(dirname $dbg_dir/usr
/lib
/debug
/$module)
164 # only keep debug symbols in the debug file
165 $OBJCOPY --only-keep-debug $tmpdir/$module $dbg_dir/usr
/lib
/debug
/$module
166 # strip original module from debug symbols
167 $OBJCOPY --strip-debug $tmpdir/$module
168 # then add a link to those
169 $OBJCOPY --add-gnu-debuglink=$dbg_dir/usr
/lib
/debug
/$module $tmpdir/$module
172 # resign stripped modules
173 MODULE_SIG_ALL
="$(grep -s '^CONFIG_MODULE_SIG_ALL=y' $KCONFIG_CONFIG || true)"
174 if [ -n "$MODULE_SIG_ALL" ]; then
175 INSTALL_MOD_PATH
="$tmpdir" $MAKE KBUILD_SRC
= modules_sign
180 if [ "$ARCH" != "um" ]; then
181 $MAKE headers_check KBUILD_SRC
=
182 $MAKE headers_install KBUILD_SRC
= INSTALL_HDR_PATH
="$libc_headers_dir/usr"
185 # Install the maintainer scripts
186 # Note: hook scripts under /etc/kernel are also executed by official Debian
187 # kernel packages, as well as kernel packages built using make-kpkg.
188 # make-kpkg sets $INITRD to indicate whether an initramfs is wanted, and
189 # so do we; recent versions of dracut and initramfs-tools will obey this.
190 debhookdir
=${KDEB_HOOKDIR:-/etc/kernel}
191 if grep -q '^CONFIG_BLK_DEV_INITRD=y' $KCONFIG_CONFIG; then
196 for script in postinst postrm preinst prerm
; do
197 mkdir
-p "$tmpdir$debhookdir/$script.d"
198 cat <<EOF > "$tmpdir/DEBIAN/$script"
203 # Pass maintainer script parameters to hook scripts
204 export DEB_MAINT_PARAMS="\$*"
206 # Tell initramfs builder whether it's wanted
207 export INITRD=$want_initrd
209 test -d $debhookdir/$script.d && run-parts --arg="$version" --arg="/$installed_image_path" $debhookdir/$script.d
212 chmod 755 "$tmpdir/DEBIAN/$script"
215 # Try to determine maintainer and email values
216 if [ -n "$DEBEMAIL" ]; then
218 elif [ -n "$EMAIL" ]; then
221 email
=$
(id
-nu)@$
(hostname
-f 2>/dev
/null || hostname
)
223 if [ -n "$DEBFULLNAME" ]; then
225 elif [ -n "$NAME" ]; then
230 maintainer
="$name <$email>"
232 # Try to determine distribution
233 if [ -n "$KDEB_CHANGELOG_DIST" ]; then
234 distribution
=$KDEB_CHANGELOG_DIST
235 # In some cases lsb_release returns the codename as n/a, which breaks dpkg-parsechangelog
236 elif distribution
=$
(lsb_release
-cs 2>/dev
/null
) && [ -n "$distribution" ] && [ "$distribution" != "n/a" ]; then
237 : # nothing to do in this case
239 distribution
="unstable"
240 echo >&2 "Using default distribution of 'unstable' in the changelog"
241 echo >&2 "Install lsb-release or set \$KDEB_CHANGELOG_DIST explicitly"
244 # Generate a simple changelog template
245 cat <<EOF > debian/changelog
246 $sourcename ($packageversion) $distribution; urgency=low
248 * Custom built Linux kernel.
250 -- $maintainer $(date -R)
253 # Generate copyright file
254 cat <<EOF > debian/copyright
255 This is a packacked upstream version of the Linux kernel.
257 The sources may be found at most Linux archive sites, including:
258 https://www.kernel.org/pub/linux/kernel
260 Copyright: 1991 - 2017 Linus Torvalds and others.
262 The git repository for mainline kernel development is at:
263 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
265 This program is free software; you can redistribute it and/or modify
266 it under the terms of the GNU General Public License as published by
267 the Free Software Foundation; version 2 dated June, 1991.
269 On Debian GNU/Linux systems, the complete text of the GNU General Public
270 License version 2 can be found in \`/usr/share/common-licenses/GPL-2'.
274 build_depends
="bc, kmod, cpio "
276 # Generate a control file
277 cat <<EOF > debian/control
281 Maintainer: $maintainer
282 Build-Depends: $build_depends
283 Homepage: http://www.kernel.org/
286 if [ "$ARCH" = "um" ]; then
287 cat <<EOF >> debian/control
289 Package: $packagename
291 Description: User Mode Linux kernel, version $version
292 User-mode Linux is a port of the Linux kernel to its own system call
293 interface. It provides a kind of virtual machine, which runs Linux
294 as a user process under another Linux kernel. This is useful for
295 kernel development, sandboxes, jails, experimentation, and
298 This package contains the Linux kernel, modules and corresponding other
299 files, version: $version.
303 cat <<EOF >> debian/control
305 Package: $packagename
307 Description: Linux kernel, version $version
308 This package contains the Linux kernel, modules and corresponding other
309 files, version: $version.
314 # Build kernel header package
315 (cd $srctree; find .
-name Makefile\
* -o -name Kconfig\
* -o -name \
*.pl
) > "$objtree/debian/hdrsrcfiles"
316 (cd $srctree; find arch
/*/include include scripts
-type f
-o -type l
) >> "$objtree/debian/hdrsrcfiles"
317 (cd $srctree; find arch
/$SRCARCH -name module.lds
-o -name Kbuild.platforms
-o -name Platform
) >> "$objtree/debian/hdrsrcfiles"
318 (cd $srctree; find $
(find arch
/$SRCARCH -name include
-o -name scripts
-type d
) -type f
) >> "$objtree/debian/hdrsrcfiles"
319 if grep -q '^CONFIG_STACK_VALIDATION=y' $KCONFIG_CONFIG ; then
320 (cd $objtree; find tools
/objtool
-type f
-executable) >> "$objtree/debian/hdrobjfiles"
322 (cd $objtree; find arch
/$SRCARCH/include Module.symvers include scripts
-type f
) >> "$objtree/debian/hdrobjfiles"
323 if grep -q '^CONFIG_GCC_PLUGINS=y' $KCONFIG_CONFIG ; then
324 (cd $objtree; find scripts
/gcc-plugins
-name \
*.so
-o -name gcc-common.h
) >> "$objtree/debian/hdrobjfiles"
326 destdir
=$kernel_headers_dir/usr
/src
/linux-headers-
$version
328 (cd $srctree; tar -c -f - -T -) < "$objtree/debian/hdrsrcfiles" |
(cd $destdir; tar -xf -)
329 (cd $objtree; tar -c -f - -T -) < "$objtree/debian/hdrobjfiles" |
(cd $destdir; tar -xf -)
330 (cd $objtree; cp $KCONFIG_CONFIG $destdir/.config
) # copy .config manually to be where it's expected to be
331 ln -sf "/usr/src/linux-headers-$version" "$kernel_headers_dir/lib/modules/$version/build"
332 rm -f "$objtree/debian/hdrsrcfiles" "$objtree/debian/hdrobjfiles"
334 cat <<EOF >> debian/control
336 Package: $kernel_headers_packagename
338 Description: Linux kernel headers for $KERNELRELEASE on \${kernel:debarch}
339 This package provides kernel header files for $KERNELRELEASE on \${kernel:debarch}
341 This is useful for people who need to build external modules
344 cat <<EOF >> debian/control
346 Package: $libc_headers_packagename
348 Provides: linux-kernel-headers
350 Description: Linux support headers for userspace development
351 This package provides userspaces headers from the Linux kernel. These headers
352 are used by the installed headers for GNU glibc and other system libraries.
355 if [ "$ARCH" != "um" ]; then
356 create_package
"$kernel_headers_packagename" "$kernel_headers_dir"
357 create_package
"$libc_headers_packagename" "$libc_headers_dir"
360 create_package
"$packagename" "$tmpdir"
362 if [ -n "$BUILD_DEBUG" ] ; then
363 # Build debug package
364 # Different tools want the image in different locations
366 mkdir
-p $dbg_dir/usr
/lib
/debug
/lib
/modules
/$version/
367 cp vmlinux
$dbg_dir/usr
/lib
/debug
/lib
/modules
/$version/
369 mkdir
-p $dbg_dir/usr
/lib
/debug
/boot
/
370 ln -s ..
/lib
/modules
/$version/vmlinux
$dbg_dir/usr
/lib
/debug
/boot
/vmlinux-
$version
372 ln -s lib
/modules
/$version/vmlinux
$dbg_dir/usr
/lib
/debug
/vmlinux-
$version
374 cat <<EOF >> debian/control
376 Package: $dbg_packagename
379 Description: Linux kernel debugging symbols for $version
380 This package will come in handy if you need to debug the kernel. It provides
381 all the necessary debug symbols for the kernel and its modules.
384 create_package
"$dbg_packagename" "$dbg_dir"
387 if [ "x$1" = "xdeb-pkg" ]
389 cat <<EOF > debian/rules
396 \$(MAKE) KDEB_SOURCENAME=${sourcename} KDEB_PKGVERSION=${packageversion} bindeb-pkg
399 rm -rf debian/*tmp debian/files
400 mv debian/ debian.backup # debian/ might be cleaned away
402 mv debian.backup debian
406 mv ${sourcename}.tar.gz ../${sourcename}_${version}.orig.
tar.gz
407 tar caf ..
/${sourcename}_${packageversion}.debian.tar.gz debian/{copyright,rules,changelog,control}
408 dpkg-source
-cdebian/control
-ldebian/changelog
--format="3.0 (custom)" --target-format="3.0 (quilt)" \
409 -b / ..
/${sourcename}_${version}.orig.tar.gz ../${sourcename}_${packageversion}.debian.
tar.gz
410 mv ${sourcename}_
${packageversion}*dsc ..
411 dpkg-genchanges
-Vkernel:debarch
="${debarch}" > ../${sourcename}_${packageversion}_${debarch}.changes
413 dpkg-genchanges -b -Vkernel:debarch="${debarch}" > ../${sourcename}_${packageversion}_${debarch}.changes