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) ;;
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 -isp $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
157 for module in $(find lib/modules/ -name *.ko); do
158 mkdir -p $(dirname $dbg_dir/usr/lib/debug/$module)
159 # only keep debug symbols in the debug file
160 $OBJCOPY --only-keep-debug $module $dbg_dir/usr/lib/debug/$module
161 # strip original module from debug symbols
162 $OBJCOPY --strip-debug $module
163 # then add a link to those
164 $OBJCOPY --add-gnu-debuglink=$dbg_dir/usr/lib/debug/$module $module
170 if [ "$ARCH" != "um" ]; then
171 $MAKE headers_check KBUILD_SRC=
172 $MAKE headers_install KBUILD_SRC= INSTALL_HDR_PATH="$libc_headers_dir/usr"
175 # Install the maintainer scripts
176 # Note: hook scripts under /etc/kernel are also executed by official Debian
177 # kernel packages, as well as kernel packages built using make-kpkg.
178 # make-kpkg sets $INITRD to indicate whether an initramfs is wanted, and
179 # so do we; recent versions of dracut and initramfs-tools will obey this.
180 debhookdir=${KDEB_HOOKDIR:-/etc/kernel}
181 if grep -q '^CONFIG_BLK_DEV_INITRD=y' $KCONFIG_CONFIG; then
186 for script in postinst postrm preinst prerm ; do
187 mkdir -p "$tmpdir$debhookdir/$script.d"
188 cat <<EOF > "$tmpdir/DEBIAN/$script"
193 # Pass maintainer script parameters to hook scripts
194 export DEB_MAINT_PARAMS="\$*"
196 # Tell initramfs builder whether it's wanted
197 export INITRD=$want_initrd
199 test -d $debhookdir/$script.d && run-parts --arg="$version" --arg="/$installed_image_path" $debhookdir/$script.d
202 chmod 755 "$tmpdir/DEBIAN/$script"
205 # Try to determine maintainer and email values
206 if [ -n "$DEBEMAIL" ]; then
208 elif [ -n "$EMAIL" ]; then
211 email=$(id -nu)@$(hostname -f)
213 if [ -n "$DEBFULLNAME" ]; then
215 elif [ -n "$NAME" ]; then
220 maintainer="$name <$email>"
222 # Generate a simple changelog template
223 cat <<EOF > debian/changelog
224 linux-upstream ($packageversion) unstable; urgency=low
226 * Custom built Linux kernel.
228 -- $maintainer $(date -R)
231 # Generate copyright file
232 cat <<EOF > debian/copyright
233 This is a packacked upstream version of the Linux kernel.
235 The sources may be found at most Linux ftp sites, including:
236 ftp://ftp.kernel.org/pub/linux/kernel
238 Copyright: 1991 - 2009 Linus Torvalds and others.
240 The git repository for mainline kernel development is at:
241 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
243 This program is free software; you can redistribute it and/or modify
244 it under the terms of the GNU General Public License as published by
245 the Free Software Foundation; version 2 dated June, 1991.
247 On Debian GNU/Linux systems, the complete text of the GNU General Public
248 License version 2 can be found in \`/usr/share/common-licenses/GPL-2'.
251 # Generate a control file
252 cat <<EOF > debian/control
253 Source: linux-upstream
256 Maintainer: $maintainer
257 Standards-Version: 3.8.4
258 Homepage: http://www.kernel.org/
261 if [ "$ARCH" = "um" ]; then
262 cat <<EOF >> debian/control
264 Package: $packagename
265 Provides: linux-image, linux-image-2.6, linux-modules-$version
267 Description: User Mode Linux kernel, version $version
268 User-mode Linux is a port of the Linux kernel to its own system call
269 interface. It provides a kind of virtual machine, which runs Linux
270 as a user process under another Linux kernel. This is useful for
271 kernel development, sandboxes, jails, experimentation, and
274 This package contains the Linux kernel, modules and corresponding other
275 files, version: $version.
279 cat <<EOF >> debian/control
281 Package: $packagename
282 Provides: linux-image, linux-image-2.6, linux-modules-$version
283 Suggests: $fwpackagename
285 Description: Linux kernel, version $version
286 This package contains the Linux kernel, modules and corresponding other
287 files, version: $version.
292 # Build kernel header package
293 (cd $srctree; find . -name Makefile\* -o -name Kconfig\* -o -name \*.pl) > "$objtree/debian/hdrsrcfiles"
294 (cd $srctree; find arch/$SRCARCH/include include scripts -type f) >> "$objtree/debian/hdrsrcfiles"
295 (cd $srctree; find arch/$SRCARCH -name module.lds -o -name Kbuild.platforms -o -name Platform) >> "$objtree/debian/hdrsrcfiles"
296 (cd $srctree; find $(find arch/$SRCARCH -name include -o -name scripts -type d) -type f) >> "$objtree/debian/hdrsrcfiles"
297 (cd $objtree; find arch/$SRCARCH/include Module.symvers include scripts -type f) >> "$objtree/debian/hdrobjfiles"
298 destdir=$kernel_headers_dir/usr/src/linux-headers-$version
300 (cd $srctree; tar -c -f - -T -) < "$objtree/debian/hdrsrcfiles" | (cd $destdir; tar -xf -)
301 (cd $objtree; tar -c -f - -T -) < "$objtree/debian/hdrobjfiles" | (cd $destdir; tar -xf -)
302 (cd $objtree; cp $KCONFIG_CONFIG $destdir/.config) # copy .config manually to be where it's expected to be
303 ln -sf "/usr/src/linux-headers-$version" "$kernel_headers_dir/lib/modules/$version/build"
304 rm -f "$objtree/debian/hdrsrcfiles" "$objtree/debian/hdrobjfiles"
306 cat <<EOF >> debian/control
308 Package: $kernel_headers_packagename
309 Provides: linux-headers, linux-headers-2.6
311 Description: Linux kernel headers for $KERNELRELEASE on \${kernel:debarch}
312 This package provides kernel header files for $KERNELRELEASE on \${kernel:debarch}
314 This is useful for people who need to build external modules
317 # Do we have firmware? Move it out of the way and build it into a package.
318 if [ -e "$tmpdir/lib/firmware" ]; then
319 mv "$tmpdir/lib/firmware"/* "$fwdir/lib/firmware/$version/"
320 rmdir "$tmpdir/lib/firmware"
322 cat <<EOF >> debian/control
324 Package: $fwpackagename
326 Description: Linux kernel firmware, version $version
327 This package contains firmware from the Linux kernel, version $version.
330 create_package "$fwpackagename" "$fwdir"
333 cat <<EOF >> debian/control
335 Package: $libc_headers_packagename
337 Provides: linux-kernel-headers
339 Description: Linux support headers for userspace development
340 This package provides userspaces headers from the Linux kernel. These headers
341 are used by the installed headers for GNU glibc and other system libraries.
344 if [ "$ARCH" != "um" ]; then
345 create_package "$kernel_headers_packagename" "$kernel_headers_dir"
346 create_package "$libc_headers_packagename" "$libc_headers_dir"
349 create_package "$packagename" "$tmpdir"
351 if [ -n "$BUILD_DEBUG" ] ; then
352 # Build debug package
353 # Different tools want the image in different locations
355 mkdir -p $dbg_dir/usr/lib/debug/lib/modules/$version/
356 cp vmlinux $dbg_dir/usr/lib/debug/lib/modules/$version/
358 mkdir -p $dbg_dir/usr/lib/debug/boot/
359 ln -s ../lib/modules/$version/vmlinux $dbg_dir/usr/lib/debug/boot/vmlinux-$version
361 ln -s lib/modules/$version/vmlinux $dbg_dir/usr/lib/debug/vmlinux-$version
363 cat <<EOF >> debian/control
365 Package: $dbg_packagename
367 Provides: linux-debug, linux-debug-$version
369 Description: Linux kernel debugging symbols for $version
370 This package will come in handy if you need to debug the kernel. It provides
371 all the necessary debug symbols for the kernel and its modules.
374 create_package "$dbg_packagename" "$dbg_dir"