Skip to content

Commit 932c9a5

Browse files
knurdJonathan Corbet
authored andcommitted
docs: verify/bisect: add and fetch stable branches ahead of time
Add and fetch all required stable branches ahead of time. This fixes a bug, as readers that wanted to bisect a regression within a stable or longterm series otherwise did not have them available at the right time. This way also matches the flow somewhat better and avoids some "if you haven't already added it" phrases that otherwise become necessary in future changes. Signed-off-by: Thorsten Leemhuis <linux@leemhuis.info> Signed-off-by: Jonathan Corbet <corbet@lwn.net> Link: https://lore.kernel.org/r/57dcf312959476abe6151bf3d35eb79e3e9a83d1.1712647788.git.linux@leemhuis.info
1 parent abbb993 commit 932c9a5

1 file changed

Lines changed: 18 additions & 13 deletions

File tree

Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst

Lines changed: 18 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -136,8 +136,7 @@ will be considered the 'good' release and used to prepare the .config file.
136136

137137
* **Segment 3**: perform and validate the bisection.
138138

139-
a) In case your 'broken' version is a stable/longterm release, add the Git
140-
branch holding it::
139+
a) Retrieve the sources for your 'bad' version::
141140

142141
git remote set-branches --add stable linux-6.1.y
143142
git fetch stable
@@ -371,6 +370,21 @@ Preparations: set up everything to build your own kernels
371370

372371
[:ref:`details<sources_bisref>`]
373372

373+
.. _stablesources_bissbs:
374+
375+
* Retrieve the sources for any stable or longterm series you might need.
376+
377+
Is the version you earlier established as 'bad' a stable or longterm release?
378+
Then download the code for the series it belongs to ('linux-6.1.y' in this
379+
example)::
380+
381+
git remote set-branches --add stable linux-6.1.y
382+
git fetch stable
383+
384+
If the version earlier established as 'good' is from a different stable or
385+
longterm series (say 6.0.13), repeat the previous step, but this time for the
386+
branch holding the series the 'good' version belongs to (e.g. linux-6.0.y).
387+
374388
.. _oldconfig_bissbs:
375389

376390
* Start preparing a kernel build configuration (the '.config' file).
@@ -620,12 +634,10 @@ be a waste of time. [:ref:`details<introlatestcheck_bisref>`]
620634
reproduce it with the mainline kernel you just built? One that according to
621635
the `front page of kernel.org <https://kernel.org/>`_ is still supported? Then
622636
check if the latest codebase for the particular series might already fix the
623-
problem. To do so, add the stable series Git branch for your 'good' kernel
624-
(again, this here is assumed to be 6.0) and check out the latest version::
637+
problem. To do so, check out that series latest version (again, this here is
638+
assumed to be 6.0)::
625639

626640
cd ~/linux/
627-
git remote set-branches --add stable linux-6.0.y
628-
git fetch stable
629641
git switch --discard-changes --detach linux-6.0.y
630642

631643
Now use the checked out code to build and install another kernel using the
@@ -717,13 +729,6 @@ configuration created earlier this works a lot faster than many people assume:
717729
overall on average it will often just take about 10 to 15 minutes to compile
718730
each kernel on commodity x86 machines.
719731

720-
* In case your 'bad' version is a stable/longterm release (say 6.1.5), add its
721-
stable branch, unless you already did so earlier::
722-
723-
cd ~/linux/
724-
git remote set-branches --add stable linux-6.1.y
725-
git fetch stable
726-
727732
.. _bisectstart_bissbs:
728733

729734
* Start the bisection and tell Git about the versions earlier established as

0 commit comments

Comments
 (0)