|author||Eric Biggers <firstname.lastname@example.org>||Sun May 14 14:18:50 2023 -0700|
|committer||Eric Biggers <email@example.com>||Sun May 14 14:18:50 2023 -0700|
Fix finding the kernel version that a commit is based on For a commit based on a release candidate version like v6.4-rc1, make sure to return v6.3, not v6.4. Signed-off-by: Eric Biggers <firstname.lastname@example.org>
This repository contains some scripts that may be helpful for maintenance of stable and Long Term Support branches of the Linux kernel.
Install the following packages:
find-orig-patch: Finds the original patch email from a git commit.
find-orig-series: Finds the original patch series from a git commit.
find-missing-prereqs: Finds patches that were backported without previous patches in their original series also being backported.
For more information, run each script with
If anything goes wrong, using the
--verbose option might help diagnose it. There are also tests, which can be run using
Settings such as the location of the Linux git repo are defined by the
stable_utils.py. These settings can be overridden by creating a file
config.py, in this directory, that contains a method
customize(config). For example, your
config.py could contain:
import os def customize(config): config.linux_dir = os.getenv('HOME') + '/src/linux'
These scripts use two sources of information: a local Linux git repo and a remote mailing list archive server.
config.linux_dir must be a clone of Linux that contains:
Any git commit IDs that are explicitly specified in commands
A git ref
origin/master) that refers to the latest mainline. This is used to check whether commits are “upstream”.
The history going back at least to
https://lore.kernel.org) must be a public-inbox server that archives the mailing lists that the patches for the git commits are sent to. The scripts query this server to find patches.
These scripts make a large number of queries, so please don‘t run these scripts excessively. However, all responses are cached for
config.lore_cache_timeout (default: 24 hours) in the
lore_cache directory. So, redundant requests won’t be made if e.g. a script is run multiple times with the same arguments.