GitTheSource

Differences between revisions 4 and 14 (spanning 10 versions)
⇤ ← Revision 4 as of 2010-06-08 23:05:50 →
Size: 168
Editor: g225109193
Comment:
← Revision 14 as of 2020-10-26 15:44:27 → ⇥
Size: 3421
Editor: setuid
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
=== Obtaining the kernel sources for an Ubuntu release using git === == Obtaining the kernel sources for an Ubuntu release using git ==
Line 3: Line 3:
** under construction * The source for each release is maintained in its own git repository on Launchpad.
Line 5: Line 5:
{{{
git clone git://kernel.ubuntu.com/ubuntu/ubuntu-lucid.git		 The git repository is listed in the `Vcs-Git:` header in the source package and is of the following form:

    {{{
git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/<source package>/+git/<series>}}}

For example, the standard Cosmic kernel is available at:

    {{{
git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/cosmic}}}

There is a tree for each of the currently supported releases as well as any open development and upcoming releases:

 || groovy || git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/groovy ||
 || focal || git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/focal ||
 || bionic || git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/bionic ||

Replace your intended OS series in the above, and pull the source for the kernels you need.

The distro kernel is always on the master branch in these repositories. Each release also has a master-next branch containing the commits that will go onto the master branch and become the next release for that release.

A number of releases also have other source packages which represent other related but divergent kernels for other purposes. For example, there is a specialized AWS kernel available in the linux-aws source package. (Previously these sorts of things were done in [[KernelTeam/TopicBranches|Topic Branches]] and some older kernels and projects still use them.)

If you cannot use the git protocol (perhaps because of a firewall), you can use the slower http protocol. For example:

 || focal || https://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/focal ||

=== Obtaining a copy ===

To obtain a local copy you can simply `git clone` the repository for the release you are interested. The {{{git}}} command is part of the {{{git}}} package.

For example to obtain the Bionic tree:

    {{{
git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/bionic}}}

This will download several hundred megabytes of data. If you plan on working on more than one kernel release you can save space and time by downloading the upstream kernel tree. Note that once these two trees are tied together you cannot remove the virgin Linus tree without damage to the Ubuntu tree:

    {{{
git clone git://kernel.ubuntu.com/ubuntu/linux.git
git clone --reference linux git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/groovy
Line 8: Line 46:

In each case you will end up with a new directory {{{ubuntu-<release>}}} containing the source and the full history which can be manipulated using the {{{git}}} command from within each directory.

By default you will have the latest version of the kernel tree, the master tree. You can switch to any previously released kernel version using the release tags. To obtain a full list of the tagged versions in the release as below:

    {{{
$ git tag -l Ubuntu-*
Ubuntu-5.4.0-47.51
Ubuntu-5.4.0-48.52
Ubuntu-5.4.0-49.53
Ubuntu-5.4.0-51.56
Ubuntu-5.4.0-52.57
$}}}

To look at the {{{Ubuntu-5.4.0-52.57}}} version you can simply checkout a new branch pointing to that version:

    {{{
git checkout -b temp Ubuntu-5.4.0-52.57
}}}

You may then manipulate the release - for example, by adding new commits.

Obtaining the kernel sources for an Ubuntu release using git

The source for each release is maintained in its own git repository on Launchpad.

The git repository is listed in the Vcs-Git: header in the source package and is of the following form: 

  • git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/<source package>/+git/<series>

For example, the standard Cosmic kernel is available at: 

  • git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/cosmic

There is a tree for each of the currently supported releases as well as any open development and upcoming releases:

  • groovy

    git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/groovy

    focal

    git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/focal

    bionic

    git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/bionic

Replace your intended OS series in the above, and pull the source for the kernels you need.

The distro kernel is always on the master branch in these repositories. Each release also has a master-next branch containing the commits that will go onto the master branch and become the next release for that release.

A number of releases also have other source packages which represent other related but divergent kernels for other purposes. For example, there is a specialized AWS kernel available in the linux-aws source package. (Previously these sorts of things were done in Topic Branches and some older kernels and projects still use them.)

If you cannot use the git protocol (perhaps because of a firewall), you can use the slower http protocol. For example:

Obtaining a copy

To obtain a local copy you can simply git clone the repository for the release you are interested. The git command is part of the git package.

For example to obtain the Bionic tree: 

  • git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/bionic

This will download several hundred megabytes of data. If you plan on working on more than one kernel release you can save space and time by downloading the upstream kernel tree. Note that once these two trees are tied together you cannot remove the virgin Linus tree without damage to the Ubuntu tree: 

  • git clone git://kernel.ubuntu.com/ubuntu/linux.git
git clone --reference linux git://git.launchpad.net/~ubuntu-kernel/ubuntu/+source/linux/+git/groovy

In each case you will end up with a new directory ubuntu-<release> containing the source and the full history which can be manipulated using the git command from within each directory.

By default you will have the latest version of the kernel tree, the master tree. You can switch to any previously released kernel version using the release tags. To obtain a full list of the tagged versions in the release as below: 

  • $ git tag -l Ubuntu-*
Ubuntu-5.4.0-47.51
Ubuntu-5.4.0-48.52
Ubuntu-5.4.0-49.53
Ubuntu-5.4.0-51.56
Ubuntu-5.4.0-52.57
$

To look at the Ubuntu-5.4.0-52.57 version you can simply checkout a new branch pointing to that version: 

  • git checkout -b temp Ubuntu-5.4.0-52.57

You may then manipulate the release - for example, by adding new commits.

Kernel/Action/GitTheSource (last edited 2024-01-23 08:28:28 by anthonywong)