KernelGitGuide

Differences between revisions 48 and 49
Revision 48 as of 2009-01-21 16:38:28
Size: 8563
Editor: amansurov
Comment: changet apt-get into aptitude
Revision 49 as of 2009-01-21 16:59:21
Size: 8562
Editor: gn-216-166-171-58
Comment:
Deletions are marked like this. Additions are marked like this.
Line 24: Line 24:
  sudo aptitude install git-core   sudo apt-get install git-core

Summary

Git is the new SCM used by the Linux kernel developers. Ubuntu has adopted this tool for our own Linux kernel source code so that we can interact better with the community and the other kernel developers.

Where is it?

http://kernel.ubuntu.com/

Current GIT Trees

  • jaunty: git://kernel.ubuntu.com/ubuntu/ubuntu-jaunty.git
  • intrepid: git://kernel.ubuntu.com/ubuntu/ubuntu-intrepid.git
  • hardy: git://kernel.ubuntu.com/ubuntu/ubuntu-hardy.git
  • gutsy: git://kernel.ubuntu.com/ubuntu/ubuntu-gutsy.git
  • feisty: git://kernel.ubuntu.com/ubuntu/ubuntu-feisty.git
  • edgy: git://kernel.ubuntu.com/ubuntu/ubuntu-edgy.git
  • dapper: git://kernel.ubuntu.com/ubuntu/ubuntu-dapper.git

(actually there are a few more and of special note are the -updates git trees. To find out what else is available try browsing http://kernel.ubuntu.com/git and searching for ubuntu)

Getting GIT

To obtain the git binaries, simply install the git-core package from dapper, e.g.:

  sudo apt-get install git-core

Note that the git package is an entirely different tool which will not do what you want.

Getting the Ubuntu Linux kernel repo

The Ubuntu Linux kernel git repository is located at git://kernel.ubuntu.com/ubuntu/ubuntu-<release>.git. To download a local copy of the repo, use this command:

  git clone git://kernel.ubuntu.com/ubuntu/ubuntu-jaunty.git ubuntu-jaunty

This will take some time depending on your connection. There's around 220 MiB of data to download currently (and this always increases). If you already have an upstream kernel tree, you can use the --reference option to avoid downloading redundant objects:

  git clone --reference linux-2.6/ git://kernel.ubuntu.com/ubuntu/ubuntu-jaunty.git

This will reduce the amount of data to download to around 6 MiB.

Change into the directory:

  cd ubuntu-jaunty

Get a copy of the kernel version you want to work on. To determine which the latest official release is:

  git tag | grep Ubuntu*

This results in something like this:

  Ubuntu-2.6.27-7.10
  Ubuntu-2.6.27-7.11
  Ubuntu-2.6.27-7.12
  Ubuntu-2.6.27-7.13
  Ubuntu-2.6.27-7.14

For example, with the exact above output, this would be a correct choice:

  git checkout Ubuntu-2.6.27-7.14

Once this is complete, you can keep your tree up-to-date by running this command:

  git pull

** Warning ** During development, the kernel git repository is being constantly rebased against Linus' tree. IOW, Ubuntu specific changes are not being merged, but rather popped off, the tree rebased and then pushed on to keep them on top. This will cause git pull to fail. Hence, there are two ways to track the kernel git tree, depending on whether you have local changes or not.

No Local Changes

  git fetch -f origin
  git checkout origin
  git branch -f master origin
  git checkout master

Preserve Local Changes

  # Save away local commits
  git rev-list --reverse origin..HEAD > local-commits
  git branch new-head origin
  git checkout new-head
  # This will stop on first error. Cleaning up failures is an exercise for the user
  for cmt in `cat local-commits`; do git-cherry-pick $cmt || break; done
  git branch -f master new-head
  git checkout master
  git branch -D new-head

Alternatively, you can accomplish the same thing in the following way.

No Local Changes

  git fetch -f origin
  git reset --hard origin

Preserve Local Changes

  # save current state in case something goes wrong
  git branch -f save
  # save the state you based your changes on
  # this needs to be done *before* the fetch
  git branch -f old-head origin
  git fetch -f
  # apply your local changes on top of the new upstream head
  git rebase --onto origin old-head
  # remove temporary branch
  git branch -d old-head

Pushing changes to the main repo

Since the main repo is not publicly writable, the primary means for sending patches to the kernel team is using git-format-patch. The output from this command can then be sent to the kernel-team mailing list.

Alternatively, if you have a publicly available git repository for which changes can be pulled from, you can use git-request-pull to generate an email message to send to the kernel-team mailing list.

Commit templates

In debian/commit-templates/ there are several templates that must be used when commiting changes that you expect to be integrated with the Ubuntu kernel repo. The commit templates contain comments for how to fill out the required information. Also note that all commits must have a Signed-off-by line (the "-s" option to git-commit). A typical git-commit command will look like:

  git-commit -s -F debian/commit-templates/patch -e

Note that the -e (edit) option must follow the -F option, else git will not let you edit the commit-template before committing.

An example commit log will look like such:

  UBUNTU: scsi: My cool change to the scsi subsystem

  UpstreamStatus: Merged with 2.6.15-rc3

  My cool change to the scsi subsystem makes scsi transfers increase
  magically to 124GiB/sec.

  Signed-off-by: Joe Cool Hacker <jch@ubuntu.com>

Patch acceptance criteria

In general, Ubuntu will apply the same criteria applicable to upstream kernel. Here is a checklist of reading and tools related to posting kernel patches:

  • <kernel-directory>/Documentation/SubmittingPatches

  • <kernel-directory>/scripts/checkpatch.pl

  • <kernel-directory>/scripts/cleanpatch

  • <kernel-directory>/scripts/cleanfile

  • <kernel-directory>/scripts/Lindent

If you are creating a new file, it is helpful to run it through cleanfile and/or Linent before creating a patch
If you have generated a patch, it helps running it through checkpatch.pl and cleanpatch if necessary
Also, using the commit template described above is a good idea for Ubuntu-specific patches

Developers with access to kernel.ubuntu.com

The kernel team has a git repo located on kernel.ubuntu.com (AKA zinc.ubuntu.com) in /srv/kernel.ubuntu.com/git/ubuntu.

You can, if you want, create a clone for yourself in your directory, and just have your changes pulled when ready.

Suggested way to do this:

git-clone -l -n -s /srv/kernel.ubuntu.com/git/ubuntu/ubuntu-jaunty.git
vi ubuntu-jaunty/.git/description
( give it a descriptive name )
mv ubuntu-jaunty/.git /srv/kernel.ubuntu.com/git/<user>/my-git-tree.git

You can now push your changes to this tree via ssh. Note the -l -n -s options do a few special things, mainly making your repo share objects with ours (saves space).

Now you need to run git-update-server-info in your tree so that it is available over http transport

cd /srv/kernel.ubuntu.com/git/<user>/my-git-tree.git
git-update-server-info
chmod +x /srv/kernel.ubuntu.com/git/<user>/my-git-tree.git/hooks/post-commit

To work on your branch, now clone to your local machine from the same origin tree (not the tree you just created on zinc -- this is only for pushing to):

git clone git://kernel.ubuntu.com/ubuntu/ubuntu-jaunty.git my-tree
*do work*
git send-pack kernel.ubuntu.com:/srv/kernel.ubuntu.com/git/<user>/my-git-tree.git master

Suggested method for keeping this tree synced with the ubuntu tree, instead of git-pull, is to do:

cd my-tree
git-fetch origin
git-rebase origin

This will keep your changes on top of the original tree (as opposed to being merged). This is also a good idea because during development (e.g. while following the upstream git repo), we frequently rebase to linux-2.6.git upstream, so the HEAD is not always suitable for pull/merge.

Git tips and tricks

Reordering patches

git rebase -i HEAD~10

allows you to interactively reorder the last 10 patches in your branch. You can also squash some patches together. Just follow the directions at the bottom of the file opened up on typing the command.

More information

Please read the documentation included with the git-core package for more details on git commands. A tutorial is also available at http://www.kernel.org/pub/software/scm/git/docs/gittutorial.html.


CategoryKernel CategoryDocumentation

KernelTeam/KernelGitGuide (last edited 2010-06-28 23:55:41 by c-76-105-148-120)