Difference between revisions of "Kernel-packaging"

From SlackWiki
Jump to navigation Jump to search
Line 83: Line 83:
Of course this would be easier to control with a script rather than typing in these commands manually and trying not to make typos. Here is the script that I've been using (run make menuconfig first):
Of course this would be easier to control with a script rather than typing in these commands manually and trying not to make typos. Here is the script that I've been using (run make menuconfig first):


  #!/bin/sh
#!/bin/sh
  # Slackware build script for kernel and modules
# Slackware build script for kernel and modules
  #
#
  # Copyright 2009  David Woodfall <dave@dawoodfall.net>
# Copyright 2009  David Woodfall <dave@dawoodfall.net>
  # All rights reserved.
# All rights reserved.
  #
#
  # Redistribution and use of this script, with or without modification, is
# Redistribution and use of this script, with or without modification, is
  # permitted provided that the following conditions are met:
# permitted provided that the following conditions are met:
  #
#
  # 1. Redistributions of this script must retain the above copyright
# 1. Redistributions of this script must retain the above copyright
  #    notice, this list of conditions and the following disclaimer.
#    notice, this list of conditions and the following disclaimer.
  #
#
  # THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR IMPLIED
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR IMPLIED
  # WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  # MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
# MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
  # EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  # PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  # OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  # WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  # OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
  # ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  #  
#  
  # Notes:
# Notes:  
  # You should have a /usr/src/linux-$VERSION-$LOCALNAME of source or you will  
# You should have a /usr/src/linux-$VERSION-$LOCALNAME of source or you will  
  # have problems.
# have problems.
  # Do not omit setting localname in .config.
# Do not omit setting localname in .config.
 
  source .config
  LOCALNAME=${LOCALNAME:-${CONFIG_LOCALVERSION/-/}}
  KARCH=${ARCH:-i486}
  ARCH=x86
  MODULELIST=modules.order
  PRGNAM=kernel
  VERSION=${VERSION:-2.6.29.6}
  BUILD=${BUILD:-1}
  TAG=${TAG:-_daw}
  OUTPUT=${TMP:-/tmp}
  PKG=$OUTPUT/$PRGNAM-$LOCALNAME-$VERSION
  MODDIR=$PKG/lib/modules/$VERSION-$LOCALNAME
 
  set -e
  rm -rf $PKG
 
  make
 
  for i in $(cat $MODULELIST | sed "s#^kernel/##")
  do
      mkdir -p $MODDDIR/$(dirname $i)
      install -m 644 -v $i $MODDDIR/$(dirname $i)
  done
 
  mkdir -p $PKG/boot
  cp arch/x86/boot/bzImage $PKG/boot/vmlinuz-$VERSION-$LOCALNAME
  cp System.map $PKG/boot/System.map-$VERSION-$LOCALNAME
  cp .config $PKG/boot/config-$VERSION-$LOCALNAME
 
  mkdir $PKG/install
 
  cat << EOF > $PKG/install/doinst.sh
  ## Taken from stock modules package
  if [ -x sbin/depmod ]; then
  chroot . /sbin/depmod -a $VERSION-$LOCALNAME > /dev/null 2> /dev/null
  fi
   
  ( cd lib/modules/$VERSION-$LOCALNAME ; rm -rf build )
  ( cd lib/modules/$VERSION-$LOCALNAME ; ln -sf /usr/src/linux-$VERSION-$LOCALNAME build )
  ( cd lib/modules/$VERSION-$LOCALNAME ; rm -rf source )
  ( cd lib/modules/$VERSION-$LOCALNAME ; ln -sf /usr/src/linux-$VERSION-$LOCALNAME source )
  EOF
 
  cat << EOF > $PKG/install/slack-desc
  # HOW TO EDIT THIS FILE:
  # The "handy ruler" below makes it easier to edit a package description.  Line
  # up the first '|' above the ':' following the base package name, and the '|'
  # on the right side marks the last column you can put a character in.  You must
  # make exactly 11 lines for the formatting to be correct.  It's also
  # customary to leave one space after the ':'.
  $PRGNAM-$LOCALNAME|-----handy-ruler------------------------------------------------------|
  $PRGNAM-$LOCALNAME: kernel and modules 2.6.29.6-jabberwok
  $PRGNAM-$LOCALNAME:
  $PRGNAM-$LOCALNAME: Jabberwokky type kernel!
  $PRGNAM-$LOCALNAME:
  $PRGNAM-$LOCALNAME:
  $PRGNAM-$LOCALNAME:
  $PRGNAM-$LOCALNAME:
  $PRGNAM-$LOCALNAME:
  $PRGNAM-$LOCALNAME:
  $PRGNAM-$LOCALNAME:
  $PRGNAM-$LOCALNAME:
  EOF
  cd $PKG
  /sbin/makepkg -l y -c n $OUTPUT/$PRGNAM-$LOCALNAME-$VERSION$TAG-$KARCH-$BUILD.${PKGTYPE:-tgz}


And here's a downloadable version: http://www.dawoodfall.net/slackbuilds/13.0/kernel/kernel-jabberwok.SlackBuild
 
source ./.config
LOCALNAME=${LOCALNAME:-${CONFIG_LOCALVERSION/-/}}
KARCH=${ARCH:-i486}
ARCH=x86
MODULELIST=modules.order
PRGNAM=kernel
VERSION=${VERSION:-2.6.29.6}
BUILD=${BUILD:-1}
TAG=${TAG:-_daw}
OUTPUT=${TMP:-/tmp}
PKG=$OUTPUT/$PRGNAM-$LOCALNAME-$VERSION
MODDIR=$PKG/lib/modules/$VERSION-$LOCALNAME
 
set -e
 
rm -rf $PKG
 
make
 
for i in $(cat $MODULELIST | sed "s#^kernel/##" )
do
mkdir -p $MODDIR/$(dirname $i)
install -m 644 -v $i $MODDIR/$(dirname $i)
let nummods=$nummods+1
done
 
mkdir -p $PKG/install
 
cat << EOF > $PKG/install/doinst.sh
## Taken from stock modules package
if [ -x sbin/depmod ]; then
  chroot . /sbin/depmod -a $VERSION-$LOCALNAME > /dev/null 2> /dev/null
fi
 
( cd lib/modules/$VERSION-$LOCALNAME ; rm -rf build )
( cd lib/modules/$VERSION-$LOCALNAME ; ln -sf /usr/src/linux-$VERSION-$LOCALNAME build )
( cd lib/modules/$VERSION-$LOCALNAME ; rm -rf source )
( cd lib/modules/$VERSION-$LOCALNAME ; ln -sf /usr/src/linux-$VERSION-$LOCALNAME source )
EOF
 
cat << EOF > $PKG/install/slack-desc
# HOW TO EDIT THIS FILE:
# The "handy ruler" below makes it easier to edit a package description.  Line
# up the first '|' above the ':' following the base package name, and the '|'
# on the right side marks the last column you can put a character in.  You must
# make exactly 11 lines for the formatting to be correct.  It's also
# customary to leave one space after the ':'.
 
$PRGNAM-$LOCALNAME|-----handy-ruler------------------------------------------------------|
$PRGNAM-$LOCALNAME: kernel and modules for $LOCALNAME-$VERSION
$PRGNAM-$LOCALNAME:
$PRGNAM-$LOCALNAME: Jabberwokky type kernel!
$PRGNAM-$LOCALNAME:
$PRGNAM-$LOCALNAME:
$PRGNAM-$LOCALNAME:
$PRGNAM-$LOCALNAME:
$PRGNAM-$LOCALNAME:
$PRGNAM-$LOCALNAME:
$PRGNAM-$LOCALNAME:
$PRGNAM-$LOCALNAME:
EOF
 
mkdir -p $PKG/boot
 
cp arch/x86/boot/bzImage $PKG/boot/vmlinuz-$VERSION-$LOCALNAME
cp System.map $PKG/boot/System.map-$VERSION-$LOCALNAME
cp .config $PKG/boot/config-$VERSION-$LOCALNAME
 
ksize=$(ls -l arch/x86/boot/bzImage | awk '{print $5}')
 
cd $PKG
 
PACKAGE=$OUTPUT/$PRGNAM-$LOCALNAME-$VERSION-$KARCH-$BUILD-$TAG.${PKGTYPE:-tgz}
 
/sbin/makepkg -l y -c n $PACKAGE
 
echo -ne '\e[01;34m'
printf "$nummods Modules Built\n"
printf "Kernel Size: $ksize\n"
printf "Package Size: $(ls -l $PACKAGE | awk '{print $5}')\n\n"
echo -ne '\e[m\017'


= Conclusion =
= Conclusion =

Revision as of 19:44, 25 July 2010

Creating a Custom Package of Kernel and Modules

  • Note: This tutorial assumes that you know how to compile a kernel already. It only looks at a way of creating a package and doesn't aim to show kernel config options.

For info on compiling please look at these pages:

Kernel_Compilation

Kernel26Compilation

Kernel_Checklist

  • Note2: I will be assuming x86 here, but if anyone wants to contribute some notes on x86_64 until I can get a machine setup, please do.

Kernel Output Target Option

The usual way to make any sort of package is via the $DESTDIR variable. The kernel doesn't use this however, but it does have an O switch which does almost the same thing, although the output might not be exactly what you expect. I will not be using that option here, but see the discussion page about that.

Building

Copy your .config into the source directory and do

  make menuconfig

(or whichever method you prefer.)

You may need to do 'make mrproper' first, and perhaps 'make oldconfig'.

  make
  • Note: Do not use 'make install' or 'make modules_install', even with O switch, as this *will* install to /boot and /lib/modules.

At this point everything we need is in the source directory. The file modules.order lists the modules to be installed and that we can use to help us make a package.

Installing Modules and Kernel to our Package Directory

Ok let's use /tmp/kernel-package for our package directory. Also let's assume a 2.6.29.6 kernel with jabberwok as local name. A little bash will copy our modules to it:

  for i in $(cat modules.order | sed "s#^kernel/##")
  do
    mkdir -p /tmp/kernel-package/lib/modules/2.6.29.6-jabberwok/$(dirname $i)
    install -m 644 -v $i /tmp/kernel-package/lib/modules/2.6.29.6-jabberwok/$(dirname $i)
  done

Now we need the kernel and associated files.

  mkdir /tmp/kernel-package/boot
  cp arch/x86/boot/bzImage /tmp/kernel-package/boot/vmlinuz-2.6.29.6-jabberwok
  cp System.map /tmp/kernel-package/boot/System.map-2.6.29.6-jabberwok
  cp .config /tmp/kernel-package/boot/config-2.6.29.6-jabberwok

And then the doinst.sh and slack-desc.

  mkdir /tmp/kernel-package/install

doinst.sh:

  ## Taken from stock modules package
  if [ -x sbin/depmod ]; then
  chroot . /sbin/depmod -a 2.6.29.6-jabberwok > /dev/null 2> /dev/null
  fi
  
  ( cd lib/modules/2.6.29.6-jabberwok ; rm -rf build )
  ( cd lib/modules/2.6.29.6-jabberwok ; ln -sf /usr/src/linux-2.6.29.6-jabberwok build )
  ( cd lib/modules/2.6.29.6-jabberwok ; rm -rf source )
  ( cd lib/modules/2.6.29.6-jabberwok ; ln -sf /usr/src/linux-2.6.29.6-jabberwok source )


I'll leave you to figure out the slack-desc. It should be copied into the install/ directory and appname ought to be (going by this example) kernel-jabberwok.

Making the Package

  cd /tmp/kernel-package
  /sbin/makepkg -l y -c n /tmp/kernel-jabberwok-2.6.29.6-i686-1_tag.txz

Change '_tag' to your usual moniker. Hopefully we now have a package in /tmp. Copy it to a temporary directory somewhere, explodepkg it and check the contents. We don't want to install something with messed up paths etc. If all is well we can installpkg it.

As usual, edit your /etc/lilo.conf and add an option for the new kernel, keeping the old kernel entry in place for safety, then run lilo.

A Little Automation

Of course this would be easier to control with a script rather than typing in these commands manually and trying not to make typos. Here is the script that I've been using (run make menuconfig first):

  1. !/bin/sh
  2. Slackware build script for kernel and modules
  3. Copyright 2009 David Woodfall <dave@dawoodfall.net>
  4. All rights reserved.
  5. Redistribution and use of this script, with or without modification, is
  6. permitted provided that the following conditions are met:
  7. 1. Redistributions of this script must retain the above copyright
  8. notice, this list of conditions and the following disclaimer.
  9. THIS SOFTWARE IS PROVIDED BY THE AUTHOR AS IS AND ANY EXPRESS OR IMPLIED
  10. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  11. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
  12. EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  13. SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  14. PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  15. OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  16. WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  17. OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
  18. ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  19. Notes:
  20. You should have a /usr/src/linux-$VERSION-$LOCALNAME of source or you will
  21. have problems.
  22. Do not omit setting localname in .config.


source ./.config LOCALNAME=${LOCALNAME:-${CONFIG_LOCALVERSION/-/}} KARCH=${ARCH:-i486} ARCH=x86 MODULELIST=modules.order PRGNAM=kernel VERSION=${VERSION:-2.6.29.6} BUILD=${BUILD:-1} TAG=${TAG:-_daw} OUTPUT=${TMP:-/tmp} PKG=$OUTPUT/$PRGNAM-$LOCALNAME-$VERSION MODDIR=$PKG/lib/modules/$VERSION-$LOCALNAME

set -e

rm -rf $PKG

make

for i in $(cat $MODULELIST | sed "s#^kernel/##" ) do mkdir -p $MODDIR/$(dirname $i) install -m 644 -v $i $MODDIR/$(dirname $i) let nummods=$nummods+1 done

mkdir -p $PKG/install

cat << EOF > $PKG/install/doinst.sh

    1. Taken from stock modules package

if [ -x sbin/depmod ]; then

 chroot . /sbin/depmod -a $VERSION-$LOCALNAME > /dev/null 2> /dev/null

fi

( cd lib/modules/$VERSION-$LOCALNAME ; rm -rf build ) ( cd lib/modules/$VERSION-$LOCALNAME ; ln -sf /usr/src/linux-$VERSION-$LOCALNAME build ) ( cd lib/modules/$VERSION-$LOCALNAME ; rm -rf source ) ( cd lib/modules/$VERSION-$LOCALNAME ; ln -sf /usr/src/linux-$VERSION-$LOCALNAME source ) EOF

cat << EOF > $PKG/install/slack-desc

  1. HOW TO EDIT THIS FILE:
  2. The "handy ruler" below makes it easier to edit a package description. Line
  3. up the first '|' above the ':' following the base package name, and the '|'
  4. on the right side marks the last column you can put a character in. You must
  5. make exactly 11 lines for the formatting to be correct. It's also
  6. customary to leave one space after the ':'.

$PRGNAM-$LOCALNAME|-----handy-ruler------------------------------------------------------| $PRGNAM-$LOCALNAME: kernel and modules for $LOCALNAME-$VERSION $PRGNAM-$LOCALNAME: $PRGNAM-$LOCALNAME: Jabberwokky type kernel! $PRGNAM-$LOCALNAME: $PRGNAM-$LOCALNAME: $PRGNAM-$LOCALNAME: $PRGNAM-$LOCALNAME: $PRGNAM-$LOCALNAME: $PRGNAM-$LOCALNAME: $PRGNAM-$LOCALNAME: $PRGNAM-$LOCALNAME: EOF

mkdir -p $PKG/boot

cp arch/x86/boot/bzImage $PKG/boot/vmlinuz-$VERSION-$LOCALNAME cp System.map $PKG/boot/System.map-$VERSION-$LOCALNAME cp .config $PKG/boot/config-$VERSION-$LOCALNAME

ksize=$(ls -l arch/x86/boot/bzImage | awk '{print $5}')

cd $PKG

PACKAGE=$OUTPUT/$PRGNAM-$LOCALNAME-$VERSION-$KARCH-$BUILD-$TAG.${PKGTYPE:-tgz}

/sbin/makepkg -l y -c n $PACKAGE

echo -ne '\e[01;34m' printf "$nummods Modules Built\n" printf "Kernel Size: $ksize\n" printf "Package Size: $(ls -l $PACKAGE | awk '{print $5}')\n\n" echo -ne '\e[m\017'

Conclusion

The aim for doing this was to be able to build a kernel for my old T42 on my desktop box using the T42's .config. It could be possible to split up kernel and modules into separate packages but I'll let you figure out the details.

At the end of the day, this helped me to compile a kernel without my laptop getting even warm, which was the point of the project.

--Dive 04:31, 11 March 2010 (UTC)