From Fedora Project Wiki

(small fixes and improvements)
Line 1: Line 1:
= Package repository with Linux vanilla kernel packages for Fedora =  
= Package repositories with Linux vanilla kernel packages for Fedora =  


The [http://repos.fedorapeople.org/repos/thl/ Linux kernel vanilla repositories for Fedora] offers RPM packages containing vanilla builds of different Linux kernel version lines. These packages are meant for Fedora users that want to access the latest stable versions or pre-releases of the Linux kernel quickly and comfortably. There is also one repositories meant for users who want to check if problems they face are specific to the Fedora kernel or present in the upstream kernel as well.
The [http://repos.fedorapeople.org/repos/thl/ Linux vanilla kernel repositories for Fedora] offer RPM packages containing vanilla builds of different Linux kernel version lines. These packages are meant for Fedora users that want to access the latest stable versions or pre-releases of the Linux kernel quickly and comfortably; there is also one repositories meant for users who want to check if problems they face are specific to the Fedora kernel or present in the upstream kernel as well.


= How to use these repos =
= How to use these repos =
Line 24: Line 24:
Reboot. That's it – at least often, as sometimes additional steps are necessary:
Reboot. That's it – at least often, as sometimes additional steps are necessary:


* Is UEFI Secure Boot active on your system? If you're usure run <code>mokutil --sb-state</code> to check. If it is, you'll have to disable it in your BIOS Setup or via <code>mokutil --disable-validation</code>. This is required to run kernels from these repositories, as they are not signed with a key that a typical systems trust.
* If UEFI Secure Boot is active on your system (which is the case on most modern systems), you'll have to disable it in your BIOS Setup or via <code>mokutil --disable-validation</code>. This is required to run kernels from these repositories, as they are not signed with a key a normal systems will trust. If you're don't known if UEFI Secure Boot is active on your system, run <code>mokutil --sb-state</code> to find out.  


* The newly installed kernel will normally get started by default. If that's not the case there is likely something fishy with your boot configuration. For example, if you start Fedora using a boot manger from a different Linux install you'll have to boot into the latter and update its boot loader configuration; in Ubuntu you for example do that by running <code>update-grub</code>.  
* The new kernel that above commands install will normally get started by default. If that's not the case there is likely something fishy with your boot configuration. For example, if you start Fedora using a boot manger from a different Linux install you'll have to boot into the latter and update its boot loader configuration; in Ubuntu you for example do that by running <code>update-grub</code>.  


* The "dnf update"-command doesn't offer anything to install? Then the version of the latest kernel package installed on your machine is higher than the version of the latest kernel packagers offered in the chosen kernel-vanilla repository. In that case the kernel vanilla repositories are lagging behind (its maintainers sometimes are on holiday, too), hence it might be the best to stick to the kernel your have.
* The "dnf update"-command doesn't offer anything to install? Then the version of the Fedora kernel package is higher than the version offered in the kernel-vanilla repository you chose. In that case the kernel vanilla repositories are lagging behind (its maintainers sometimes are on holiday, too!), hence it might be the best to stick to the kernel your have.


If you just want to use kernels from the kernel vanilla repositories for a short test make sure you boot into the stock Fedora kernel again once you finished your tests. After that you can uninstall the vanilla kernel packages with a comment like <code>sudo dnf remove $(rpm -qa 'kernel*' | grep '.vanilla.knurd' )</code> and everything will be as before.  
You just want to use kernels from the kernel vanilla repositories for a short test? In that case once you finished your tests boot into the stock Fedora kernel again. Then uninstall all packages from these repos with the command <code>sudo dnf remove $(rpm -qa 'kernel*' | grep '.vanilla.knurd' )</code>.  


If you would like to permanently use kernels from these repos you might want to run one of these commands, depending on the which type of kernels you want:
If you would like to permanently use kernels from these repos you might want to run one of these commands, depending on the type of kernels you want:


<pre>
<pre>
Line 39: Line 39:
</pre>
</pre>


That way "dnf" will automatically install the latest packages from those repositories.
That way dnf will automatically install the latest packages from those repositories when it updates your install the next time.


Note: This TLDR-instructions focused on the two main repositories: mainline and stable. There are two more (called mainline-wo-mergew and Fedora) for other use cases described below.  
Note: This TLDR-instructions focused on the two main repositories: mainline and stable. There are two more (called mainline-wo-mergew and fedora) for other use cases described below.  


A few common questions about these repos are answered in the [[Kernel_Vanilla_Repositories-FAQ|FAQ]].
A few common questions about these repos are answered in the [[Kernel_Vanilla_Repositories-FAQ|FAQ]].
Line 64: Line 64:
|- style="vertical-align:top;"
|- style="vertical-align:top;"
| kernel-vanilla-mainline
| kernel-vanilla-mainline
| a pre-release or git-snapshot from Linux main development branch
| a mainline kernel, which IOW is a pre-release or git-snapshot from Linux's main development branch
| those who want the latest mainline Linux
| those who want the latest mainline Linux
| 4.4, 4.5-rc0-git1, 4.5-rc1, 4.5-rc1-git2
| 4.4, 4.5-rc0-git1, 4.5-rc1, 4.5-rc1-git2
Line 70: Line 70:
| kernel-vanilla-mainline-wo-mergew
| kernel-vanilla-mainline-wo-mergew
| similar to the kernel-vanilla-mainline repo, except during the merge window, when it will contain the latest released mainline kernel or a stable kernel based on it
| similar to the kernel-vanilla-mainline repo, except during the merge window, when it will contain the latest released mainline kernel or a stable kernel based on it
| those who want the latest mainline kernel, but want to avoid development versions from the merge window (like 4.5-rc0-git1) – that the phase in the development cycle when the bulk of changes get merged for a new kernel version
| those who want the latest mainline kernel, but want to avoid development versions from the merge window – that the phase in the development cycle when the bulk of changes get merged for a new kernel version, which ends with the first pre-release, like 4.5-rc1
| 4.4, 4.4.1, 4.5-rc1, 4.5-rc1-git2
| 4.4, 4.4.1, 4.5-rc1, 4.5-rc1-git2
|- style="vertical-align:top;"
|- style="vertical-align:top;"
| kernel-vanilla-stable
| kernel-vanilla-stable
| the latest non-development version from the mainline or stable kernel series
| the latest stable kernel
| those who want the latest Linux stable kernel
| those who want the latest Linux stable kernel
| 4.4, 4.4.1, 4.4.2, 4.4.3
| 4.4, 4.4.1, 4.4.2, 4.4.3
|- style="vertical-align:top;"
|- style="vertical-align:top;"
| kernel-vanilla-fedora
| kernel-vanilla-fedora
| contains a vanilla build of the latest kernel which Fedora currently ships or has in its update queue; most of the time this repository will contain the same kernels as kernel-vanilla-stable, except for times when Fedora hasn't yet jumped to the latest version released from the mainline series.
| contains a vanilla build of the latest kernel which Fedora currently ships or has in its update queue; most of the time this repository will contain the same kernels as kernel-vanilla-stable, except for times when Fedora hasn't yet jumped to the latest version line released from the mainline series.
| those who want to check if a vanilla kernel shows the same bug or behaviour as the Fedora kernel
| those who want to check if a vanilla kernel shows the same bug or behaviour as the Fedora kernel
| 4.3.12, 4.3.13, 4.4.3, 4.4.4
| 4.3.12, 4.3.13, 4.4.3, 4.4.4
|}
|}


Decide yourself which one of those you want to use. The following examples assume you want to use the <code>
Decide yourself which of those you want to use. The following examples assume you want to use the <code>
kernel-vanilla-mainline</code> repository, hence if you want to use a different repository you'll need to adjust the commands accordingly.
kernel-vanilla-mainline</code> repository, hence if you want to use another repository you'll need to adjust the commands accordingly.


=== Install a kernel from the repository ===
=== Install a kernel from the repository ===
Line 111: Line 111:
</pre>
</pre>


DNF will proceed once you acknowledge this.  
Dnf will proceed once you acknowledge this.  


= Important notes =
= Important notes =
Line 128: Line 128:


<pre>
<pre>
releases="33 32 31"; \
releases="34 33 32"; \
branches="mainline mainline-wo-mergew stable fedora"; \
branches="mainline mainline-wo-mergew stable fedora"; \
for branch in ${branches} ; do for release in ${releases} ; do
for branch in ${branches} ; do for release in ${releases} ; do
Line 146: Line 146:
sudo dnf remove $(rpm -qa 'kernel*' | grep '.vanilla.knurd' )
sudo dnf remove $(rpm -qa 'kernel*' | grep '.vanilla.knurd' )
</pre>
</pre>
DNF will then show what is about to get uninstalled; review that list carefully and make sure you still have a none vanilla kernel on your system, otherwise you loose the ability to boot your installation. Better abort if something looks fishy.   
Dnf will then show what is about to get uninstalled; review that list carefully and make sure you still have a none vanilla kernel on your system, otherwise you loose the ability to boot your installation. Better abort if something looks fishy.   


== What is the goal of these repositories? Are these kernels as good as those Fedora provides? ==
== What is the goal of these repositories? Are these kernels as good as those Fedora provides? ==


These and many other questions are [[Kernel_Vanilla_Repositories-FAQ|answered in the FAQ about the kernel vanilla repositories]].
These and many other questions are [[Kernel_Vanilla_Repositories-FAQ|answered in the FAQ about the kernel vanilla repositories]].
= Known issues and differences =
The following sections will list differences to Fedora's proper kernel packages that might be relevant to users. It will also list known problems specific to the packaging of the vanilla kernels.
== General ==
* none known


= ToDo list =
= ToDo list =


* switch to kernel-ark as base
* create stable-rc repo
* create stable-rc repo
* maybe ship debuginfo packages
* maybe ship debuginfo packages
* automate builds more to keep repos more up2date
* automate builds fully to keep repos more up2date
* maybe enable some of the staging drivers Fedora avoids
* maybe enable some of the staging drivers Fedora avoids

Revision as of 15:39, 17 December 2020

Package repositories with Linux vanilla kernel packages for Fedora

The Linux vanilla kernel repositories for Fedora offer RPM packages containing vanilla builds of different Linux kernel version lines. These packages are meant for Fedora users that want to access the latest stable versions or pre-releases of the Linux kernel quickly and comfortably; there is also one repositories meant for users who want to check if problems they face are specific to the Fedora kernel or present in the upstream kernel as well.

How to use these repos

How to use, the TLDR version

Download the definitions for the Kernel vanilla repositories:

curl -s https://repos.fedorapeople.org/repos/thl/kernel-vanilla.repo | sudo tee /etc/yum.repos.d/kernel-vanilla.repo

Run this to install the latest mainline (aka pre-release) kernel:

sudo dnf --enablerepo=kernel-vanilla-mainline update

Run this if you want the latest stable kernel instead:

sudo dnf --enablerepo=kernel-vanilla-stable update

Reboot. That's it – at least often, as sometimes additional steps are necessary:

  • If UEFI Secure Boot is active on your system (which is the case on most modern systems), you'll have to disable it in your BIOS Setup or via mokutil --disable-validation. This is required to run kernels from these repositories, as they are not signed with a key a normal systems will trust. If you're don't known if UEFI Secure Boot is active on your system, run mokutil --sb-state to find out.
  • The new kernel that above commands install will normally get started by default. If that's not the case there is likely something fishy with your boot configuration. For example, if you start Fedora using a boot manger from a different Linux install you'll have to boot into the latter and update its boot loader configuration; in Ubuntu you for example do that by running update-grub.
  • The "dnf update"-command doesn't offer anything to install? Then the version of the Fedora kernel package is higher than the version offered in the kernel-vanilla repository you chose. In that case the kernel vanilla repositories are lagging behind (its maintainers sometimes are on holiday, too!), hence it might be the best to stick to the kernel your have.

You just want to use kernels from the kernel vanilla repositories for a short test? In that case once you finished your tests boot into the stock Fedora kernel again. Then uninstall all packages from these repos with the command sudo dnf remove $(rpm -qa 'kernel*' | grep '.vanilla.knurd' ).

If you would like to permanently use kernels from these repos you might want to run one of these commands, depending on the type of kernels you want:

sudo dnf config-manager --set-enabled kernel-vanilla-mainline
sudo dnf config-manager --set-enabled kernel-vanilla-stable

That way dnf will automatically install the latest packages from those repositories when it updates your install the next time.

Note: This TLDR-instructions focused on the two main repositories: mainline and stable. There are two more (called mainline-wo-mergew and fedora) for other use cases described below.

A few common questions about these repos are answered in the FAQ.

How to use, the verbose version

Configure the repositories

First download the repository definitions for DNF:

curl -s https://repos.fedorapeople.org/repos/thl/kernel-vanilla.repo | sudo tee /etc/yum.repos.d/kernel-vanilla.repo

This will install a repo file with following repos:

repository description target users example versions
kernel-vanilla-mainline a mainline kernel, which IOW is a pre-release or git-snapshot from Linux's main development branch those who want the latest mainline Linux 4.4, 4.5-rc0-git1, 4.5-rc1, 4.5-rc1-git2
kernel-vanilla-mainline-wo-mergew similar to the kernel-vanilla-mainline repo, except during the merge window, when it will contain the latest released mainline kernel or a stable kernel based on it those who want the latest mainline kernel, but want to avoid development versions from the merge window – that the phase in the development cycle when the bulk of changes get merged for a new kernel version, which ends with the first pre-release, like 4.5-rc1 4.4, 4.4.1, 4.5-rc1, 4.5-rc1-git2
kernel-vanilla-stable the latest stable kernel those who want the latest Linux stable kernel 4.4, 4.4.1, 4.4.2, 4.4.3
kernel-vanilla-fedora contains a vanilla build of the latest kernel which Fedora currently ships or has in its update queue; most of the time this repository will contain the same kernels as kernel-vanilla-stable, except for times when Fedora hasn't yet jumped to the latest version line released from the mainline series. those who want to check if a vanilla kernel shows the same bug or behaviour as the Fedora kernel 4.3.12, 4.3.13, 4.4.3, 4.4.4

Decide yourself which of those you want to use. The following examples assume you want to use the kernel-vanilla-mainline repository, hence if you want to use another repository you'll need to adjust the commands accordingly.

Install a kernel from the repository

Run this command to install the latest kernel from the kernel vanilla mainline repo:

sudo dnf --enablerepo=kernel-vanilla-mainline update

Alternatively you can permanently enable that repository to make DNF automatically install new kernel packages when updating the system:

sudo dnf config-manager --set-enabled kernel-vanilla-mainline
sudo dnf update

When you install a kernel from the repository for the first time DNF will ask you if you trust the public key that is used to verify the signature of the packages from the kernel vanilla repositories. It will look like this:

Retrieving key from https://repos.fedorapeople.org/repos/thl/RPM-GPG-KEY-knurd-kernel-vanilla
Importing GPG key 0x863625FA:
 Userid     : "Thorsten Leemhuis (Key for signing vanilla kernel rpms) <fedora@leemhuis.info>"
 Fingerprint: 7C71 B4C9 BF71 7876 635F 3205 4534 BEED 8636 25FA
 From       : https://repos.fedorapeople.org/repos/thl/RPM-GPG-KEY-knurd-kernel-vanilla
Is this ok [y/N]: 

Dnf will proceed once you acknowledge this.

Important notes

Please be aware that

  • none of the developers that maintain the Fedora kernel is involved in the maintenance of the Fedora kernel vanilla repositories
  • most systems work better and run in a more secure manner with the official Fedora kernels
  • if you don't understand what above commands do then you likely should not use these repositories or its packages

More details about the kernel vanilla repos

What Linux kernel versions do the various branches currently contain?

Look at the file repostatus.txt or execute the following script to query the latest status locally:

releases="34 33 32"; \
branches="mainline mainline-wo-mergew stable fedora"; \
for branch in ${branches} ; do for release in ${releases} ; do
  queryresult=$(dnf repoquery --repofrompath=repo,http://repos.fedorapeople.org/repos/thl/kernel-vanilla-${branch}/fedora-${release}/x86_64/ --disablerepo=* --enablerepo=repo --available --latest-limit=1 -q kernel 2>/dev/null)
  echo "${branch} ${release} ${queryresult:-not_available}" 
done; done | column -t | sed 's!kernel-0:!!; s!.x86_64!!;'

Who is behind this effort?

Right now the kernel vanilla repositories for Fedora are maintained by Thorsten Leemhuis (aka "knurd") only. Maybe over time people join to help, that's why this text is written as if a team is keeping care of the repositories.

How can I uninstall all kernels from the kernel vanilla repositories

Boot into a stock Fedora kernel and run

sudo dnf remove $(rpm -qa 'kernel*' | grep '.vanilla.knurd' )

Dnf will then show what is about to get uninstalled; review that list carefully and make sure you still have a none vanilla kernel on your system, otherwise you loose the ability to boot your installation. Better abort if something looks fishy.

What is the goal of these repositories? Are these kernels as good as those Fedora provides?

These and many other questions are answered in the FAQ about the kernel vanilla repositories.

ToDo list

  • switch to kernel-ark as base
  • create stable-rc repo
  • maybe ship debuginfo packages
  • automate builds fully to keep repos more up2date
  • maybe enable some of the staging drivers Fedora avoids