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 elif distribution
=$
(lsb_release
-cs 2>/dev
/null
) && [ -n "$distribution" ]; then
244 : # nothing to do in this case
246 distribution
="unstable"
247 echo >&2 "Using default distribution of 'unstable' in the changelog"
248 echo >&2 "Install lsb-release or set \$KDEB_CHANGELOG_DIST explicitly"
251 # Generate a simple changelog template
252 cat <<EOF > debian/changelog
253 $sourcename ($packageversion) $distribution; urgency=low
255 * Custom built Linux kernel.
257 -- $maintainer $(date -R)
260 # Generate copyright file
261 cat <<EOF > debian/copyright
262 This is a packacked upstream version of the Linux kernel.
264 The sources may be found at most Linux ftp sites, including:
265 ftp://ftp.kernel.org/pub/linux/kernel
267 Copyright: 1991 - 2015 Linus Torvalds and others.
269 The git repository for mainline kernel development is at:
270 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
272 This program is free software; you can redistribute it and/or modify
273 it under the terms of the GNU General Public License as published by
274 the Free Software Foundation; version 2 dated June, 1991.
276 On Debian GNU/Linux systems, the complete text of the GNU General Public
277 License version 2 can be found in \`/usr/share/common-licenses/GPL-2'.
281 build_depends
="bc, kmod, cpio "
283 # Generate a control file
284 cat <<EOF > debian/control
288 Maintainer: $maintainer
289 Build-Depends: $build_depends
290 Standards-Version: 3.8.4
291 Homepage: http://www.kernel.org/
294 if [ "$ARCH" = "um" ]; then
295 cat <<EOF >> debian/control
297 Package: $packagename
298 Provides: linux-image, linux-image-2.6, linux-modules-$version
300 Description: User Mode Linux kernel, version $version
301 User-mode Linux is a port of the Linux kernel to its own system call
302 interface. It provides a kind of virtual machine, which runs Linux
303 as a user process under another Linux kernel. This is useful for
304 kernel development, sandboxes, jails, experimentation, and
307 This package contains the Linux kernel, modules and corresponding other
308 files, version: $version.
312 cat <<EOF >> debian/control
314 Package: $packagename
315 Provides: linux-image, linux-image-2.6, linux-modules-$version
316 Suggests: $fwpackagename
318 Description: Linux kernel, version $version
319 This package contains the Linux kernel, modules and corresponding other
320 files, version: $version.
325 # Build kernel header package
326 (cd $srctree; find .
-name Makefile\
* -o -name Kconfig\
* -o -name \
*.pl
) > "$objtree/debian/hdrsrcfiles"
327 (cd $srctree; find arch
/*/include include scripts
-type f
) >> "$objtree/debian/hdrsrcfiles"
328 (cd $srctree; find arch
/$SRCARCH -name module.lds
-o -name Kbuild.platforms
-o -name Platform
) >> "$objtree/debian/hdrsrcfiles"
329 (cd $srctree; find $
(find arch
/$SRCARCH -name include
-o -name scripts
-type d
) -type f
) >> "$objtree/debian/hdrsrcfiles"
330 if grep -q '^CONFIG_STACK_VALIDATION=y' $KCONFIG_CONFIG ; then
331 (cd $objtree; find tools
/objtool
-type f
-executable) >> "$objtree/debian/hdrobjfiles"
333 (cd $objtree; find arch
/$SRCARCH/include Module.symvers include scripts
-type f
) >> "$objtree/debian/hdrobjfiles"
334 destdir
=$kernel_headers_dir/usr
/src
/linux-headers-
$version
336 (cd $srctree; tar -c -f - -T -) < "$objtree/debian/hdrsrcfiles" |
(cd $destdir; tar -xf -)
337 (cd $objtree; tar -c -f - -T -) < "$objtree/debian/hdrobjfiles" |
(cd $destdir; tar -xf -)
338 (cd $objtree; cp $KCONFIG_CONFIG $destdir/.config
) # copy .config manually to be where it's expected to be
339 ln -sf "/usr/src/linux-headers-$version" "$kernel_headers_dir/lib/modules/$version/build"
340 rm -f "$objtree/debian/hdrsrcfiles" "$objtree/debian/hdrobjfiles"
342 cat <<EOF >> debian/control
344 Package: $kernel_headers_packagename
345 Provides: linux-headers, linux-headers-2.6
347 Description: Linux kernel headers for $KERNELRELEASE on \${kernel:debarch}
348 This package provides kernel header files for $KERNELRELEASE on \${kernel:debarch}
350 This is useful for people who need to build external modules
353 # Do we have firmware? Move it out of the way and build it into a package.
354 if [ -e "$tmpdir/lib/firmware" ]; then
355 mv "$tmpdir/lib/firmware"/* "$fwdir/lib/firmware/$version/"
356 rmdir "$tmpdir/lib/firmware"
358 cat <<EOF >> debian/control
360 Package: $fwpackagename
362 Description: Linux kernel firmware, version $version
363 This package contains firmware from the Linux kernel, version $version.
366 create_package
"$fwpackagename" "$fwdir"
369 cat <<EOF >> debian/control
371 Package: $libc_headers_packagename
373 Provides: linux-kernel-headers
375 Description: Linux support headers for userspace development
376 This package provides userspaces headers from the Linux kernel. These headers
377 are used by the installed headers for GNU glibc and other system libraries.
380 if [ "$ARCH" != "um" ]; then
381 create_package
"$kernel_headers_packagename" "$kernel_headers_dir"
382 create_package
"$libc_headers_packagename" "$libc_headers_dir"
385 create_package
"$packagename" "$tmpdir"
387 if [ -n "$BUILD_DEBUG" ] ; then
388 # Build debug package
389 # Different tools want the image in different locations
391 mkdir
-p $dbg_dir/usr
/lib
/debug
/lib
/modules
/$version/
392 cp vmlinux
$dbg_dir/usr
/lib
/debug
/lib
/modules
/$version/
394 mkdir
-p $dbg_dir/usr
/lib
/debug
/boot
/
395 ln -s ..
/lib
/modules
/$version/vmlinux
$dbg_dir/usr
/lib
/debug
/boot
/vmlinux-
$version
397 ln -s lib
/modules
/$version/vmlinux
$dbg_dir/usr
/lib
/debug
/vmlinux-
$version
399 cat <<EOF >> debian/control
401 Package: $dbg_packagename
403 Provides: linux-debug, linux-debug-$version
405 Description: Linux kernel debugging symbols for $version
406 This package will come in handy if you need to debug the kernel. It provides
407 all the necessary debug symbols for the kernel and its modules.
410 create_package
"$dbg_packagename" "$dbg_dir"
413 if [ "x$1" = "xdeb-pkg" ]
415 cat <<EOF > debian/rules
422 \$(MAKE) KDEB_SOURCENAME=${sourcename} KDEB_PKGVERSION=${packageversion} bindeb-pkg
425 rm -rf debian/*tmp debian/files
426 mv debian/ debian.backup # debian/ might be cleaned away
428 mv debian.backup debian
432 mv ${sourcename}.tar.gz ../${sourcename}_${version}.orig.
tar.gz
433 tar caf ..
/${sourcename}_${packageversion}.debian.tar.gz debian/{copyright,rules,changelog,control}
434 dpkg-source
-cdebian/control
-ldebian/changelog
--format="3.0 (custom)" --target-format="3.0 (quilt)" \
435 -b / ..
/${sourcename}_${version}.orig.tar.gz ../${sourcename}_${packageversion}.debian.
tar.gz
436 mv ${sourcename}_
${packageversion}*dsc ..
437 dpkg-genchanges
> ..
/${sourcename}_${packageversion}_${debarch}.changes
439 dpkg-genchanges
-b > ..
/${sourcename}_${packageversion}_${debarch}.changes