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 cp debian/copyright "$pdir/usr/share/doc/$pname/"
19 cp debian/changelog "$pdir/usr/share/doc/$pname/changelog.Debian"
20 gzip -9 "$pdir/usr/share/doc/$pname/changelog.Debian"
21 sh -c "cd '$pdir'; find . -type f ! -path './DEBIAN/*' -printf '%P\0' \
22 | xargs -r0 md5sum > DEBIAN/md5sums"
24 # Fix ownership and permissions
25 chown -R root:root "$pdir"
28 # Attempt to find the correct Debian architecture
29 local forcearch="" debarch=""
30 case "$UTS_MACHINE" in
32 debarch="$UTS_MACHINE" ;;
38 debarch=s390$(grep -q CONFIG_64BIT=y $KCONFIG_CONFIG && echo x || true) ;;
40 debarch=$(grep -q CPU_LITTLE_ENDIAN=y $KCONFIG_CONFIG && echo ppc64el || echo powerpc) ;;
44 debarch=mips$(grep -q CPU_LITTLE_ENDIAN=y $KCONFIG_CONFIG && echo el || true) ;;
48 debarch=arm$(grep -q CONFIG_AEABI=y $KCONFIG_CONFIG && echo el || true) ;;
51 echo "** ** ** WARNING ** ** **" >&2
53 echo "Your architecture doesn't have it's equivalent" >&2
54 echo "Debian userspace architecture defined!" >&2
55 echo "Falling back to using your current userspace instead!" >&2
56 echo "Please add support for $UTS_MACHINE to ${0} ..." >&2
59 if [ -n "$KBUILD_DEBARCH" ] ; then
60 debarch="$KBUILD_DEBARCH"
62 if [ -n "$debarch" ] ; then
63 forcearch="-DArchitecture=$debarch"
67 dpkg-gencontrol $forcearch -Vkernel:debarch="${debarch:-$(dpkg --print-architecture)}" -p$pname -P"$pdir"
68 dpkg --build "$pdir" ..
71 # Some variables and settings used throughout the script
72 version=$KERNELRELEASE
73 revision=$(cat .version)
74 if [ -n "$KDEB_PKGVERSION" ]; then
75 packageversion=$KDEB_PKGVERSION
77 packageversion=$version-$revision
79 tmpdir="$objtree/debian/tmp"
80 fwdir="$objtree/debian/fwtmp"
81 kernel_headers_dir="$objtree/debian/hdrtmp"
82 libc_headers_dir="$objtree/debian/headertmp"
83 dbg_dir="$objtree/debian/dbgtmp"
84 packagename=linux-image-$version
85 fwpackagename=linux-firmware-image-$version
86 kernel_headers_packagename=linux-headers-$version
87 libc_headers_packagename=linux-libc-dev
88 dbg_packagename=$packagename-dbg
90 if [ "$ARCH" = "um" ] ; then
91 packagename=user-mode-linux-$version
94 # Not all arches have the same installed path in debian
95 # XXX: have each arch Makefile export a variable of the canonical image install
99 installed_image_path="usr/bin/linux-$version"
102 installed_image_path="boot/vmlinux-$version"
105 installed_image_path="boot/vmlinuz-$version"
108 BUILD_DEBUG="$(grep -s '^CONFIG_DEBUG_INFO=y' $KCONFIG_CONFIG || true)"
110 # Setup the directory structure
111 rm -rf "$tmpdir" "$fwdir" "$kernel_headers_dir" "$libc_headers_dir" "$dbg_dir"
112 mkdir -m 755 -p "$tmpdir/DEBIAN"
113 mkdir -p "$tmpdir/lib" "$tmpdir/boot" "$tmpdir/usr/share/doc/$packagename"
114 mkdir -m 755 -p "$fwdir/DEBIAN"
115 mkdir -p "$fwdir/lib/firmware/$version/" "$fwdir/usr/share/doc/$fwpackagename"
116 mkdir -m 755 -p "$libc_headers_dir/DEBIAN"
117 mkdir -p "$libc_headers_dir/usr/share/doc/$libc_headers_packagename"
118 mkdir -m 755 -p "$kernel_headers_dir/DEBIAN"
119 mkdir -p "$kernel_headers_dir/usr/share/doc/$kernel_headers_packagename"
120 mkdir -p "$kernel_headers_dir/lib/modules/$version/"
121 if [ "$ARCH" = "um" ] ; then
122 mkdir -p "$tmpdir/usr/lib/uml/modules/$version" "$tmpdir/usr/bin"
124 if [ -n "$BUILD_DEBUG" ] ; then
125 mkdir -p "$dbg_dir/usr/share/doc/$dbg_packagename"
126 mkdir -m 755 -p "$dbg_dir/DEBIAN"
129 # Build and install the kernel
130 if [ "$ARCH" = "um" ] ; then
132 cp System.map "$tmpdir/usr/lib/uml/modules/$version/System.map"
133 cp $KCONFIG_CONFIG "$tmpdir/usr/share/doc/$packagename/config"
134 gzip "$tmpdir/usr/share/doc/$packagename/config"
136 cp System.map "$tmpdir/boot/System.map-$version"
137 cp $KCONFIG_CONFIG "$tmpdir/boot/config-$version"
139 # Not all arches include the boot path in KBUILD_IMAGE
140 if [ -e $KBUILD_IMAGE ]; then
141 cp $KBUILD_IMAGE "$tmpdir/$installed_image_path"
143 cp arch/$ARCH/boot/$KBUILD_IMAGE "$tmpdir/$installed_image_path"
146 if grep -q '^CONFIG_MODULES=y' $KCONFIG_CONFIG ; then
147 INSTALL_MOD_PATH="$tmpdir" $MAKE KBUILD_SRC= modules_install
148 rm -f "$tmpdir/lib/modules/$version/build"
149 rm -f "$tmpdir/lib/modules/$version/source"
150 if [ "$ARCH" = "um" ] ; then
151 mv "$tmpdir/lib/modules/$version"/* "$tmpdir/usr/lib/uml/modules/$version/"
152 rmdir "$tmpdir/lib/modules/$version"
154 if [ -n "$BUILD_DEBUG" ] ; then
155 for module in $(find $tmpdir/lib/modules/ -name *.ko -printf '%P\n'); do
156 module=lib/modules/$module
157 mkdir -p $(dirname $dbg_dir/usr/lib/debug/$module)
158 # only keep debug symbols in the debug file
159 $OBJCOPY --only-keep-debug $tmpdir/$module $dbg_dir/usr/lib/debug/$module
160 # strip original module from debug symbols
161 $OBJCOPY --strip-debug $tmpdir/$module
162 # then add a link to those
163 $OBJCOPY --add-gnu-debuglink=$dbg_dir/usr/lib/debug/$module $tmpdir/$module
168 if [ "$ARCH" != "um" ]; then
169 $MAKE headers_check KBUILD_SRC=
170 $MAKE headers_install KBUILD_SRC= INSTALL_HDR_PATH="$libc_headers_dir/usr"
173 # Install the maintainer scripts
174 # Note: hook scripts under /etc/kernel are also executed by official Debian
175 # kernel packages, as well as kernel packages built using make-kpkg.
176 # make-kpkg sets $INITRD to indicate whether an initramfs is wanted, and
177 # so do we; recent versions of dracut and initramfs-tools will obey this.
178 debhookdir=${KDEB_HOOKDIR:-/etc/kernel}
179 if grep -q '^CONFIG_BLK_DEV_INITRD=y' $KCONFIG_CONFIG; then
184 for script in postinst postrm preinst prerm ; do
185 mkdir -p "$tmpdir$debhookdir/$script.d"
186 cat <<EOF > "$tmpdir/DEBIAN/$script"
191 # Pass maintainer script parameters to hook scripts
192 export DEB_MAINT_PARAMS="\$*"
194 # Tell initramfs builder whether it's wanted
195 export INITRD=$want_initrd
197 test -d $debhookdir/$script.d && run-parts --arg="$version" --arg="/$installed_image_path" $debhookdir/$script.d
200 chmod 755 "$tmpdir/DEBIAN/$script"
203 # Try to determine maintainer and email values
204 if [ -n "$DEBEMAIL" ]; then
206 elif [ -n "$EMAIL" ]; then
209 email=$(id -nu)@$(hostname -f)
211 if [ -n "$DEBFULLNAME" ]; then
213 elif [ -n "$NAME" ]; then
218 maintainer="$name <$email>"
220 # Try to determine distribution
221 if [ -n "$KDEB_CHANGELOG_DIST" ]; then
222 distribution=$KDEB_CHANGELOG_DIST
223 elif distribution=$(lsb_release -cs 2>/dev/null) && [ -n "$distribution" ]; then
224 : # nothing to do in this case
226 distribution="unstable"
227 echo >&2 "Using default distribution of 'unstable' in the changelog"
228 echo >&2 "Install lsb-release or set \$KDEB_CHANGELOG_DIST explicitly"
231 # Generate a simple changelog template
232 cat <<EOF > debian/changelog
233 linux-upstream ($packageversion) $distribution; urgency=low
235 * Custom built Linux kernel.
237 -- $maintainer $(date -R)
240 # Generate copyright file
241 cat <<EOF > debian/copyright
242 This is a packacked upstream version of the Linux kernel.
244 The sources may be found at most Linux ftp sites, including:
245 ftp://ftp.kernel.org/pub/linux/kernel
247 Copyright: 1991 - 2015 Linus Torvalds and others.
249 The git repository for mainline kernel development is at:
250 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
252 This program is free software; you can redistribute it and/or modify
253 it under the terms of the GNU General Public License as published by
254 the Free Software Foundation; version 2 dated June, 1991.
256 On Debian GNU/Linux systems, the complete text of the GNU General Public
257 License version 2 can be found in \`/usr/share/common-licenses/GPL-2'.
260 # Generate a control file
261 cat <<EOF > debian/control
262 Source: linux-upstream
265 Maintainer: $maintainer
266 Standards-Version: 3.8.4
267 Homepage: http://www.kernel.org/
270 if [ "$ARCH" = "um" ]; then
271 cat <<EOF >> debian/control
273 Package: $packagename
274 Provides: linux-image, linux-image-2.6, linux-modules-$version
276 Description: User Mode Linux kernel, version $version
277 User-mode Linux is a port of the Linux kernel to its own system call
278 interface. It provides a kind of virtual machine, which runs Linux
279 as a user process under another Linux kernel. This is useful for
280 kernel development, sandboxes, jails, experimentation, and
283 This package contains the Linux kernel, modules and corresponding other
284 files, version: $version.
288 cat <<EOF >> debian/control
290 Package: $packagename
291 Provides: linux-image, linux-image-2.6, linux-modules-$version
292 Suggests: $fwpackagename
294 Description: Linux kernel, version $version
295 This package contains the Linux kernel, modules and corresponding other
296 files, version: $version.
301 # Build kernel header package
302 (cd $srctree; find . -name Makefile\* -o -name Kconfig\* -o -name \*.pl) > "$objtree/debian/hdrsrcfiles"
303 (cd $srctree; find arch/$SRCARCH/include include scripts -type f) >> "$objtree/debian/hdrsrcfiles"
304 (cd $srctree; find arch/$SRCARCH -name module.lds -o -name Kbuild.platforms -o -name Platform) >> "$objtree/debian/hdrsrcfiles"
305 (cd $srctree; find $(find arch/$SRCARCH -name include -o -name scripts -type d) -type f) >> "$objtree/debian/hdrsrcfiles"
306 (cd $objtree; find arch/$SRCARCH/include Module.symvers include scripts -type f) >> "$objtree/debian/hdrobjfiles"
307 destdir=$kernel_headers_dir/usr/src/linux-headers-$version
309 (cd $srctree; tar -c -f - -T -) < "$objtree/debian/hdrsrcfiles" | (cd $destdir; tar -xf -)
310 (cd $objtree; tar -c -f - -T -) < "$objtree/debian/hdrobjfiles" | (cd $destdir; tar -xf -)
311 (cd $objtree; cp $KCONFIG_CONFIG $destdir/.config) # copy .config manually to be where it's expected to be
312 ln -sf "/usr/src/linux-headers-$version" "$kernel_headers_dir/lib/modules/$version/build"
313 rm -f "$objtree/debian/hdrsrcfiles" "$objtree/debian/hdrobjfiles"
315 cat <<EOF >> debian/control
317 Package: $kernel_headers_packagename
318 Provides: linux-headers, linux-headers-2.6
320 Description: Linux kernel headers for $KERNELRELEASE on \${kernel:debarch}
321 This package provides kernel header files for $KERNELRELEASE on \${kernel:debarch}
323 This is useful for people who need to build external modules
326 # Do we have firmware? Move it out of the way and build it into a package.
327 if [ -e "$tmpdir/lib/firmware" ]; then
328 mv "$tmpdir/lib/firmware"/* "$fwdir/lib/firmware/$version/"
329 rmdir "$tmpdir/lib/firmware"
331 cat <<EOF >> debian/control
333 Package: $fwpackagename
335 Description: Linux kernel firmware, version $version
336 This package contains firmware from the Linux kernel, version $version.
339 create_package "$fwpackagename" "$fwdir"
342 cat <<EOF >> debian/control
344 Package: $libc_headers_packagename
346 Provides: linux-kernel-headers
348 Description: Linux support headers for userspace development
349 This package provides userspaces headers from the Linux kernel. These headers
350 are used by the installed headers for GNU glibc and other system libraries.
353 if [ "$ARCH" != "um" ]; then
354 create_package "$kernel_headers_packagename" "$kernel_headers_dir"
355 create_package "$libc_headers_packagename" "$libc_headers_dir"
358 create_package "$packagename" "$tmpdir"
360 if [ -n "$BUILD_DEBUG" ] ; then
361 # Build debug package
362 # Different tools want the image in different locations
364 mkdir -p $dbg_dir/usr/lib/debug/lib/modules/$version/
365 cp vmlinux $dbg_dir/usr/lib/debug/lib/modules/$version/
367 mkdir -p $dbg_dir/usr/lib/debug/boot/
368 ln -s ../lib/modules/$version/vmlinux $dbg_dir/usr/lib/debug/boot/vmlinux-$version
370 ln -s lib/modules/$version/vmlinux $dbg_dir/usr/lib/debug/vmlinux-$version
372 cat <<EOF >> debian/control
374 Package: $dbg_packagename
376 Provides: linux-debug, linux-debug-$version
378 Description: Linux kernel debugging symbols for $version
379 This package will come in handy if you need to debug the kernel. It provides
380 all the necessary debug symbols for the kernel and its modules.
383 create_package "$dbg_packagename" "$dbg_dir"