Kernel Git

From openSUSE

The openSUSE / SLE kernel git repository is located at http://gitorious.org/opensuse/kernel-source. It's not a fork of the mainline kernel repository, but a series of patches, spec file templates and a set of script to work with the repository.

Getting Started

First, install GIT, the newer the better. git-core-1.5.6 from openSUSE 11.0 is known to work, if you are using an older GIT and encounter problems, please report them (ideally with a patch attached) to opensuse-kernel@opensuse.org. If you don't encounter problems, please update the sentence about which minimum version is known to work.

Setting up a clone

 git clone git://gitorious.org/opensuse/kernel-source.git
 scripts/install-git-hooks

This will create the master branch only, to set up further branches, do

 git checkout -b $branch origin/$branch

and later just

 git checkout $branch

Each branch has a README.BRANCH file indicating the purpose of the branch.

If you are going to commit anything, it's time to introduce yourself:

 git config [--global] user.name "Your Name Comes Here"
 git config [--global] user.email your@email

Hacking on the sources

To generate a linux kernel tree that you can hack on, run

 scripts/sequence-patch.sh --quilt

This unpacks the vanilla linux tarball and applies the patch series. You can use quilt to create or modify the patches. The refresh_patch.sh script should be used to refresh patches, so that they have a common format. New patches need to be added to the series.conf file in the top-level directory. When you are done, commit your changes with

 scripts/log

This will open kernel-source.changes with a pre-generated changelog entry, expand it if needed and type :wq. Please use scripts/log when committing user-visible changes, so that there is always an entry in the rpm changelog.

Building kernel packages

 scripts/tar-up.sh

Submitting your changes to openSUSE

Please remember that the recommended way to have a patch included in the openSUSE kernel is to push it upstream (Linus' tree for master, 2.6.x.y for released products). If you want to change something in the packaging or scripts, send your patches to opensuse-kernel@opensuse.org, see Mailing Lists for information how to subscribe.