€•      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ0/translations/zh_CN/admin-guide/reporting-issues”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ0/translations/zh_TW/admin-guide/reporting-issues”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ0/translations/it_IT/admin-guide/reporting-issues”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ0/translations/ja_JP/admin-guide/reporting-issues”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ0/translations/ko_KR/admin-guide/reporting-issues”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ0/translations/sp_SP/admin-guide/reporting-issues”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ0SPDX-License-Identifier: (GPL-2.0+ OR CC-BY-4.0)”h]”hŒ0SPDX-License-Identifier: (GPL-2.0+ OR CC-BY-4.0)”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒJ/var/lib/git/docbuild/linux/Documentation/admin-guide/reporting-issues.rst”h Kubh¢)”}”(hŒFSee the bottom of this file for additional redistribution information.”h]”hŒFSee the bottom of this file for additional redistribution information.”…””}”hh´sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1h¡hhhžhhŸh³h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒReporting issues”h]”hŒReporting issues”…””}”(hhÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒThe short guide (aka TL;DR)”h]”hŒThe short guide (aka TL;DR)”…””}”(hhÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhh×hžhhŸh³h K	ubhŒ	paragraph”“”)”}”(hXZ  Are you facing a regression with vanilla kernels from the same stable or
longterm series? One still supported? Then search the `LKML
<https://lore.kernel.org/lkml/>`_ and the `Linux stable mailing list
<https://lore.kernel.org/stable/>`_ archives for matching reports to join. If
you don't find any, install `the latest release from that series
<https://kernel.org/>`_. If it still shows the issue, report it to the stable
mailing list (stable@vger.kernel.org) and CC the regressions list
(regressions@lists.linux.dev); ideally also CC the maintainer and the mailing
list for the subsystem in question.”h]”(hŒAre you facing a regression with vanilla kernels from the same stable or
longterm series? One still supported? Then search the ”…””}”(hhêhžhhŸNh NubhŒ	reference”“”)”}”(hŒ'`LKML
<https://lore.kernel.org/lkml/>`_”h]”hŒLKML”…””}”(hhôhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”ŒLKML”Œrefuri”Œhttps://lore.kernel.org/lkml/”uh1hòhhêubhŒtarget”“”)”}”(hŒ 
<https://lore.kernel.org/lkml/>”h]”h}”(h]”Œlkml”ah ]”h"]”Œlkml”ah$]”h&]”Œrefuri”j  uh1j  Œ
referenced”KhhêubhŒ	 and the ”…””}”(hhêhžhhŸNh Nubhó)”}”(hŒ>`Linux stable mailing list
<https://lore.kernel.org/stable/>`_”h]”hŒLinux stable mailing list”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”ŒLinux stable mailing list”j  Œhttps://lore.kernel.org/stable/”uh1hòhhêubj  )”}”(hŒ"
<https://lore.kernel.org/stable/>”h]”h}”(h]”Œlinux-stable-mailing-list”ah ]”h"]”Œlinux stable mailing list”ah$]”h&]”Œrefuri”j*  uh1j  j  KhhêubhŒI archives for matching reports to join. If
you donâ€™t find any, install ”…””}”(hhêhžhhŸNh Nubhó)”}”(hŒ<`the latest release from that series
<https://kernel.org/>`_”h]”hŒ#the latest release from that series”…””}”(hj<  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ#the latest release from that series”j  Œhttps://kernel.org/”uh1hòhhêubj  )”}”(hŒ
<https://kernel.org/>”h]”h}”(h]”Œ#the-latest-release-from-that-series”ah ]”h"]”Œ#the latest release from that series”ah$]”h&]”Œrefuri”jL  uh1j  j  KhhêubhŒE. If it still shows the issue, report it to the stable
mailing list (”…””}”(hhêhžhhŸNh Nubhó)”}”(hŒstable@vger.kernel.org”h]”hŒstable@vger.kernel.org”…””}”(hj^  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:stable@vger.kernel.org”uh1hòhhêubhŒ) and CC the regressions list
(”…””}”(hhêhžhhŸNh Nubhó)”}”(hŒregressions@lists.linux.dev”h]”hŒregressions@lists.linux.dev”…””}”(hjr  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ"mailto:regressions@lists.linux.dev”uh1hòhhêubhŒU); ideally also CC the maintainer and the mailing
list for the subsystem in question.”…””}”(hhêhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubhé)”}”(hX  In all other cases try your best guess which kernel part might be causing the
issue. Check the :ref:`MAINTAINERS <maintainers>` file for how its developers
expect to be told about problems, which most of the time will be by email with a
mailing list in CC. Check the destination's archives for matching reports;
search the `LKML <https://lore.kernel.org/lkml/>`_ and the web, too. If you
don't find any to join, install `the latest mainline kernel
<https://kernel.org/>`_. If the issue is present there, send a report.”h]”(hŒ_In all other cases try your best guess which kernel part might be causing the
issue. Check the ”…””}”(hjŒ  hžhhŸNh Nubh)”}”(hŒ :ref:`MAINTAINERS <maintainers>`”h]”hŒinline”“”)”}”(hj–  h]”hŒMAINTAINERS”…””}”(hjš  hžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j˜  hj”  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œadmin-guide/reporting-issues”Œ	refdomain”j¥  Œreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆŒ	reftarget”Œmaintainers”uh1hhŸh³h KhjŒ  ubhŒÆ file for how its developers
expect to be told about problems, which most of the time will be by email with a
mailing list in CC. Check the destinationâ€™s archives for matching reports;
search the ”…””}”(hjŒ  hžhhŸNh Nubhó)”}”(hŒ'`LKML <https://lore.kernel.org/lkml/>`_”h]”hŒLKML”…””}”(hj½  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”ŒLKML”j  Œhttps://lore.kernel.org/lkml/”uh1hòhjŒ  ubj  )”}”(hŒ  <https://lore.kernel.org/lkml/>”h]”h}”(h]”Œid1”ah ]”h"]”h$]”Œlkml”ah&]”Œrefuri”jÍ  uh1j  j  KhjŒ  ubhŒ< and the web, too. If you
donâ€™t find any to join, install ”…””}”(hjŒ  hžhhŸNh Nubhó)”}”(hŒ3`the latest mainline kernel
<https://kernel.org/>`_”h]”hŒthe latest mainline kernel”…””}”(hjß  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œthe latest mainline kernel”j  Œhttps://kernel.org/”uh1hòhjŒ  ubj  )”}”(hŒ
<https://kernel.org/>”h]”h}”(h]”Œthe-latest-mainline-kernel”ah ]”h"]”Œthe latest mainline kernel”ah$]”h&]”Œrefuri”jï  uh1j  j  KhjŒ  ubhŒ/. If the issue is present there, send a report.”…””}”(hjŒ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubhé)”}”(hXW  The issue was fixed there, but you would like to see it resolved in a still
supported stable or longterm series as well? Then install its latest release.
If it shows the problem, search for the change that fixed it in mainline and
check if backporting is in the works or was discarded; if it's neither, ask
those who handled the change for it.”h]”hXY  The issue was fixed there, but you would like to see it resolved in a still
supported stable or longterm series as well? Then install its latest release.
If it shows the problem, search for the change that fixed it in mainline and
check if backporting is in the works or was discarded; if itâ€™s neither, ask
those who handled the change for it.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubhé)”}”(hX  **General remarks**: When installing and testing a kernel as outlined above,
ensure it's vanilla (IOW: not patched and not using add-on modules). Also make
sure it's built and running in a healthy environment and not already tainted
before the issue occurs.”h]”(hŒstrong”“”)”}”(hŒ**General remarks**”h]”hŒGeneral remarks”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubhŒò: When installing and testing a kernel as outlined above,
ensure itâ€™s vanilla (IOW: not patched and not using add-on modules). Also make
sure itâ€™s built and running in a healthy environment and not already tainted
before the issue occurs.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K#hh×hžhubhé)”}”(hX²  If you are facing multiple issues with the Linux kernel at once, report each
separately. While writing your report, include all information relevant to the
issue, like the kernel and the distro used. In case of a regression, CC the
regressions mailing list (regressions@lists.linux.dev) to your report. Also try
to pin-point the culprit with a bisection; if you succeed, include its
commit-id and CC everyone in the sign-off-by chain.”h]”(hX  If you are facing multiple issues with the Linux kernel at once, report each
separately. While writing your report, include all information relevant to the
issue, like the kernel and the distro used. In case of a regression, CC the
regressions mailing list (”…””}”(hj3  hžhhŸNh Nubhó)”}”(hŒregressions@lists.linux.dev”h]”hŒregressions@lists.linux.dev”…””}”(hj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ"mailto:regressions@lists.linux.dev”uh1hòhj3  ubhŒ•) to your report. Also try
to pin-point the culprit with a bisection; if you succeed, include its
commit-id and CC everyone in the sign-off-by chain.”…””}”(hj3  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K(hh×hžhubhé)”}”(hŒÎOnce the report is out, answer any questions that come up and help where you
can. That includes keeping the ball rolling by occasionally retesting with newer
releases and sending a status update afterwards.”h]”hŒÎOnce the report is out, answer any questions that come up and help where you
can. That includes keeping the ball rolling by occasionally retesting with newer
releases and sending a status update afterwards.”…””}”(hjU  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K/hh×hžhubeh}”(h]”Œthe-short-guide-aka-tl-dr”ah ]”h"]”Œthe short guide (aka tl;dr)”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K	ubhÃ)”}”(hhh]”(hÈ)”}”(hŒAStep-by-step guide how to report issues to the kernel maintainers”h]”hŒAStep-by-step guide how to report issues to the kernel maintainers”…””}”(hjn  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjk  hžhhŸh³h K4ubhé)”}”(hX  The above TL;DR outlines roughly how to report issues to the Linux kernel
developers. It might be all that's needed for people already familiar with
reporting issues to Free/Libre & Open Source Software (FLOSS) projects. For
everyone else there is this section. It is more detailed and uses a
step-by-step approach. It still tries to be brief for readability and leaves
out a lot of details; those are described below the step-by-step guide in a
reference section, which explains each of the steps in more detail.”h]”hX  The above TL;DR outlines roughly how to report issues to the Linux kernel
developers. It might be all thatâ€™s needed for people already familiar with
reporting issues to Free/Libre & Open Source Software (FLOSS) projects. For
everyone else there is this section. It is more detailed and uses a
step-by-step approach. It still tries to be brief for readability and leaves
out a lot of details; those are described below the step-by-step guide in a
reference section, which explains each of the steps in more detail.”…””}”(hj|  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K6hjk  hžhubhé)”}”(hX\  Note: this section covers a few more aspects than the TL;DR and does things in
a slightly different order. That's in your interest, to make sure you notice
early if an issue that looks like a Linux kernel problem is actually caused by
something else. These steps thus help to ensure the time you invest in this
process won't feel wasted in the end:”h]”hX`  Note: this section covers a few more aspects than the TL;DR and does things in
a slightly different order. Thatâ€™s in your interest, to make sure you notice
early if an issue that looks like a Linux kernel problem is actually caused by
something else. These steps thus help to ensure the time you invest in this
process wonâ€™t feel wasted in the end:”…””}”(hjŠ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K>hjk  hžhubhŒblock_quote”“”)”}”(hXT	  * Are you facing an issue with a Linux kernel a hardware or software vendor
  provided? Then in almost all cases you are better off to stop reading this
  document and reporting the issue to your vendor instead, unless you are
  willing to install the latest Linux version yourself. Be aware the latter
  will often be needed anyway to hunt down and fix issues.

* Perform a rough search for existing reports with your favorite internet
  search engine; additionally, check the archives of the `Linux Kernel Mailing
  List (LKML) <https://lore.kernel.org/lkml/>`_. If you find matching reports,
  join the discussion instead of sending a new one.

* See if the issue you are dealing with qualifies as regression, security
  issue, or a really severe problem: those are 'issues of high priority' that
  need special handling in some steps that are about to follow.

* Make sure it's not the kernel's surroundings that are causing the issue
  you face.

* Create a fresh backup and put system repair and restore tools at hand.

* Ensure your system does not enhance its kernels by building additional
  kernel modules on-the-fly, which solutions like DKMS might be doing locally
  without your knowledge.

* Check if your kernel was 'tainted' when the issue occurred, as the event
  that made the kernel set this flag might be causing the issue you face.

* Write down coarsely how to reproduce the issue. If you deal with multiple
  issues at once, create separate notes for each of them and make sure they
  work independently on a freshly booted system. That's needed, as each issue
  needs to get reported to the kernel developers separately, unless they are
  strongly entangled.

* If you are facing a regression within a stable or longterm version line
  (say something broke when updating from 5.10.4 to 5.10.5), scroll down to
  'Dealing with regressions within a stable and longterm kernel line'.

* Locate the driver or kernel subsystem that seems to be causing the issue.
  Find out how and where its developers expect reports. Note: most of the
  time this won't be bugzilla.kernel.org, as issues typically need to be sent
  by mail to a maintainer and a public mailing list.

* Search the archives of the bug tracker or mailing list in question
  thoroughly for reports that might match your issue. If you find anything,
  join the discussion instead of sending a new report.
”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hX`  Are you facing an issue with a Linux kernel a hardware or software vendor
provided? Then in almost all cases you are better off to stop reading this
document and reporting the issue to your vendor instead, unless you are
willing to install the latest Linux version yourself. Be aware the latter
will often be needed anyway to hunt down and fix issues.
”h]”hé)”}”(hX_  Are you facing an issue with a Linux kernel a hardware or software vendor
provided? Then in almost all cases you are better off to stop reading this
document and reporting the issue to your vendor instead, unless you are
willing to install the latest Linux version yourself. Be aware the latter
will often be needed anyway to hunt down and fix issues.”h]”hX_  Are you facing an issue with a Linux kernel a hardware or software vendor
provided? Then in almost all cases you are better off to stop reading this
document and reporting the issue to your vendor instead, unless you are
willing to install the latest Linux version yourself. Be aware the latter
will often be needed anyway to hunt down and fix issues.”…””}”(hj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KDhj¥  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hX  Perform a rough search for existing reports with your favorite internet
search engine; additionally, check the archives of the `Linux Kernel Mailing
List (LKML) <https://lore.kernel.org/lkml/>`_. If you find matching reports,
join the discussion instead of sending a new one.
”h]”hé)”}”(hX  Perform a rough search for existing reports with your favorite internet
search engine; additionally, check the archives of the `Linux Kernel Mailing
List (LKML) <https://lore.kernel.org/lkml/>`_. If you find matching reports,
join the discussion instead of sending a new one.”h]”(hŒPerform a rough search for existing reports with your favorite internet
search engine; additionally, check the archives of the ”…””}”(hjÁ  hžhhŸNh Nubhó)”}”(hŒC`Linux Kernel Mailing
List (LKML) <https://lore.kernel.org/lkml/>`_”h]”hŒ Linux Kernel Mailing
List (LKML)”…””}”(hjÉ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ Linux Kernel Mailing List (LKML)”j  Œhttps://lore.kernel.org/lkml/”uh1hòhjÁ  ubj  )”}”(hŒ  <https://lore.kernel.org/lkml/>”h]”h}”(h]”Œlinux-kernel-mailing-list-lkml”ah ]”h"]”Œ linux kernel mailing list (lkml)”ah$]”h&]”Œrefuri”jÙ  uh1j  j  KhjÁ  ubhŒQ. If you find matching reports,
join the discussion instead of sending a new one.”…””}”(hjÁ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KJhj½  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hŒÒSee if the issue you are dealing with qualifies as regression, security
issue, or a really severe problem: those are 'issues of high priority' that
need special handling in some steps that are about to follow.
”h]”hé)”}”(hŒÑSee if the issue you are dealing with qualifies as regression, security
issue, or a really severe problem: those are 'issues of high priority' that
need special handling in some steps that are about to follow.”h]”hŒÕSee if the issue you are dealing with qualifies as regression, security
issue, or a really severe problem: those are â€˜issues of high priorityâ€™ that
need special handling in some steps that are about to follow.”…””}”(hjû  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KOhj÷  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hŒRMake sure it's not the kernel's surroundings that are causing the issue
you face.
”h]”hé)”}”(hŒQMake sure it's not the kernel's surroundings that are causing the issue
you face.”h]”hŒUMake sure itâ€™s not the kernelâ€™s surroundings that are causing the issue
you face.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KShj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hŒGCreate a fresh backup and put system repair and restore tools at hand.
”h]”hé)”}”(hŒFCreate a fresh backup and put system repair and restore tools at hand.”h]”hŒFCreate a fresh backup and put system repair and restore tools at hand.”…””}”(hj+  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KVhj'  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hŒ«Ensure your system does not enhance its kernels by building additional
kernel modules on-the-fly, which solutions like DKMS might be doing locally
without your knowledge.
”h]”hé)”}”(hŒªEnsure your system does not enhance its kernels by building additional
kernel modules on-the-fly, which solutions like DKMS might be doing locally
without your knowledge.”h]”hŒªEnsure your system does not enhance its kernels by building additional
kernel modules on-the-fly, which solutions like DKMS might be doing locally
without your knowledge.”…””}”(hjC  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KXhj?  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hŒ‘Check if your kernel was 'tainted' when the issue occurred, as the event
that made the kernel set this flag might be causing the issue you face.
”h]”hé)”}”(hŒCheck if your kernel was 'tainted' when the issue occurred, as the event
that made the kernel set this flag might be causing the issue you face.”h]”hŒ”Check if your kernel was â€˜taintedâ€™ when the issue occurred, as the event
that made the kernel set this flag might be causing the issue you face.”…””}”(hj[  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K\hjW  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hX?  Write down coarsely how to reproduce the issue. If you deal with multiple
issues at once, create separate notes for each of them and make sure they
work independently on a freshly booted system. That's needed, as each issue
needs to get reported to the kernel developers separately, unless they are
strongly entangled.
”h]”hé)”}”(hX>  Write down coarsely how to reproduce the issue. If you deal with multiple
issues at once, create separate notes for each of them and make sure they
work independently on a freshly booted system. That's needed, as each issue
needs to get reported to the kernel developers separately, unless they are
strongly entangled.”h]”hX@  Write down coarsely how to reproduce the issue. If you deal with multiple
issues at once, create separate notes for each of them and make sure they
work independently on a freshly booted system. Thatâ€™s needed, as each issue
needs to get reported to the kernel developers separately, unless they are
strongly entangled.”…””}”(hjs  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K_hjo  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hŒ×If you are facing a regression within a stable or longterm version line
(say something broke when updating from 5.10.4 to 5.10.5), scroll down to
'Dealing with regressions within a stable and longterm kernel line'.
”h]”hé)”}”(hŒÖIf you are facing a regression within a stable or longterm version line
(say something broke when updating from 5.10.4 to 5.10.5), scroll down to
'Dealing with regressions within a stable and longterm kernel line'.”h]”hŒÚIf you are facing a regression within a stable or longterm version line
(say something broke when updating from 5.10.4 to 5.10.5), scroll down to
â€˜Dealing with regressions within a stable and longterm kernel lineâ€™.”…””}”(hj‹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Kehj‡  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hX  Locate the driver or kernel subsystem that seems to be causing the issue.
Find out how and where its developers expect reports. Note: most of the
time this won't be bugzilla.kernel.org, as issues typically need to be sent
by mail to a maintainer and a public mailing list.
”h]”hé)”}”(hX  Locate the driver or kernel subsystem that seems to be causing the issue.
Find out how and where its developers expect reports. Note: most of the
time this won't be bugzilla.kernel.org, as issues typically need to be sent
by mail to a maintainer and a public mailing list.”h]”hX  Locate the driver or kernel subsystem that seems to be causing the issue.
Find out how and where its developers expect reports. Note: most of the
time this wonâ€™t be bugzilla.kernel.org, as issues typically need to be sent
by mail to a maintainer and a public mailing list.”…””}”(hj£  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KihjŸ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hŒÂSearch the archives of the bug tracker or mailing list in question
thoroughly for reports that might match your issue. If you find anything,
join the discussion instead of sending a new report.
”h]”hé)”}”(hŒÁSearch the archives of the bug tracker or mailing list in question
thoroughly for reports that might match your issue. If you find anything,
join the discussion instead of sending a new report.”h]”hŒÁSearch the archives of the bug tracker or mailing list in question
thoroughly for reports that might match your issue. If you find anything,
join the discussion instead of sending a new report.”…””}”(hj»  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Knhj·  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jž  hŸh³h KDhjš  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h KDhjk  hžhubhé)”}”(hŒ8After these preparations you'll now enter the main part:”h]”hŒ:After these preparations youâ€™ll now enter the main part:”…””}”(hjÝ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Krhjk  hžhubj™  )”}”(hXº  * Unless you are already running the latest 'mainline' Linux kernel, better
  go and install it for the reporting process. Testing and reporting with
  the latest 'stable' Linux can be an acceptable alternative in some
  situations; during the merge window that actually might be even the best
  approach, but in that development phase it can be an even better idea to
  suspend your efforts for a few days anyway. Whatever version you choose,
  ideally use a 'vanilla' build. Ignoring these advices will dramatically
  increase the risk your report will be rejected or ignored.

* Ensure the kernel you just installed does not 'taint' itself when
  running.

* Reproduce the issue with the kernel you just installed. If it doesn't show
  up there, scroll down to the instructions for issues only happening with
  stable and longterm kernels.

* Optimize your notes: try to find and write the most straightforward way to
  reproduce your issue. Make sure the end result has all the important
  details, and at the same time is easy to read and understand for others
  that hear about it for the first time. And if you learned something in this
  process, consider searching again for existing reports about the issue.

* If your failure involves a 'panic', 'Oops', 'warning', or 'BUG', consider
  decoding the kernel log to find the line of code that triggered the error.

* If your problem is a regression, try to narrow down when the issue was
  introduced as much as possible.

* Start to compile the report by writing a detailed description about the
  issue. Always mention a few things: the latest kernel version you installed
  for reproducing, the Linux Distribution used, and your notes on how to
  reproduce the issue. Ideally, make the kernel's build configuration
  (.config) and the output from ``dmesg`` available somewhere on the net and
  link to it. Include or upload all other information that might be relevant,
  like the output/screenshot of an Oops or the output from ``lspci``. Once
  you wrote this main part, insert a normal length paragraph on top of it
  outlining the issue and the impact quickly. On top of this add one sentence
  that briefly describes the problem and gets people to read on. Now give the
  thing a descriptive title or subject that yet again is shorter. Then you're
  ready to send or file the report like the MAINTAINERS file told you, unless
  you are dealing with one of those 'issues of high priority': they need
  special care which is explained in 'Special handling for high priority
  issues' below.

* Wait for reactions and keep the thing rolling until you can accept the
  outcome in one way or the other. Thus react publicly and in a timely manner
  to any inquiries. Test proposed fixes. Do proactive testing: retest with at
  least every first release candidate (RC) of a new mainline version and
  report your results. Send friendly reminders if things stall. And try to
  help yourself, if you don't get any help or if it's unsatisfying.

”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hX3  Unless you are already running the latest 'mainline' Linux kernel, better
go and install it for the reporting process. Testing and reporting with
the latest 'stable' Linux can be an acceptable alternative in some
situations; during the merge window that actually might be even the best
approach, but in that development phase it can be an even better idea to
suspend your efforts for a few days anyway. Whatever version you choose,
ideally use a 'vanilla' build. Ignoring these advices will dramatically
increase the risk your report will be rejected or ignored.
”h]”hé)”}”(hX2  Unless you are already running the latest 'mainline' Linux kernel, better
go and install it for the reporting process. Testing and reporting with
the latest 'stable' Linux can be an acceptable alternative in some
situations; during the merge window that actually might be even the best
approach, but in that development phase it can be an even better idea to
suspend your efforts for a few days anyway. Whatever version you choose,
ideally use a 'vanilla' build. Ignoring these advices will dramatically
increase the risk your report will be rejected or ignored.”h]”hX>  Unless you are already running the latest â€˜mainlineâ€™ Linux kernel, better
go and install it for the reporting process. Testing and reporting with
the latest â€˜stableâ€™ Linux can be an acceptable alternative in some
situations; during the merge window that actually might be even the best
approach, but in that development phase it can be an even better idea to
suspend your efforts for a few days anyway. Whatever version you choose,
ideally use a â€˜vanillaâ€™ build. Ignoring these advices will dramatically
increase the risk your report will be rejected or ignored.”…””}”(hjö  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Kthjò  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjï  ubj¤  )”}”(hŒKEnsure the kernel you just installed does not 'taint' itself when
running.
”h]”hé)”}”(hŒJEnsure the kernel you just installed does not 'taint' itself when
running.”h]”hŒNEnsure the kernel you just installed does not â€˜taintâ€™ itself when
running.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K}hj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjï  ubj¤  )”}”(hŒ±Reproduce the issue with the kernel you just installed. If it doesn't show
up there, scroll down to the instructions for issues only happening with
stable and longterm kernels.
”h]”hé)”}”(hŒ°Reproduce the issue with the kernel you just installed. If it doesn't show
up there, scroll down to the instructions for issues only happening with
stable and longterm kernels.”h]”hŒ²Reproduce the issue with the kernel you just installed. If it doesnâ€™t show
up there, scroll down to the instructions for issues only happening with
stable and longterm kernels.”…””}”(hj&  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K€hj"  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjï  ubj¤  )”}”(hXl  Optimize your notes: try to find and write the most straightforward way to
reproduce your issue. Make sure the end result has all the important
details, and at the same time is easy to read and understand for others
that hear about it for the first time. And if you learned something in this
process, consider searching again for existing reports about the issue.
”h]”hé)”}”(hXk  Optimize your notes: try to find and write the most straightforward way to
reproduce your issue. Make sure the end result has all the important
details, and at the same time is easy to read and understand for others
that hear about it for the first time. And if you learned something in this
process, consider searching again for existing reports about the issue.”h]”hXk  Optimize your notes: try to find and write the most straightforward way to
reproduce your issue. Make sure the end result has all the important
details, and at the same time is easy to read and understand for others
that hear about it for the first time. And if you learned something in this
process, consider searching again for existing reports about the issue.”…””}”(hj>  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K„hj:  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjï  ubj¤  )”}”(hŒ•If your failure involves a 'panic', 'Oops', 'warning', or 'BUG', consider
decoding the kernel log to find the line of code that triggered the error.
”h]”hé)”}”(hŒ”If your failure involves a 'panic', 'Oops', 'warning', or 'BUG', consider
decoding the kernel log to find the line of code that triggered the error.”h]”hŒ¤If your failure involves a â€˜panicâ€™, â€˜Oopsâ€™, â€˜warningâ€™, or â€˜BUGâ€™, consider
decoding the kernel log to find the line of code that triggered the error.”…””}”(hjV  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KŠhjR  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjï  ubj¤  )”}”(hŒgIf your problem is a regression, try to narrow down when the issue was
introduced as much as possible.
”h]”hé)”}”(hŒfIf your problem is a regression, try to narrow down when the issue was
introduced as much as possible.”h]”hŒfIf your problem is a regression, try to narrow down when the issue was
introduced as much as possible.”…””}”(hjn  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khjj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjï  ubj¤  )”}”(hX  Start to compile the report by writing a detailed description about the
issue. Always mention a few things: the latest kernel version you installed
for reproducing, the Linux Distribution used, and your notes on how to
reproduce the issue. Ideally, make the kernel's build configuration
(.config) and the output from ``dmesg`` available somewhere on the net and
link to it. Include or upload all other information that might be relevant,
like the output/screenshot of an Oops or the output from ``lspci``. Once
you wrote this main part, insert a normal length paragraph on top of it
outlining the issue and the impact quickly. On top of this add one sentence
that briefly describes the problem and gets people to read on. Now give the
thing a descriptive title or subject that yet again is shorter. Then you're
ready to send or file the report like the MAINTAINERS file told you, unless
you are dealing with one of those 'issues of high priority': they need
special care which is explained in 'Special handling for high priority
issues' below.
”h]”hé)”}”(hX  Start to compile the report by writing a detailed description about the
issue. Always mention a few things: the latest kernel version you installed
for reproducing, the Linux Distribution used, and your notes on how to
reproduce the issue. Ideally, make the kernel's build configuration
(.config) and the output from ``dmesg`` available somewhere on the net and
link to it. Include or upload all other information that might be relevant,
like the output/screenshot of an Oops or the output from ``lspci``. Once
you wrote this main part, insert a normal length paragraph on top of it
outlining the issue and the impact quickly. On top of this add one sentence
that briefly describes the problem and gets people to read on. Now give the
thing a descriptive title or subject that yet again is shorter. Then you're
ready to send or file the report like the MAINTAINERS file told you, unless
you are dealing with one of those 'issues of high priority': they need
special care which is explained in 'Special handling for high priority
issues' below.”h]”(hX?  Start to compile the report by writing a detailed description about the
issue. Always mention a few things: the latest kernel version you installed
for reproducing, the Linux Distribution used, and your notes on how to
reproduce the issue. Ideally, make the kernelâ€™s build configuration
(.config) and the output from ”…””}”(hj†  hžhhŸNh NubhŒliteral”“”)”}”(hŒ	``dmesg``”h]”hŒdmesg”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj†  ubhŒ© available somewhere on the net and
link to it. Include or upload all other information that might be relevant,
like the output/screenshot of an Oops or the output from ”…””}”(hj†  hžhhŸNh Nubj  )”}”(hŒ	``lspci``”h]”hŒlspci”…””}”(hj¢  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj†  ubhX%  . Once
you wrote this main part, insert a normal length paragraph on top of it
outlining the issue and the impact quickly. On top of this add one sentence
that briefly describes the problem and gets people to read on. Now give the
thing a descriptive title or subject that yet again is shorter. Then youâ€™re
ready to send or file the report like the MAINTAINERS file told you, unless
you are dealing with one of those â€˜issues of high priorityâ€™: they need
special care which is explained in â€˜Special handling for high priority
issuesâ€™ below.”…””}”(hj†  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khj‚  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjï  ubj¤  )”}”(hX²  Wait for reactions and keep the thing rolling until you can accept the
outcome in one way or the other. Thus react publicly and in a timely manner
to any inquiries. Test proposed fixes. Do proactive testing: retest with at
least every first release candidate (RC) of a new mainline version and
report your results. Send friendly reminders if things stall. And try to
help yourself, if you don't get any help or if it's unsatisfying.

”h]”hé)”}”(hX°  Wait for reactions and keep the thing rolling until you can accept the
outcome in one way or the other. Thus react publicly and in a timely manner
to any inquiries. Test proposed fixes. Do proactive testing: retest with at
least every first release candidate (RC) of a new mainline version and
report your results. Send friendly reminders if things stall. And try to
help yourself, if you don't get any help or if it's unsatisfying.”h]”hX´  Wait for reactions and keep the thing rolling until you can accept the
outcome in one way or the other. Thus react publicly and in a timely manner
to any inquiries. Test proposed fixes. Do proactive testing: retest with at
least every first release candidate (RC) of a new mainline version and
report your results. Send friendly reminders if things stall. And try to
help yourself, if you donâ€™t get any help or if itâ€™s unsatisfying.”…””}”(hjÄ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K hjÀ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjï  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h Kthjë  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Kthjk  hžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒ>Reporting regressions within a stable and longterm kernel line”h]”hŒ>Reporting regressions within a stable and longterm kernel line”…””}”(hjç  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjä  hžhhŸh³h K©ubhé)”}”(hX”  This subsection is for you, if you followed above process and got sent here at
the point about regression within a stable or longterm kernel version line. You
face one of those if something breaks when updating from 5.10.4 to 5.10.5 (a
switch from 5.9.15 to 5.10.5 does not qualify). The developers want to fix such
regressions as quickly as possible, hence there is a streamlined process to
report them:”h]”hX”  This subsection is for you, if you followed above process and got sent here at
the point about regression within a stable or longterm kernel version line. You
face one of those if something breaks when updating from 5.10.4 to 5.10.5 (a
switch from 5.9.15 to 5.10.5 does not qualify). The developers want to fix such
regressions as quickly as possible, hence there is a streamlined process to
report them:”…””}”(hjõ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K«hjä  hžhubj™  )”}”(hX™  * Check if the kernel developers still maintain the Linux kernel version
  line you care about: go to the  `front page of kernel.org
  <https://kernel.org/>`_ and make sure it mentions
  the latest release of the particular version line without an '[EOL]' tag.

* Check the archives of the `Linux stable mailing list
  <https://lore.kernel.org/stable/>`_ for existing reports.

* Install the latest release from the particular version line as a vanilla
  kernel. Ensure this kernel is not tainted and still shows the problem, as
  the issue might have already been fixed there. If you first noticed the
  problem with a vendor kernel, check a vanilla build of the last version
  known to work performs fine as well.

* Send a short problem report to the Linux stable mailing list
  (stable@vger.kernel.org) and CC the Linux regressions mailing list
  (regressions@lists.linux.dev); if you suspect the cause in a particular
  subsystem, CC its maintainer and its mailing list. Roughly describe the
  issue and ideally explain how to reproduce it. Mention the first version
  that shows the problem and the last version that's working fine. Then
  wait for further instructions.
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hŒýCheck if the kernel developers still maintain the Linux kernel version
line you care about: go to the  `front page of kernel.org
<https://kernel.org/>`_ and make sure it mentions
the latest release of the particular version line without an '[EOL]' tag.
”h]”hé)”}”(hŒüCheck if the kernel developers still maintain the Linux kernel version
line you care about: go to the  `front page of kernel.org
<https://kernel.org/>`_ and make sure it mentions
the latest release of the particular version line without an '[EOL]' tag.”h]”(hŒgCheck if the kernel developers still maintain the Linux kernel version
line you care about: go to the  ”…””}”(hj  hžhhŸNh Nubhó)”}”(hŒ1`front page of kernel.org
<https://kernel.org/>`_”h]”hŒfront page of kernel.org”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œfront page of kernel.org”j  Œhttps://kernel.org/”uh1hòhj  ubj  )”}”(hŒ
<https://kernel.org/>”h]”h}”(h]”Œfront-page-of-kernel-org”ah ]”h"]”Œfront page of kernel.org”ah$]”h&]”Œrefuri”j&  uh1j  j  Khj  ubhŒh and make sure it mentions
the latest release of the particular version line without an â€˜[EOL]â€™ tag.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K²hj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubj¤  )”}”(hŒoCheck the archives of the `Linux stable mailing list
<https://lore.kernel.org/stable/>`_ for existing reports.
”h]”hé)”}”(hŒnCheck the archives of the `Linux stable mailing list
<https://lore.kernel.org/stable/>`_ for existing reports.”h]”(hŒCheck the archives of the ”…””}”(hjH  hžhhŸNh Nubhó)”}”(hŒ>`Linux stable mailing list
<https://lore.kernel.org/stable/>`_”h]”hŒLinux stable mailing list”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”ŒLinux stable mailing list”j  Œhttps://lore.kernel.org/stable/”uh1hòhjH  ubj  )”}”(hŒ"
<https://lore.kernel.org/stable/>”h]”h}”(h]”Œid2”ah ]”h"]”h$]”Œlinux stable mailing list”ah&]”Œrefuri”j`  uh1j  j  KhjH  ubhŒ for existing reports.”…””}”(hjH  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K·hjD  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubj¤  )”}”(hXH  Install the latest release from the particular version line as a vanilla
kernel. Ensure this kernel is not tainted and still shows the problem, as
the issue might have already been fixed there. If you first noticed the
problem with a vendor kernel, check a vanilla build of the last version
known to work performs fine as well.
”h]”hé)”}”(hXG  Install the latest release from the particular version line as a vanilla
kernel. Ensure this kernel is not tainted and still shows the problem, as
the issue might have already been fixed there. If you first noticed the
problem with a vendor kernel, check a vanilla build of the last version
known to work performs fine as well.”h]”hXG  Install the latest release from the particular version line as a vanilla
kernel. Ensure this kernel is not tainted and still shows the problem, as
the issue might have already been fixed there. If you first noticed the
problem with a vendor kernel, check a vanilla build of the last version
known to work performs fine as well.”…””}”(hj‚  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Kºhj~  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubj¤  )”}”(hX¾  Send a short problem report to the Linux stable mailing list
(stable@vger.kernel.org) and CC the Linux regressions mailing list
(regressions@lists.linux.dev); if you suspect the cause in a particular
subsystem, CC its maintainer and its mailing list. Roughly describe the
issue and ideally explain how to reproduce it. Mention the first version
that shows the problem and the last version that's working fine. Then
wait for further instructions.
”h]”hé)”}”(hX½  Send a short problem report to the Linux stable mailing list
(stable@vger.kernel.org) and CC the Linux regressions mailing list
(regressions@lists.linux.dev); if you suspect the cause in a particular
subsystem, CC its maintainer and its mailing list. Roughly describe the
issue and ideally explain how to reproduce it. Mention the first version
that shows the problem and the last version that's working fine. Then
wait for further instructions.”h]”(hŒ>Send a short problem report to the Linux stable mailing list
(”…””}”(hjš  hžhhŸNh Nubhó)”}”(hŒstable@vger.kernel.org”h]”hŒstable@vger.kernel.org”…””}”(hj¢  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:stable@vger.kernel.org”uh1hòhjš  ubhŒ-) and CC the Linux regressions mailing list
(”…””}”(hjš  hžhhŸNh Nubhó)”}”(hŒregressions@lists.linux.dev”h]”hŒregressions@lists.linux.dev”…””}”(hj¶  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ"mailto:regressions@lists.linux.dev”uh1hòhjš  ubhX#  ); if you suspect the cause in a particular
subsystem, CC its maintainer and its mailing list. Roughly describe the
issue and ideally explain how to reproduce it. Mention the first version
that shows the problem and the last version thatâ€™s working fine. Then
wait for further instructions.”…””}”(hjš  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KÀhj–  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h K²hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h K²hjä  hžhubhé)”}”(hŒHThe reference section below explains each of these steps in more detail.”h]”hŒHThe reference section below explains each of these steps in more detail.”…””}”(hjâ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KÈhjä  hžhubeh}”(h]”Œ>reporting-regressions-within-a-stable-and-longterm-kernel-line”ah ]”h"]”Œ>reporting regressions within a stable and longterm kernel line”ah$]”h&]”uh1hÂhjk  hžhhŸh³h K©ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ=Reporting issues only occurring in older kernel version lines”h]”hŒ=Reporting issues only occurring in older kernel version lines”…””}”(hjû  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjø  hžhhŸh³h KÌubhé)”}”(hX4  This subsection is for you, if you tried the latest mainline kernel as outlined
above, but failed to reproduce your issue there; at the same time you want to
see the issue fixed in a still supported stable or longterm series or vendor
kernels regularly rebased on those. If that the case, follow these steps:”h]”hX4  This subsection is for you, if you tried the latest mainline kernel as outlined
above, but failed to reproduce your issue there; at the same time you want to
see the issue fixed in a still supported stable or longterm series or vendor
kernels regularly rebased on those. If that the case, follow these steps:”…””}”(hj	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KÎhjø  hžhubj™  )”}”(hX>  * Prepare yourself for the possibility that going through the next few steps
  might not get the issue solved in older releases: the fix might be too big
  or risky to get backported there.

* Perform the first three steps in the section "Dealing with regressions
  within a stable and longterm kernel line" above.

* Search the Linux kernel version control system for the change that fixed
  the issue in mainline, as its commit message might tell you if the fix is
  scheduled for backporting already. If you don't find anything that way,
  search the appropriate mailing lists for posts that discuss such an issue
  or peer-review possible fixes; then check the discussions if the fix was
  deemed unsuitable for backporting. If backporting was not considered at
  all, join the newest discussion, asking if it's in the cards.

* One of the former steps should lead to a solution. If that doesn't work
  out, ask the maintainers for the subsystem that seems to be causing the
  issue for advice; CC the mailing list for the particular subsystem as well
  as the stable mailing list.
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hŒ¸Prepare yourself for the possibility that going through the next few steps
might not get the issue solved in older releases: the fix might be too big
or risky to get backported there.
”h]”hé)”}”(hŒ·Prepare yourself for the possibility that going through the next few steps
might not get the issue solved in older releases: the fix might be too big
or risky to get backported there.”h]”hŒ·Prepare yourself for the possibility that going through the next few steps
might not get the issue solved in older releases: the fix might be too big
or risky to get backported there.”…””}”(hj"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KÓhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubj¤  )”}”(hŒxPerform the first three steps in the section "Dealing with regressions
within a stable and longterm kernel line" above.
”h]”hé)”}”(hŒwPerform the first three steps in the section "Dealing with regressions
within a stable and longterm kernel line" above.”h]”hŒ{Perform the first three steps in the section â€œDealing with regressions
within a stable and longterm kernel lineâ€ above.”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K×hj6  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubj¤  )”}”(hXô  Search the Linux kernel version control system for the change that fixed
the issue in mainline, as its commit message might tell you if the fix is
scheduled for backporting already. If you don't find anything that way,
search the appropriate mailing lists for posts that discuss such an issue
or peer-review possible fixes; then check the discussions if the fix was
deemed unsuitable for backporting. If backporting was not considered at
all, join the newest discussion, asking if it's in the cards.
”h]”hé)”}”(hXó  Search the Linux kernel version control system for the change that fixed
the issue in mainline, as its commit message might tell you if the fix is
scheduled for backporting already. If you don't find anything that way,
search the appropriate mailing lists for posts that discuss such an issue
or peer-review possible fixes; then check the discussions if the fix was
deemed unsuitable for backporting. If backporting was not considered at
all, join the newest discussion, asking if it's in the cards.”h]”hX÷  Search the Linux kernel version control system for the change that fixed
the issue in mainline, as its commit message might tell you if the fix is
scheduled for backporting already. If you donâ€™t find anything that way,
search the appropriate mailing lists for posts that discuss such an issue
or peer-review possible fixes; then check the discussions if the fix was
deemed unsuitable for backporting. If backporting was not considered at
all, join the newest discussion, asking if itâ€™s in the cards.”…””}”(hjR  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KÚhjN  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubj¤  )”}”(hŒ÷One of the former steps should lead to a solution. If that doesn't work
out, ask the maintainers for the subsystem that seems to be causing the
issue for advice; CC the mailing list for the particular subsystem as well
as the stable mailing list.
”h]”hé)”}”(hŒöOne of the former steps should lead to a solution. If that doesn't work
out, ask the maintainers for the subsystem that seems to be causing the
issue for advice; CC the mailing list for the particular subsystem as well
as the stable mailing list.”h]”hŒøOne of the former steps should lead to a solution. If that doesnâ€™t work
out, ask the maintainers for the subsystem that seems to be causing the
issue for advice; CC the mailing list for the particular subsystem as well
as the stable mailing list.”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Kâhjf  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h KÓhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h KÓhjø  hžhubhé)”}”(hŒHThe reference section below explains each of these steps in more detail.”h]”hŒHThe reference section below explains each of these steps in more detail.”…””}”(hjŠ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Kçhjø  hžhubeh}”(h]”Œ=reporting-issues-only-occurring-in-older-kernel-version-lines”ah ]”h"]”Œ=reporting issues only occurring in older kernel version lines”ah$]”h&]”uh1hÂhjk  hžhhŸh³h KÌubeh}”(h]”ŒAstep-by-step-guide-how-to-report-issues-to-the-kernel-maintainers”ah ]”h"]”ŒAstep-by-step guide how to report issues to the kernel maintainers”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K4ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ=Reference section: Reporting issues to the kernel maintainers”h]”hŒ=Reference section: Reporting issues to the kernel maintainers”…””}”(hj«  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj¨  hžhhŸh³h Këubhé)”}”(hX  The detailed guides above outline all the major steps in brief fashion, which
should be enough for most people. But sometimes there are situations where even
experienced users might wonder how to actually do one of those steps. That's
what this section is for, as it will provide a lot more details on each of the
above steps. Consider this as reference documentation: it's possible to read it
from top to bottom. But it's mainly meant to skim over and a place to look up
details how to actually perform those steps.”h]”hX
  The detailed guides above outline all the major steps in brief fashion, which
should be enough for most people. But sometimes there are situations where even
experienced users might wonder how to actually do one of those steps. Thatâ€™s
what this section is for, as it will provide a lot more details on each of the
above steps. Consider this as reference documentation: itâ€™s possible to read it
from top to bottom. But itâ€™s mainly meant to skim over and a place to look up
details how to actually perform those steps.”…””}”(hj¹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Kíhj¨  hžhubhé)”}”(hŒ>A few words of general advice before digging into the details:”h]”hŒ>A few words of general advice before digging into the details:”…””}”(hjÇ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Kõhj¨  hžhubj™  )”}”(hX£  * The Linux kernel developers are well aware this process is complicated and
  demands more than other FLOSS projects. We'd love to make it simpler. But
  that would require work in various places as well as some infrastructure,
  which would need constant maintenance; nobody has stepped up to do that
  work, so that's just how things are for now.

* A warranty or support contract with some vendor doesn't entitle you to
  request fixes from developers in the upstream Linux kernel community: such
  contracts are completely outside the scope of the Linux kernel, its
  development community, and this document. That's why you can't demand
  anything such a contract guarantees in this context, not even if the
  developer handling the issue works for the vendor in question. If you want
  to claim your rights, use the vendor's support channel instead. When doing
  so, you might want to mention you'd like to see the issue fixed in the
  upstream Linux kernel; motivate them by saying it's the only way to ensure
  the fix in the end will get incorporated in all Linux distributions.

* If you never reported an issue to a FLOSS project before you should consider
  reading `How to Report Bugs Effectively
  <https://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_, `How To Ask
  Questions The Smart Way
  <http://www.catb.org/esr/faqs/smart-questions.html>`_, and `How to ask good
  questions <https://jvns.ca/blog/good-questions/>`_.
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hXT  The Linux kernel developers are well aware this process is complicated and
demands more than other FLOSS projects. We'd love to make it simpler. But
that would require work in various places as well as some infrastructure,
which would need constant maintenance; nobody has stepped up to do that
work, so that's just how things are for now.
”h]”hé)”}”(hXS  The Linux kernel developers are well aware this process is complicated and
demands more than other FLOSS projects. We'd love to make it simpler. But
that would require work in various places as well as some infrastructure,
which would need constant maintenance; nobody has stepped up to do that
work, so that's just how things are for now.”h]”hXW  The Linux kernel developers are well aware this process is complicated and
demands more than other FLOSS projects. Weâ€™d love to make it simpler. But
that would require work in various places as well as some infrastructure,
which would need constant maintenance; nobody has stepped up to do that
work, so thatâ€™s just how things are for now.”…””}”(hjà  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K÷hjÜ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjÙ  ubj¤  )”}”(hXÎ  A warranty or support contract with some vendor doesn't entitle you to
request fixes from developers in the upstream Linux kernel community: such
contracts are completely outside the scope of the Linux kernel, its
development community, and this document. That's why you can't demand
anything such a contract guarantees in this context, not even if the
developer handling the issue works for the vendor in question. If you want
to claim your rights, use the vendor's support channel instead. When doing
so, you might want to mention you'd like to see the issue fixed in the
upstream Linux kernel; motivate them by saying it's the only way to ensure
the fix in the end will get incorporated in all Linux distributions.
”h]”hé)”}”(hXÍ  A warranty or support contract with some vendor doesn't entitle you to
request fixes from developers in the upstream Linux kernel community: such
contracts are completely outside the scope of the Linux kernel, its
development community, and this document. That's why you can't demand
anything such a contract guarantees in this context, not even if the
developer handling the issue works for the vendor in question. If you want
to claim your rights, use the vendor's support channel instead. When doing
so, you might want to mention you'd like to see the issue fixed in the
upstream Linux kernel; motivate them by saying it's the only way to ensure
the fix in the end will get incorporated in all Linux distributions.”h]”hXÙ  A warranty or support contract with some vendor doesnâ€™t entitle you to
request fixes from developers in the upstream Linux kernel community: such
contracts are completely outside the scope of the Linux kernel, its
development community, and this document. Thatâ€™s why you canâ€™t demand
anything such a contract guarantees in this context, not even if the
developer handling the issue works for the vendor in question. If you want
to claim your rights, use the vendorâ€™s support channel instead. When doing
so, you might want to mention youâ€™d like to see the issue fixed in the
upstream Linux kernel; motivate them by saying itâ€™s the only way to ensure
the fix in the end will get incorporated in all Linux distributions.”…””}”(hjø  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Kýhjô  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjÙ  ubj¤  )”}”(hXU  If you never reported an issue to a FLOSS project before you should consider
reading `How to Report Bugs Effectively
<https://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_, `How To Ask
Questions The Smart Way
<http://www.catb.org/esr/faqs/smart-questions.html>`_, and `How to ask good
questions <https://jvns.ca/blog/good-questions/>`_.
”h]”hé)”}”(hXT  If you never reported an issue to a FLOSS project before you should consider
reading `How to Report Bugs Effectively
<https://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_, `How To Ask
Questions The Smart Way
<http://www.catb.org/esr/faqs/smart-questions.html>`_, and `How to ask good
questions <https://jvns.ca/blog/good-questions/>`_.”h]”(hŒUIf you never reported an issue to a FLOSS project before you should consider
reading ”…””}”(hj  hžhhŸNh Nubhó)”}”(hŒZ`How to Report Bugs Effectively
<https://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_”h]”hŒHow to Report Bugs Effectively”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”ŒHow to Report Bugs Effectively”j  Œ6https://www.chiark.greenend.org.uk/~sgtatham/bugs.html”uh1hòhj  ubj  )”}”(hŒ9
<https://www.chiark.greenend.org.uk/~sgtatham/bugs.html>”h]”h}”(h]”Œhow-to-report-bugs-effectively”ah ]”h"]”Œhow to report bugs effectively”ah$]”h&]”Œrefuri”j(  uh1j  j  Khj  ubhŒ, ”…””}”(hj  hžhhŸNh Nubhó)”}”(hŒY`How To Ask
Questions The Smart Way
<http://www.catb.org/esr/faqs/smart-questions.html>`_”h]”hŒ"How To Ask
Questions The Smart Way”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ"How To Ask Questions The Smart Way”j  Œ1http://www.catb.org/esr/faqs/smart-questions.html”uh1hòhj  ubj  )”}”(hŒ4
<http://www.catb.org/esr/faqs/smart-questions.html>”h]”h}”(h]”Œ"how-to-ask-questions-the-smart-way”ah ]”h"]”Œ"how to ask questions the smart way”ah$]”h&]”Œrefuri”jJ  uh1j  j  Khj  ubhŒ, and ”…””}”(hj  hžhhŸNh Nubhó)”}”(hŒC`How to ask good
questions <https://jvns.ca/blog/good-questions/>`_”h]”hŒHow to ask good
questions”…””}”(hj\  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”ŒHow to ask good questions”j  Œ$https://jvns.ca/blog/good-questions/”uh1hòhj  ubj  )”}”(hŒ' <https://jvns.ca/blog/good-questions/>”h]”h}”(h]”Œhow-to-ask-good-questions”ah ]”h"]”Œhow to ask good questions”ah$]”h&]”Œrefuri”jl  uh1j  j  Khj  ubhŒ.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjÙ  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h K÷hjÕ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h K÷hj¨  hžhubhé)”}”(hŒpWith that off the table, find below the details on how to properly report
issues to the Linux kernel developers.”h]”hŒpWith that off the table, find below the details on how to properly report
issues to the Linux kernel developers.”…””}”(hj–  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj¨  hžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒ0Make sure you're using the upstream Linux kernel”h]”hŒ2Make sure youâ€™re using the upstream Linux kernel”…””}”(hj§  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj¤  hžhhŸh³h Mubj™  )”}”(hXb  *Are you facing an issue with a Linux kernel a hardware or software vendor
provided? Then in almost all cases you are better off to stop reading this
document and reporting the issue to your vendor instead, unless you are
willing to install the latest Linux version yourself. Be aware the latter
will often be needed anyway to hunt down and fix issues.*
”h]”hé)”}”(hXa  *Are you facing an issue with a Linux kernel a hardware or software vendor
provided? Then in almost all cases you are better off to stop reading this
document and reporting the issue to your vendor instead, unless you are
willing to install the latest Linux version yourself. Be aware the latter
will often be needed anyway to hunt down and fix issues.*”h]”hŒemphasis”“”)”}”(hj»  h]”hX_  Are you facing an issue with a Linux kernel a hardware or software vendor
provided? Then in almost all cases you are better off to stop reading this
document and reporting the issue to your vendor instead, unless you are
willing to install the latest Linux version yourself. Be aware the latter
will often be needed anyway to hunt down and fix issues.”…””}”(hj¿  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj¹  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhjµ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Mhj¤  hžhubhé)”}”(hX¨  Like most programmers, Linux kernel developers don't like to spend time dealing
with reports for issues that don't even happen with their current code. It's
just a waste everybody's time, especially yours. Unfortunately such situations
easily happen when it comes to the kernel and often leads to frustration on both
sides. That's because almost all Linux-based kernels pre-installed on devices
(Computers, Laptops, Smartphones, Routers, â€¦) and most shipped by Linux
distributors are quite distant from the official Linux kernel as distributed by
kernel.org: these kernels from these vendors are often ancient from the point of
Linux development or heavily modified, often both.”h]”hX²  Like most programmers, Linux kernel developers donâ€™t like to spend time dealing
with reports for issues that donâ€™t even happen with their current code. Itâ€™s
just a waste everybodyâ€™s time, especially yours. Unfortunately such situations
easily happen when it comes to the kernel and often leads to frustration on both
sides. Thatâ€™s because almost all Linux-based kernels pre-installed on devices
(Computers, Laptops, Smartphones, Routers, â€¦) and most shipped by Linux
distributors are quite distant from the official Linux kernel as distributed by
kernel.org: these kernels from these vendors are often ancient from the point of
Linux development or heavily modified, often both.”…””}”(•u     hjØ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj¤  hžhubhé)”}”(hXª  Most of these vendor kernels are quite unsuitable for reporting issues to the
Linux kernel developers: an issue you face with one of them might have been
fixed by the Linux kernel developers months or years ago already; additionally,
the modifications and enhancements by the vendor might be causing the issue you
face, even if they look small or totally unrelated. That's why you should report
issues with these kernels to the vendor. Its developers should look into the
report and, in case it turns out to be an upstream issue, fix it directly
upstream or forward the report there. In practice that often does not work out
or might not what you want. You thus might want to consider circumventing the
vendor by installing the very latest Linux kernel core yourself. If that's an
option for you move ahead in this process, as a later step in this guide will
explain how to do that once it rules out other potential causes for your issue.”h]”hX®  Most of these vendor kernels are quite unsuitable for reporting issues to the
Linux kernel developers: an issue you face with one of them might have been
fixed by the Linux kernel developers months or years ago already; additionally,
the modifications and enhancements by the vendor might be causing the issue you
face, even if they look small or totally unrelated. Thatâ€™s why you should report
issues with these kernels to the vendor. Its developers should look into the
report and, in case it turns out to be an upstream issue, fix it directly
upstream or forward the report there. In practice that often does not work out
or might not what you want. You thus might want to consider circumventing the
vendor by installing the very latest Linux kernel core yourself. If thatâ€™s an
option for you move ahead in this process, as a later step in this guide will
explain how to do that once it rules out other potential causes for your issue.”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M&hj¤  hžhubhé)”}”(hX¦  Note, the previous paragraph is starting with the word 'most', as sometimes
developers in fact are willing to handle reports about issues occurring with
vendor kernels. If they do in the end highly depends on the developers and the
issue in question. Your chances are quite good if the distributor applied only
small modifications to a kernel based on a recent Linux version; that for
example often holds true for the mainline kernels shipped by Debian GNU/Linux
Sid or Fedora Rawhide. Some developers will also accept reports about issues
with kernels from distributions shipping the latest stable kernel, as long as
its only slightly modified; that for example is often the case for Arch Linux,
regular Fedora releases, and openSUSE Tumbleweed. But keep in mind, you better
want to use a mainline Linux and avoid using a stable kernel for this
process, as outlined in the section 'Install a fresh kernel for testing' in more
detail.”h]”hX®  Note, the previous paragraph is starting with the word â€˜mostâ€™, as sometimes
developers in fact are willing to handle reports about issues occurring with
vendor kernels. If they do in the end highly depends on the developers and the
issue in question. Your chances are quite good if the distributor applied only
small modifications to a kernel based on a recent Linux version; that for
example often holds true for the mainline kernels shipped by Debian GNU/Linux
Sid or Fedora Rawhide. Some developers will also accept reports about issues
with kernels from distributions shipping the latest stable kernel, as long as
its only slightly modified; that for example is often the case for Arch Linux,
regular Fedora releases, and openSUSE Tumbleweed. But keep in mind, you better
want to use a mainline Linux and avoid using a stable kernel for this
process, as outlined in the section â€˜Install a fresh kernel for testingâ€™ in more
detail.”…””}”(hjô  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M3hj¤  hžhubhé)”}”(hXu  Obviously you are free to ignore all this advice and report problems with an old
or heavily modified vendor kernel to the upstream Linux developers. But note,
those often get rejected or ignored, so consider yourself warned. But it's still
better than not reporting the issue at all: sometimes such reports directly or
indirectly will help to get the issue fixed over time.”h]”hXw  Obviously you are free to ignore all this advice and report problems with an old
or heavily modified vendor kernel to the upstream Linux developers. But note,
those often get rejected or ignored, so consider yourself warned. But itâ€™s still
better than not reporting the issue at all: sometimes such reports directly or
indirectly will help to get the issue fixed over time.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MAhj¤  hžhubeh}”(h]”Œ0make-sure-you-re-using-the-upstream-linux-kernel”ah ]”h"]”Œ0make sure you're using the upstream linux kernel”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MubhÃ)”}”(hhh]”(hÈ)”}”(hŒ&Search for existing reports, first run”h]”hŒ&Search for existing reports, first run”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj  hžhhŸh³h MIubj™  )”}”(hŒó*Perform a rough search for existing reports with your favorite internet
search engine; additionally, check the archives of the Linux Kernel Mailing
List (LKML). If you find matching reports, join the discussion instead of
sending a new one.*
”h]”hé)”}”(hŒò*Perform a rough search for existing reports with your favorite internet
search engine; additionally, check the archives of the Linux Kernel Mailing
List (LKML). If you find matching reports, join the discussion instead of
sending a new one.*”h]”j¾  )”}”(hj/  h]”hŒðPerform a rough search for existing reports with your favorite internet
search engine; additionally, check the archives of the Linux Kernel Mailing
List (LKML). If you find matching reports, join the discussion instead of
sending a new one.”…””}”(hj1  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj-  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MKhj)  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MKhj  hžhubhé)”}”(hX  Reporting an issue that someone else already brought forward is often a waste of
time for everyone involved, especially you as the reporter. So it's in your own
interest to thoroughly check if somebody reported the issue already. At this
step of the process it's okay to just perform a rough search: a later step will
tell you to perform a more detailed search once you know where your issue needs
to be reported to. Nevertheless, do not hurry with this step of the reporting
process, it can save you time and trouble.”h]”hX
  Reporting an issue that someone else already brought forward is often a waste of
time for everyone involved, especially you as the reporter. So itâ€™s in your own
interest to thoroughly check if somebody reported the issue already. At this
step of the process itâ€™s okay to just perform a rough search: a later step will
tell you to perform a more detailed search once you know where your issue needs
to be reported to. Nevertheless, do not hurry with this step of the reporting
process, it can save you time and trouble.”…””}”(hjJ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MPhj  hžhubhé)”}”(hŒ§Simply search the internet with your favorite search engine first. Afterwards,
search the `Linux Kernel Mailing List (LKML) archives
<https://lore.kernel.org/lkml/>`_.”h]”(hŒZSimply search the internet with your favorite search engine first. Afterwards,
search the ”…””}”(hjX  hžhhŸNh Nubhó)”}”(hŒL`Linux Kernel Mailing List (LKML) archives
<https://lore.kernel.org/lkml/>`_”h]”hŒ)Linux Kernel Mailing List (LKML) archives”…””}”(hj`  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ)Linux Kernel Mailing List (LKML) archives”j  Œhttps://lore.kernel.org/lkml/”uh1hòhjX  ubj  )”}”(hŒ 
<https://lore.kernel.org/lkml/>”h]”h}”(h]”Œ'linux-kernel-mailing-list-lkml-archives”ah ]”h"]”Œ)linux kernel mailing list (lkml) archives”ah$]”h&]”Œrefuri”jp  uh1j  j  KhjX  ubhŒ.”…””}”(hjX  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MXhj  hžhubhé)”}”(hXM  If you get flooded with results consider telling your search engine to limit
search timeframe to the past month or year. And wherever you search, make sure
to use good search terms; vary them a few times, too. While doing so try to
look at the issue from the perspective of someone else: that will help you to
come up with other words to use as search terms. Also make sure not to use too
many search terms at once. Remember to search with and without information like
the name of the kernel driver or the name of the affected hardware component.
But its exact brand name (say 'ASUS Red Devil Radeon RX 5700 XT Gaming OC')
often is not much helpful, as it is too specific. Instead try search terms like
the model line (Radeon 5700 or Radeon 5000) and the code name of the main chip
('Navi' or 'Navi10') with and without its manufacturer ('AMD').”h]”hX]  If you get flooded with results consider telling your search engine to limit
search timeframe to the past month or year. And wherever you search, make sure
to use good search terms; vary them a few times, too. While doing so try to
look at the issue from the perspective of someone else: that will help you to
come up with other words to use as search terms. Also make sure not to use too
many search terms at once. Remember to search with and without information like
the name of the kernel driver or the name of the affected hardware component.
But its exact brand name (say â€˜ASUS Red Devil Radeon RX 5700 XT Gaming OCâ€™)
often is not much helpful, as it is too specific. Instead try search terms like
the model line (Radeon 5700 or Radeon 5000) and the code name of the main chip
(â€˜Naviâ€™ or â€˜Navi10â€™) with and without its manufacturer (â€˜AMDâ€™).”…””}”(hjˆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M\hj  hžhubhé)”}”(hX¥  In case you find an existing report about your issue, join the discussion, as
you might be able to provide valuable additional information. That can be
important even when a fix is prepared or in its final stages already, as
developers might look for people that can provide additional information or
test a proposed fix. Jump to the section 'Duties after the report went out' for
details on how to get properly involved.”h]”hX©  In case you find an existing report about your issue, join the discussion, as
you might be able to provide valuable additional information. That can be
important even when a fix is prepared or in its final stages already, as
developers might look for people that can provide additional information or
test a proposed fix. Jump to the section â€˜Duties after the report went outâ€™ for
details on how to get properly involved.”…””}”(hj–  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhhj  hžhubhé)”}”(hX/  Note, searching `bugzilla.kernel.org <https://bugzilla.kernel.org/>`_ might also
be a good idea, as that might provide valuable insights or turn up matching
reports. If you find the latter, just keep in mind: most subsystems expect
reports in different places, as described below in the section "Check where you
need to report your issue". The developers that should take care of the issue
thus might not even be aware of the bugzilla ticket. Hence, check the ticket if
the issue already got reported as outlined in this document and if not consider
doing so.”h]”(hŒNote, searching ”…””}”(hj¤  hžhhŸNh Nubhó)”}”(hŒ5`bugzilla.kernel.org <https://bugzilla.kernel.org/>`_”h]”hŒbugzilla.kernel.org”…””}”(hj¬  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œbugzilla.kernel.org”j  Œhttps://bugzilla.kernel.org/”uh1hòhj¤  ubj  )”}”(hŒ <https://bugzilla.kernel.org/>”h]”h}”(h]”Œbugzilla-kernel-org”ah ]”h"]”Œbugzilla.kernel.org”ah$]”h&]”Œrefuri”j¼  uh1j  j  Khj¤  ubhXî   might also
be a good idea, as that might provide valuable insights or turn up matching
reports. If you find the latter, just keep in mind: most subsystems expect
reports in different places, as described below in the section â€œCheck where you
need to report your issueâ€. The developers that should take care of the issue
thus might not even be aware of the bugzilla ticket. Hence, check the ticket if
the issue already got reported as outlined in this document and if not consider
doing so.”…””}”(hj¤  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mohj  hžhubeh}”(h]”Œ%search-for-existing-reports-first-run”ah ]”h"]”Œ&search for existing reports, first run”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MIubhÃ)”}”(hhh]”(hÈ)”}”(hŒIssue of high priority?”h]”hŒIssue of high priority?”…””}”(hjß  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÜ  hžhhŸh³h Mzubj™  )”}”(hŒÔ*See if the issue you are dealing with qualifies as regression, security
issue, or a really severe problem: those are 'issues of high priority' that
need special handling in some steps that are about to follow.*
”h]”hé)”}”(hŒÓ*See if the issue you are dealing with qualifies as regression, security
issue, or a really severe problem: those are 'issues of high priority' that
need special handling in some steps that are about to follow.*”h]”j¾  )”}”(hjó  h]”hŒÕSee if the issue you are dealing with qualifies as regression, security
issue, or a really severe problem: those are â€˜issues of high priorityâ€™ that
need special handling in some steps that are about to follow.”…””}”(hjõ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjñ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M|hjí  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M|hjÜ  hžhubhé)”}”(hX*  Linus Torvalds and the leading Linux kernel developers want to see some issues
fixed as soon as possible, hence there are 'issues of high priority' that get
handled slightly differently in the reporting process. Three type of cases
qualify: regressions, security issues, and really severe problems.”h]”hX.  Linus Torvalds and the leading Linux kernel developers want to see some issues
fixed as soon as possible, hence there are â€˜issues of high priorityâ€™ that get
handled slightly differently in the reporting process. Three type of cases
qualify: regressions, security issues, and really severe problems.”…””}”(hj	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M€hjÜ  hžhubhé)”}”(hXþ  You deal with a regression if some application or practical use case running
fine with one Linux kernel works worse or not at all with a newer version
compiled using a similar configuration. The document
Documentation/admin-guide/reporting-regressions.rst explains this in more
detail. It also provides a good deal of other information about regressions you
might want to be aware of; it for example explains how to add your issue to the
list of tracked regressions, to ensure it won't fall through the cracks.”h]”hX   You deal with a regression if some application or practical use case running
fine with one Linux kernel works worse or not at all with a newer version
compiled using a similar configuration. The document
Documentation/admin-guide/reporting-regressions.rst explains this in more
detail. It also provides a good deal of other information about regressions you
might want to be aware of; it for example explains how to add your issue to the
list of tracked regressions, to ensure it wonâ€™t fall through the cracks.”…””}”(hj	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M…hjÜ  hžhubhé)”}”(hŒÌWhat qualifies as security issue is left to your judgment. Consider reading
Documentation/process/security-bugs.rst before proceeding, as it
provides additional details how to best handle security issues.”h]”hŒÌWhat qualifies as security issue is left to your judgment. Consider reading
Documentation/process/security-bugs.rst before proceeding, as it
provides additional details how to best handle security issues.”…””}”(hj*	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MhjÜ  hžhubhé)”}”(hX  An issue is a 'really severe problem' when something totally unacceptably bad
happens. That's for example the case when a Linux kernel corrupts the data it's
handling or damages hardware it's running on. You're also dealing with a severe
issue when the kernel suddenly stops working with an error message ('kernel
panic') or without any farewell note at all. Note: do not confuse a 'panic' (a
fatal error where the kernel stop itself) with a 'Oops' (a recoverable error),
as the kernel remains running after the latter.”h]”hX  An issue is a â€˜really severe problemâ€™ when something totally unacceptably bad
happens. Thatâ€™s for example the case when a Linux kernel corrupts the data itâ€™s
handling or damages hardware itâ€™s running on. Youâ€™re also dealing with a severe
issue when the kernel suddenly stops working with an error message (â€˜kernel
panicâ€™) or without any farewell note at all. Note: do not confuse a â€˜panicâ€™ (a
fatal error where the kernel stop itself) with a â€˜Oopsâ€™ (a recoverable error),
as the kernel remains running after the latter.”…””}”(hj8	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M‘hjÜ  hžhubeh}”(h]”Œissue-of-high-priority”ah ]”h"]”Œissue of high priority?”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MzubhÃ)”}”(hhh]”(hÈ)”}”(hŒEnsure a healthy environment”h]”hŒEnsure a healthy environment”…””}”(hjQ	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjN	  hžhhŸh³h M›ubj™  )”}”(hŒT*Make sure it's not the kernel's surroundings that are causing the issue
you face.*
”h]”hé)”}”(hŒS*Make sure it's not the kernel's surroundings that are causing the issue
you face.*”h]”j¾  )”}”(hje	  h]”hŒUMake sure itâ€™s not the kernelâ€™s surroundings that are causing the issue
you face.”…””}”(hjg	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjc	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj_	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MhjN	  hžhubhé)”}”(hŒ­Problems that look a lot like a kernel issue are sometimes caused by build or
runtime environment. It's hard to rule out that problem completely, but you
should minimize it:”h]”hŒ¯Problems that look a lot like a kernel issue are sometimes caused by build or
runtime environment. Itâ€™s hard to rule out that problem completely, but you
should minimize it:”…””}”(hj€	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M hjN	  hžhubj™  )”}”(hXù  * Use proven tools when building your kernel, as bugs in the compiler or the
  binutils can cause the resulting kernel to misbehave.

* Ensure your computer components run within their design specifications;
  that's especially important for the main processor, the main memory, and the
  motherboard. Therefore, stop undervolting or overclocking when facing a
  potential kernel issue.

* Try to make sure it's not faulty hardware that is causing your issue. Bad
  main memory for example can result in a multitude of issues that will
  manifest itself in problems looking like kernel issues.

* If you're dealing with a filesystem issue, you might want to check the file
  system in question with ``fsck``, as it might be damaged in a way that leads
  to unexpected kernel behavior.

* When dealing with a regression, make sure it's not something else that
  changed in parallel to updating the kernel. The problem for example might be
  caused by other software that was updated at the same time. It can also
  happen that a hardware component coincidentally just broke when you rebooted
  into a new kernel for the first time. Updating the systems BIOS or changing
  something in the BIOS Setup can also lead to problems that on look a lot
  like a kernel regression.

”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hŒUse proven tools when building your kernel, as bugs in the compiler or the
binutils can cause the resulting kernel to misbehave.
”h]”hé)”}”(hŒ€Use proven tools when building your kernel, as bugs in the compiler or the
binutils can cause the resulting kernel to misbehave.”h]”hŒ€Use proven tools when building your kernel, as bugs in the compiler or the
binutils can cause the resulting kernel to misbehave.”…””}”(hj™	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M¤hj•	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj’	  ubj¤  )”}”(hŒõEnsure your computer components run within their design specifications;
that's especially important for the main processor, the main memory, and the
motherboard. Therefore, stop undervolting or overclocking when facing a
potential kernel issue.
”h]”hé)”}”(hŒôEnsure your computer components run within their design specifications;
that's especially important for the main processor, the main memory, and the
motherboard. Therefore, stop undervolting or overclocking when facing a
potential kernel issue.”h]”hŒöEnsure your computer components run within their design specifications;
thatâ€™s especially important for the main processor, the main memory, and the
motherboard. Therefore, stop undervolting or overclocking when facing a
potential kernel issue.”…””}”(hj±	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M§hj­	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj’	  ubj¤  )”}”(hŒÈTry to make sure it's not faulty hardware that is causing your issue. Bad
main memory for example can result in a multitude of issues that will
manifest itself in problems looking like kernel issues.
”h]”hé)”}”(hŒÇTry to make sure it's not faulty hardware that is causing your issue. Bad
main memory for example can result in a multitude of issues that will
manifest itself in problems looking like kernel issues.”h]”hŒÉTry to make sure itâ€™s not faulty hardware that is causing your issue. Bad
main memory for example can result in a multitude of issues that will
manifest itself in problems looking like kernel issues.”…””}”(hjÉ	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M¬hjÅ	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj’	  ubj¤  )”}”(hŒ¸If you're dealing with a filesystem issue, you might want to check the file
system in question with ``fsck``, as it might be damaged in a way that leads
to unexpected kernel behavior.
”h]”hé)”}”(hŒ·If you're dealing with a filesystem issue, you might want to check the file
system in question with ``fsck``, as it might be damaged in a way that leads
to unexpected kernel behavior.”h]”(hŒfIf youâ€™re dealing with a filesystem issue, you might want to check the file
system in question with ”…””}”(hjá	  hžhhŸNh Nubj  )”}”(hŒ``fsck``”h]”hŒfsck”…””}”(hjé	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjá	  ubhŒK, as it might be damaged in a way that leads
to unexpected kernel behavior.”…””}”(hjá	  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M°hjÝ	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj’	  ubj¤  )”}”(hXÙ  When dealing with a regression, make sure it's not something else that
changed in parallel to updating the kernel. The problem for example might be
caused by other software that was updated at the same time. It can also
happen that a hardware component coincidentally just broke when you rebooted
into a new kernel for the first time. Updating the systems BIOS or changing
something in the BIOS Setup can also lead to problems that on look a lot
like a kernel regression.

”h]”hé)”}”(hX×  When dealing with a regression, make sure it's not something else that
changed in parallel to updating the kernel. The problem for example might be
caused by other software that was updated at the same time. It can also
happen that a hardware component coincidentally just broke when you rebooted
into a new kernel for the first time. Updating the systems BIOS or changing
something in the BIOS Setup can also lead to problems that on look a lot
like a kernel regression.”h]”hXÙ  When dealing with a regression, make sure itâ€™s not something else that
changed in parallel to updating the kernel. The problem for example might be
caused by other software that was updated at the same time. It can also
happen that a hardware component coincidentally just broke when you rebooted
into a new kernel for the first time. Updating the systems BIOS or changing
something in the BIOS Setup can also lead to problems that on look a lot
like a kernel regression.”…””}”(hj
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M´hj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj’	  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h M¤hjŽ	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M¤hjN	  hžhubeh}”(h]”Œensure-a-healthy-environment”ah ]”h"]”Œensure a healthy environment”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h M›ubhÃ)”}”(hhh]”(hÈ)”}”(hŒPrepare for emergencies”h]”hŒPrepare for emergencies”…””}”(hj6
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj3
  hžhhŸh³h M¾ubj™  )”}”(hŒI*Create a fresh backup and put system repair and restore tools at hand.*
”h]”hé)”}”(hŒH*Create a fresh backup and put system repair and restore tools at hand.*”h]”j¾  )”}”(hjJ
  h]”hŒFCreate a fresh backup and put system repair and restore tools at hand.”…””}”(hjL
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjH
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÀhjD
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MÀhj3
  hžhubhé)”}”(hXˆ  Reminder, you are dealing with computers, which sometimes do unexpected things,
especially if you fiddle with crucial parts like the kernel of its operating
system. That's what you are about to do in this process. Thus, make sure to
create a fresh backup; also ensure you have all tools at hand to repair or
reinstall the operating system as well as everything you need to restore the
backup.”h]”hXŠ  Reminder, you are dealing with computers, which sometimes do unexpected things,
especially if you fiddle with crucial parts like the kernel of its operating
system. Thatâ€™s what you are about to do in this process. Thus, make sure to
create a fresh backup; also ensure you have all tools at hand to repair or
reinstall the operating system as well as everything you need to restore the
backup.”…””}”(hje
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÂhj3
  hžhubeh}”(h]”Œprepare-for-emergencies”ah ]”h"]”Œprepare for emergencies”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h M¾ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ*Make sure your kernel doesn't get enhanced”h]”hŒ,Make sure your kernel doesnâ€™t get enhanced”…””}”(hj~
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj{
  hžhhŸh³h MËubj™  )”}”(hŒ­*Ensure your system does not enhance its kernels by building additional
kernel modules on-the-fly, which solutions like DKMS might be doing locally
without your knowledge.*
”h]”hé)”}”(hŒ¬*Ensure your system does not enhance its kernels by building additional
kernel modules on-the-fly, which solutions like DKMS might be doing locally
without your knowledge.*”h]”j¾  )”}”(hj’
  h]”hŒªEnsure your system does not enhance its kernels by building additional
kernel modules on-the-fly, which solutions like DKMS might be doing locally
without your knowledge.”…””}”(hj”
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÍhjŒ
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MÍhj{
  hžhubhé)”}”(hXŽ  The risk your issue report gets ignored or rejected dramatically increases if
your kernel gets enhanced in any way. That's why you should remove or disable
mechanisms like akmods and DKMS: those build add-on kernel modules
automatically, for example when you install a new Linux kernel or boot it for
the first time. Also remove any modules they might have installed. Then reboot
before proceeding.”h]”hX  The risk your issue report gets ignored or rejected dramatically increases if
your kernel gets enhanced in any way. Thatâ€™s why you should remove or disable
mechanisms like akmods and DKMS: those build add-on kernel modules
automatically, for example when you install a new Linux kernel or boot it for
the first time. Also remove any modules they might have installed. Then reboot
before proceeding.”…””}”(hj­
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÑhj{
  hžhubhé)”}”(hX|  Note, you might not be aware that your system is using one of these solutions:
they often get set up silently when you install Nvidia's proprietary graphics
driver, VirtualBox, or other software that requires a some support from a
module not part of the Linux kernel. That why your might need to uninstall the
packages with such software to get rid of any 3rd party kernel module.”h]”hX~  Note, you might not be aware that your system is using one of these solutions:
they often get set up silently when you install Nvidiaâ€™s proprietary graphics
driver, VirtualBox, or other software that requires a some support from a
module not part of the Linux kernel. That why your might need to uninstall the
packages with such software to get rid of any 3rd party kernel module.”…””}”(hj»
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MØhj{
  hžhubeh}”(h]”Œ*make-sure-your-kernel-doesn-t-get-enhanced”ah ]”h"]”Œ*make sure your kernel doesn't get enhanced”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MËubhÃ)”}”(hhh]”(hÈ)”}”(hŒCheck 'taint' flag”h]”hŒCheck â€˜taintâ€™ flag”…””}”(hjÔ
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÑ
  hžhhŸh³h Màubj™  )”}”(hŒ“*Check if your kernel was 'tainted' when the issue occurred, as the event
that made the kernel set this flag might be causing the issue you face.*
”h]”hé)”}”(hŒ’*Check if your kernel was 'tainted' when the issue occurred, as the event
that made the kernel set this flag might be causing the issue you face.*”h]”j¾  )”}”(hjè
  h]”hŒ”Check if your kernel was â€˜taintedâ€™ when the issue occurred, as the event
that made the kernel set this flag might be causing the issue you face.”…””}”(hjê
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjæ
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mâhjâ
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MâhjÑ
  hžhubhé)”}”(hX&  The kernel marks itself with a 'taint' flag when something happens that might
lead to follow-up errors that look totally unrelated. The issue you face might
be such an error if your kernel is tainted. That's why it's in your interest to
rule this out early before investing more time into this process. This is the
only reason why this step is here, as this process later will tell you to
install the latest mainline kernel; you will need to check the taint flag again
then, as that's when it matters because it's the kernel the report will focus
on.”h]”hX2  The kernel marks itself with a â€˜taintâ€™ flag when something happens that might
lead to follow-up errors that look totally unrelated. The issue you face might
be such an error if your kernel is tainted. Thatâ€™s why itâ€™s in your interest to
rule this out early before investing more time into this process. This is the
only reason why this step is here, as this process later will tell you to
install the latest mainline kernel; you will need to check the taint flag again
then, as thatâ€™s when it matters because itâ€™s the kernel the report will focus
on.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MåhjÑ
  hžhubhé)”}”(hXØ  On a running system is easy to check if the kernel tainted itself: if ``cat
/proc/sys/kernel/tainted`` returns '0' then the kernel is not tainted and
everything is fine. Checking that file is impossible in some situations; that's
why the kernel also mentions the taint status when it reports an internal
problem (a 'kernel bug'), a recoverable error (a 'kernel Oops') or a
non-recoverable error before halting operation (a 'kernel panic'). Look near
the top of the error messages printed when one of these occurs and search for a
line starting with 'CPU:'. It should end with 'Not tainted' if the kernel was
not tainted when it noticed the problem; it was tainted if you see 'Tainted:'
followed by a few spaces and some letters.”h]”(hŒFOn a running system is easy to check if the kernel tainted itself: if ”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ ``cat
/proc/sys/kernel/tainted``”h]”hŒcat
/proc/sys/kernel/tainted”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhX   returns â€˜0â€™ then the kernel is not tainted and
everything is fine. Checking that file is impossible in some situations; thatâ€™s
why the kernel also mentions the taint status when it reports an internal
problem (a â€˜kernel bugâ€™), a recoverable error (a â€˜kernel Oopsâ€™) or a
non-recoverable error before halting operation (a â€˜kernel panicâ€™). Look near
the top of the error messages printed when one of these occurs and search for a
line starting with â€˜CPU:â€™. It should end with â€˜Not taintedâ€™ if the kernel was
not tainted when it noticed the problem; it was tainted if you see â€˜Tainted:â€™
followed by a few spaces and some letters.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MîhjÑ
  hžhubhé)”}”(hŒ©If your kernel is tainted, study Documentation/admin-guide/tainted-kernels.rst
to find out why. Try to eliminate the reason. Often it's caused by one these
three things:”h]”hŒ«If your kernel is tainted, study Documentation/admin-guide/tainted-kernels.rst
to find out why. Try to eliminate the reason. Often itâ€™s caused by one these
three things:”…””}”(hj1  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MùhjÑ
  hžhubj™  )”}”(hXÀ  1. A recoverable error (a 'kernel Oops') occurred and the kernel tainted
   itself, as the kernel knows it might misbehave in strange ways after that
   point. In that case check your kernel or system log and look for a section
   that starts with this::

      Oops: 0000 [#1] SMP

   That's the first Oops since boot-up, as the '#1' between the brackets shows.
   Every Oops and any other problem that happens after that point might be a
   follow-up problem to that first Oops, even if both look totally unrelated.
   Rule this out by getting rid of the cause for the first Oops and reproducing
   the issue afterwards. Sometimes simply restarting will be enough, sometimes
   a change to the configuration followed by a reboot can eliminate the Oops.
   But don't invest too much time into this at this point of the process, as
   the cause for the Oops might already be fixed in the newer Linux kernel
   version you are going to install later in this process.

2. Your system uses a software that installs its own kernel modules, for
   example Nvidia's proprietary graphics driver or VirtualBox. The kernel
   taints itself when it loads such module from external sources (even if
   they are Open Source): they sometimes cause errors in unrelated kernel
   areas and thus might be causing the issue you face. You therefore have to
   prevent those modules from loading when you want to report an issue to the
   Linux kernel developers. Most of the time the easiest way to do that is:
   temporarily uninstall such software including any modules they might have
   installed. Afterwards reboot.

3. The kernel also taints itself when it's loading a module that resides in
   the staging tree of the Linux kernel source. That's a special area for
   code (mostly drivers) that does not yet fulfill the normal Linux kernel
   quality standards. When you report an issue with such a module it's
   obviously okay if the kernel is tainted; just make sure the module in
   question is the only reason for the taint. If the issue happens in an
   unrelated area reboot and temporarily block the module from being loaded
   by specifying ``foo.blacklist=1`` as kernel parameter (replace 'foo' with
   the name of the module in question).

”h]”hŒenumerated_list”“”)”}”(hhh]”(j¤  )”}”(hXœ  A recoverable error (a 'kernel Oops') occurred and the kernel tainted
itself, as the kernel knows it might misbehave in strange ways after that
point. In that case check your kernel or system log and look for a section
that starts with this::

   Oops: 0000 [#1] SMP

That's the first Oops since boot-up, as the '#1' between the brackets shows.
Every Oops and any other problem that happens after that point might be a
follow-up problem to that first Oops, even if both look totally unrelated.
Rule this out by getting rid of the cause for the first Oops and reproducing
the issue afterwards. Sometimes simply restarting will be enough, sometimes
a change to the configuration followed by a reboot can eliminate the Oops.
But don't invest too much time into this at this point of the process, as
the cause for the Oops might already be fixed in the newer Linux kernel
version you are going to install later in this process.
”h]”(hé)”}”(hŒòA recoverable error (a 'kernel Oops') occurred and the kernel tainted
itself, as the kernel knows it might misbehave in strange ways after that
point. In that case check your kernel or system log and look for a section
that starts with this::”h]”hŒõA recoverable error (a â€˜kernel Oopsâ€™) occurred and the kernel tainted
itself, as the kernel knows it might misbehave in strange ways after that
point. In that case check your kernel or system log and look for a section
that starts with this:”…””}”(hjL  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MýhjH  ubhŒliteral_block”“”)”}”(hŒOops: 0000 [#1] SMP”h]”hŒOops: 0000 [#1] SMP”…””}”hj\  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h MhjH  ubhé)”}”(hX  That's the first Oops since boot-up, as the '#1' between the brackets shows.
Every Oops and any other problem that happens after that point might be a
follow-up problem to that first Oops, even if both look totally unrelated.
Rule this out by getting rid of the cause for the first Oops and reproducing
the issue afterwards. Sometimes simply restarting will be enough, sometimes
a change to the configuration followed by a reboot can eliminate the Oops.
But don't invest too much time into this at this point of the process, as
the cause for the Oops might already be fixed in the newer Linux kernel
version you are going to install later in this process.”h]”hX—  Thatâ€™s the first Oops since boot-up, as the â€˜#1â€™ between the brackets shows.
Every Oops and any other problem that happens after that point might be a
follow-up problem to that first Oops, even if both look totally unrelated.
Rule this out by getting rid of the cause for the first Oops and reproducing
the issue afterwards. Sometimes simply restarting will be enough, sometimes
a change to the configuration followed by a reboot can eliminate the Oops.
But donâ€™t invest too much time into this at this point of the process, as
the cause for the Oops might already be fixed in the newer Linux kernel
version you are going to install later in this process.”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MhjH  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjE  ubj¤  )”}”(hXa  Your system uses a software that installs its own kernel modules, for
example Nvidia's proprietary graphics driver or VirtualBox. The kernel
taints itself when it loads such module from external sources (even if
they are Open Source): they sometimes cause errors in unrelated kernel
areas and thus might be causing the issue you face. You therefore have to
prevent those modules from loading when you want to report an issue to the
Linux kernel developers. Most of the time the easiest way to do that is:
temporarily uninstall such software including any modules they might have
installed. Afterwards reboot.
”h]”hé)”}”(hX`  Your system uses a software that installs its own kernel modules, for
example Nvidia's proprietary graphics driver or VirtualBox. The kernel
taints itself when it loads such module from external sources (even if
they are Open Source): they sometimes cause errors in unrelated kernel
areas and thus might be causing the issue you face. You therefore have to
prevent those modules from loading when you want to report an issue to the
Linux kernel developers. Most of the time the easiest way to do that is:
temporarily uninstall such software including any modules they might have
installed. Afterwards reboot.”h]”hXb  Your system uses a software that installs its own kernel modules, for
example Nvidiaâ€™s proprietary graphics driver or VirtualBox. The kernel
taints itself when it loads such module from external sources (even if
they are Open Source): they sometimes cause errors in unrelated kernel
areas and thus might be causing the issue you face. You therefore have to
prevent those modules from loading when you want to report an issue to the
Linux kernel developers. Most of the time the easiest way to do that is:
temporarily uninstall such software including any modules they might have
installed. Afterwards reboot.”…””}”(hj‚  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj~  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjE  ubj¤  )”}”(hXa  The kernel also taints itself when it's loading a module that resides in
the staging tree of the Linux kernel source. That's a special area for
code (mostly drivers) that does not yet fulfill the normal Linux kernel
quality standards. When you report an issue with such a module it's
obviously okay if the kernel is tainted; just make sure the module in
question is the only reason for the taint. If the issue happens in an
unrelated area reboot and temporarily block the module from being loaded
by specifying ``foo.blacklist=1`` as kernel parameter (replace 'foo' with
the name of the module in question).

”h]”hé)”}”(hX_  The kernel also taints itself when it's loading a module that resides in
the staging tree of the Linux kernel source. That's a special area for
code (mostly drivers) that does not yet fulfill the normal Linux kernel
quality standards. When you report an issue with such a module it's
obviously okay if the kernel is tainted; just make sure the module in
question is the only reason for the taint. If the issue happens in an
unrelated area reboot and temporarily block the module from being loaded
by specifying ``foo.blacklist=1`` as kernel parameter (replace 'foo' with
the name of the module in question).”h]”(hX  The kernel also taints itself when itâ€™s loading a module that resides in
the staging tree of the Linux kernel source. Thatâ€™s a special area for
code (mostly drivers) that does not yet fulfill the normal Linux kernel
quality standards. When you report an issue with such a module itâ€™s
obviously okay if the kernel is tainted; just make sure the module in
question is the only reason for the taint. If the issue happens in an
unrelated area reboot and temporarily block the module from being loaded
by specifying ”…””}”(hjš  hžhhŸNh Nubj  )”}”(hŒ``foo.blacklist=1``”h]”hŒfoo.blacklist=1”…””}”(hj¢  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjš  ubhŒQ as kernel parameter (replace â€˜fooâ€™ with
the name of the module in question).”…””}”(hjš  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj–  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjE  ubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1jC  hj?  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MýhjÑ
  hžhubeh}”(h]”Œcheck-taint-flag”ah ]”h"]”h$]”Œcheck 'taint' flag”ah&]”uh1hÂhj¨  hžhhŸh³h Màj  KubhÃ)”}”(hhh]”(hÈ)”}”(hŒDocument how to reproduce issue”h]”hŒDocument how to reproduce issue”…””}”(hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÙ  hžhhŸh³h M$ubj™  )”}”(hXA  *Write down coarsely how to reproduce the issue. If you deal with multiple
issues at once, create separate notes for each of them and make sure they
work independently on a freshly booted system. That's needed, as each issue
needs to get reported to the kernel developers separately, unless they are
strongly entangled.*
”h]”hé)”}”(hX@  *Write down coarsely how to reproduce the issue. If you deal with multiple
issues at once, create separate notes for each of them and make sure they
work independently on a freshly booted system. That's needed, as each issue
needs to get reported to the kernel developers separately, unless they are
strongly entangled.*”h]”j¾  )”}”(hjð  h]”hX@  Write down coarsely how to reproduce the issue. If you deal with multiple
issues at once, create separate notes for each of them and make sure they
work independently on a freshly booted system. Thatâ€™s needed, as each issue
needs to get reported to the kernel developers separately, unless they are
strongly entangled.”…””}”(hjò  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjî  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M&hjê  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M&hjÙ  hžhubhé)”}”(hX;  If you deal with multiple issues at once, you'll have to report each of them
separately, as they might be handled by different developers. Describing
various issues in one report also makes it quite difficult for others to tear
it apart. Hence, only combine issues in one report if they are very strongly
entangled.”h]”hX=  If you deal with multiple issues at once, youâ€™ll have to report each of them
separately, as they might be handled by different developers. Describing
various issues in one report also makes it quite difficult for others to tear
it apart. Hence, only combine issues in one report if they are very strongly
entangled.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M,hjÙ  hžhubhé)”}”(hŒìAdditionally, during the reporting process you will have to test if the issue
happens with other kernel versions. Therefore, it will make your work easier if
you know exactly how to reproduce an issue quickly on a freshly booted system.”h]”hŒìAdditionally, during the reporting process you will have to test if the issue
happens with other kernel versions. Therefore, it will make your work easier if
you know exactly how to reproduce an issue quickly on a freshly booted system.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M2hjÙ  hžhubhé)”}”(hX˜  Note: it's often fruitless to report issues that only happened once, as they
might be caused by a bit flip due to cosmic radiation. That's why you should
try to rule that out by reproducing the issue before going further. Feel free
to ignore this advice if you are experienced enough to tell a one-time error
due to faulty hardware apart from a kernel issue that rarely happens and thus
is hard to reproduce.”h]”hXœ  Note: itâ€™s often fruitless to report issues that only happened once, as they
might be caused by a bit flip due to cosmic radiation. Thatâ€™s why you should
try to rule that out by reproducing the issue before going further. Feel free
to ignore this advice if you are experienced enough to tell a one-time error
due to faulty hardware apart from a kernel issue that rarely happens and thus
is hard to reproduce.”…””}”(hj'  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M6hjÙ  hžhubeh}”(h]”Œdocument-how-to-reproduce-issue”ah ]”h"]”Œdocument how to reproduce issue”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h M$ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ(Regression in stable or longterm kernel?”h]”hŒ(Regression in stable or longterm kernel?”…””}”(hj@  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj=  hžhhŸh³h M?ubj™  )”}”(hŒÙ*If you are facing a regression within a stable or longterm version line
(say something broke when updating from 5.10.4 to 5.10.5), scroll down to
'Dealing with regressions within a stable and longterm kernel line'.*
”h]”hé)”}”(hŒØ*If you are facing a regression within a stable or longterm version line
(say something broke when updating from 5.10.4 to 5.10.5), scroll down to
'Dealing with regressions within a stable and longterm kernel line'.*”h]”j¾  )”}”(hjT  h]”hŒÚIf you are facing a regression within a stable or longterm version line
(say something broke when updating from 5.10.4 to 5.10.5), scroll down to
â€˜Dealing with regressions within a stable and longterm kernel lineâ€™.”…””}”(hjV  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjR  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MAhjN  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MAhj=  hžhubhé)”}”(hXð  Regression within a stable and longterm kernel version line are something the
Linux developers want to fix badly, as such issues are even more unwanted than
regression in the main development branch, as they can quickly affect a lot of
people. The developers thus want to learn about such issues as quickly as
possible, hence there is a streamlined process to report them. Note,
regressions with newer kernel version line (say something broke when switching
from 5.9.15 to 5.10.5) do not qualify.”h]”hXð  Regression within a stable and longterm kernel version line are something the
Linux developers want to fix badly, as such issues are even more unwanted than
regression in the main development branch, as they can quickly affect a lot of
people. The developers thus want to learn about such issues as quickly as
possible, hence there is a streamlined process to report them. Note,
regressions with newer kernel version line (say something broke when switching
from 5.9.15 to 5.10.5) do not qualify.”…””}”(hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MEhj=  hžhubeh}”(h]”Œ'regression-in-stable-or-longterm-kernel”ah ]”h"]”Œ(regression in stable or longterm kernel?”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h M?ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ)Check where you need to report your issue”h]”hŒ)Check where you need to report your issue”…””}”(hjˆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj…  hžhhŸh³h MOubj™  )”}”(hX  *Locate the driver or kernel subsystem that seems to be causing the issue.
Find out how and where its developers expect reports. Note: most of the
time this won't be bugzilla.kernel.org, as issues typically need to be sent
by mail to a maintainer and a public mailing list.*
”h]”hé)”}”(hX  *Locate the driver or kernel subsystem that seems to be causing the issue.
Find out how and where its developers expect reports. Note: most of the
time this won't be bugzilla.kernel.org, as issues typically need to be sent
by mail to a maintainer and a public mailing list.*”h]”j¾  )”}”(hjœ  h]”hX  Locate the driver or kernel subsystem that seems to be causing the issue.
Find out how and where its developers expect reports. Note: most of the
time this wonâ€™t be bugzilla.kernel.org, as issues typically need to be sent
by mail to a maintainer and a public mailing list.”…””}”(hjž  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjš  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MQhj–  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MQhj…  hžhubhé)”}”(hXÈ  It's crucial to send your report to the right people, as the Linux kernel is a
big project and most of its developers are only familiar with a small subset of
it. Quite a few programmers for example only care for just one driver, for
example one for a WiFi chip; its developer likely will only have small or no
knowledge about the internals of remote or unrelated "subsystems", like the TCP
stack, the PCIe/PCI subsystem, memory management or file systems.”h]”hXÎ  Itâ€™s crucial to send your report to the right people, as the Linux kernel is a
big project and most of its developers are only familiar with a small subset of
it. Quite a few programmers for example only care for just one driver, for
example one for a WiFi chip; its developer likely will only have small or no
knowledge about the internals of remote or unrelated â€œsubsystemsâ€, like the TCP
stack, the PCIe/PCI subsystem, memory management or file systems.”…””}”(hj·  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MVhj…  hžhubhé)”}”(hX’  Problem is: the Linux kernel lacks a central bug tracker where you can simply
file your issue and make it reach the developers that need to know about it.
That's why you have to find the right place and way to report issues yourself.
You can do that with the help of a script (see below), but it mainly targets
kernel developers and experts. For everybody else the MAINTAINERS file is the
better place.”h]”hX”  Problem is: the Linux kernel lacks a central bug tracker where you can simply
file your issue and make it reach the developers that need to know about it.
Thatâ€™s why you have to find the right place and way to report issues yourself.
You can do that with the help of a script (see below), but it mainly targets
kernel developers and experts. For everybody else the MAINTAINERS file is the
better place.”…””}”(hjÅ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M]hj…  hžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒ How to read the MAINTAINERS file”h]”hŒ How to read the MAINTAINERS file”…””}”(hjÖ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÓ  hžhhŸh³h Meubhé)”}”(hXœ  To illustrate how to use the :ref:`MAINTAINERS <maintainers>` file, lets assume
the WiFi in your Laptop suddenly misbehaves after updating the kernel. In that
case it's likely an issue in the WiFi driver. Obviously it could also be some
code it builds upon, but unless you suspect something like that stick to the
driver. If it's really something else, the driver's developers will get the
right people involved.”h]”(hŒTo illustrate how to use the ”…””}”(hjä  hžhhŸNh Nubh)”}”(hŒ :ref:`MAINTAINERS <maintainers>`”h]”j™  )”}”(hjî  h]”hŒMAINTAINERS”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”(j¤  Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j˜  hjì  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j±  Œ	refdomain”jú  Œreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆj·  Œmaintainers”uh1hhŸh³h Mfhjä  ubhXe   file, lets assume
the WiFi in your Laptop suddenly misbehaves after updating the kernel. In that
case itâ€™s likely an issue in the WiFi driver. Obviously it could also be some
code it builds upon, but unless you suspect something like that stick to the
driver. If itâ€™s really something else, the driverâ€™s developers will get the
right people involved.”…””}”(hjä  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MfhjÓ  hžhubhé)”}”(hŒvSadly, there is no way to check which code is driving a particular hardware
component that is both universal and easy.”h]”hŒvSadly, there is no way to check which code is driving a particular hardware
component that is both universal and easy.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MmhjÓ  hžhubhé)”}”(hŒ¶In case of a problem with the WiFi driver you for example might want to look at
the output of ``lspci -k``, as it lists devices on the PCI/PCIe bus and the
kernel module driving it::”h]”(hŒ^In case of a problem with the WiFi driver you for example might want to look at
the output of ”…””}”(hj$  hžhhŸNh Nubj  )”}”(hŒ``lspci -k``”h]”hŒlspci -k”…””}”(hj,  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj$  ubhŒK, as it lists devices on the PCI/PCIe bus and the
kernel module driving it:”…””}”(hj$  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MphjÓ  hžhubj[  )”}”(hŒø[user@something ~]$ lspci -k
[...]
3a:00.0 Network controller: Qualcomm Atheros QCA6174 802.11ac Wireless Network Adapter (rev 32)
  Subsystem: Bigfoot Networks, Inc. Device 1535
  Kernel driver in use: ath10k_pci
  Kernel modules: ath10k_pci
[...]”h]”hŒø[user@something ~]$ lspci -k
[...]
3a:00.0 Network controller: Qualcomm Atheros QCA6174 802.11ac Wireless Network Adapter (rev 32)
  Subsystem: Bigfoot Networks, Inc. Device 1535
  Kernel driver in use: ath10k_pci
  Kernel modules: ath10k_pci
[...]”…””}”hjD  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h MthjÓ  hžhubhé)”}”(hXX  But this approach won't work if your WiFi chip is connected over USB or some
other internal bus. In those cases you might want to check your WiFi manager or
the output of ``ip link``. Look for the name of the problematic network
interface, which might be something like 'wlp58s0'. This name can be used like
this to find the module driving it::”h]”(hŒ­But this approach wonâ€™t work if your WiFi chip is connected over USB or some
other internal bus. In those cases you might want to check your WiFi manager or
the output of ”…””}”(hjR  hžhhŸNh Nubj  )”}”(hŒ``ip link``”h]”hŒip link”…””}”(hjZ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjR  ubhŒ¥. Look for the name of the problematic network
interface, which might be something like â€˜wlp58s0â€™. This name can be used like
this to find the module driving it:”…””}”(hjR  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M|hjÓ  hžhubj[  )”}”(hŒn[user@something ~]$ realpath --relative-to=/sys/module/ /sys/class/net/wlp58s0/device/driver/module
ath10k_pci”h]”hŒn[user@something ~]$ realpath --relative-to=/sys/module/ /sys/class/net/wlp58s0/device/driver/module
ath10k_pci”…””}”hjr  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h M‚hjÓ  hžhubhé)”}”(hŒ÷In case tricks like these don't bring you any further, try to search the
internet on how to narrow down the driver or subsystem in question. And if you
are unsure which it is: just try your best guess, somebody will help you if you
guessed poorly.”h]”hŒùIn case tricks like these donâ€™t bring you any further, try to search the
internet on how to narrow down the driver or subsystem in question. And if you
are unsure which it is: just try your best guess, somebody will help you if you
guessed poorly.”…””}”(hj€  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M…hjÓ  hžhubhé)”}”(hXq  Once you know the driver or subsystem, you want to search for it in the
MAINTAINERS file. In the case of 'ath10k_pci' you won't find anything, as the
name is too specific. Sometimes you will need to search on the net for help;
but before doing so, try a somewhat shorted or modified name when searching the
MAINTAINERS file, as then you might find something like this::”h]”hXv  Once you know the driver or subsystem, you want to search for it in the
MAINTAINERS file. In the case of â€˜ath10k_pciâ€™ you wonâ€™t find anything, as the
name is too specific. Sometimes you will need to search on the net for help;
but before doing so, try a somewhat shorted or modified name when searching the
MAINTAINERS file, as then you might find something like this:”…””}”(hjŽ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MŠhjÓ  hžhubj[  )”}”(hXc  QUALCOMM ATHEROS ATH10K WIRELESS DRIVER
Mail:          A. Some Human <shuman@example.com>
Mailing list:  ath10k@lists.infradead.org
Status:        Supported
Web-page:      https://wireless.wiki.kernel.org/en/users/Drivers/ath10k
SCM:           git git://git.kernel.org/pub/scm/linux/kernel/git/kvalo/ath.git
Files:         drivers/net/wireless/ath/ath10k/”h]”hXc  QUALCOMM ATHEROS ATH10K WIRELESS DRIVER
Mail:          A. Some Human <shuman@example.com>
Mailing list:  ath10k@lists.infradead.org
Status:        Supported
Web-page:      https://wireless.wiki.kernel.org/en/users/Drivers/ath10k
SCM:           git git://git.kernel.org/pub/scm/linux/kernel/git/kvalo/ath.git
Files:         drivers/net/wireless/ath/ath10k/”…””}”hjœ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h MhjÓ  hžhubhé)”}”(hX*  Note: the line description will be abbreviations, if you read the plain
MAINTAINERS file found in the root of the Linux source tree. 'Mail:' for
example will be 'M:', 'Mailing list:' will be 'L', and 'Status:' will be 'S:'.
A section near the top of the file explains these and other abbreviations.”h]”hXB  Note: the line description will be abbreviations, if you read the plain
MAINTAINERS file found in the root of the Linux source tree. â€˜Mail:â€™ for
example will be â€˜M:â€™, â€˜Mailing list:â€™ will be â€˜Lâ€™, and â€˜Status:â€™ will be â€˜S:â€™.
A section near the top of the file explains these and other abbreviations.”…””}”(hjª  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M˜hjÓ  hžhubhé)”}”(hX  First look at the line 'Status'. Ideally it should be 'Supported' or
'Maintained'. If it states 'Obsolete' then you are using some outdated approach
that was replaced by a newer solution you need to switch to. Sometimes the code
only has someone who provides 'Odd Fixes' when feeling motivated. And with
'Orphan' you are totally out of luck, as nobody takes care of the code anymore.
That only leaves these options: arrange yourself to live with the issue, fix it
yourself, or find a programmer somewhere willing to fix it.”h]”hX#  First look at the line â€˜Statusâ€™. Ideally it should be â€˜Supportedâ€™ or
â€˜Maintainedâ€™. If it states â€˜Obsoleteâ€™ then you are using some outdated approach
that was replaced by a newer solution you need to switch to. Sometimes the code
only has someone who provides â€˜Odd Fixesâ€™ when feeling motivated. And with
â€˜Orphanâ€™ you are totally out of luck, as nobody takes care of the code anymore.
That only leaves these options: arrange yourself to live with the issue, fix it
yourself, or find a programmer somewhere willing to fix it.”…””}”(hj¸  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MhjÓ  hžhubhé)”}”(hX{  After checking the status, look for a line starting with 'bugs:': it will tell
you where to find a subsystem specific bug tracker to file your issue. The
example above does not have such a line. That is the case for most sections, as
Linux kernel development is completely driven by mail. Very few subsystems use
a bug tracker, and only some of those rely on bugzilla.kernel.org.”h]”hX  After checking the status, look for a line starting with â€˜bugs:â€™: it will tell
you where to find a subsystem specific bug tracker to file your issue. The
example above does not have such a line. That is the case for most sections, as
Linux kernel development is completely driven by mail. Very few subsystems use
a bug tracker, and only some of those rely on bugzilla.kernel.org.”…””}”(hjÆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M¥hjÓ  hžhubhé)”}”(hX  In this and many other cases you thus have to look for lines starting with
'Mail:' instead. Those mention the name and the email addresses for the
maintainers of the particular code. Also look for a line starting with 'Mailing
list:', which tells you the public mailing list where the code is developed.
Your report later needs to go by mail to those addresses. Additionally, for all
issue reports sent by email, make sure to add the Linux Kernel Mailing List
(LKML) <linux-kernel@vger.kernel.org> to CC. Don't omit either of the mailing
lists when sending your issue report by mail later! Maintainers are busy people
and might leave some work for other developers on the subsystem specific list;
and LKML is important to have one place where all issue reports can be found.”h]”(hXÜ  In this and many other cases you thus have to look for lines starting with
â€˜Mail:â€™ instead. Those mention the name and the email addresses for the
maintainers of the particular code. Also look for a line starting with â€˜Mailing
list:â€™, which tells you the public mailing list where the code is developed.
Your report later needs to go by mail to those addresses. Additionally, for all
issue reports sent by email, make sure to add the Linux Kernel Mailing List
(LKML) <”…””}”(hjÔ  hžhhŸNh Nubhó)”}”(hŒlinux-kernel@vger.kernel.org”h]”hŒlinux-kernel@vger.kernel.org”…””}”(hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ#mailto:linux-kernel@vger.kernel.org”uh1hòhjÔ  ubhX  > to CC. Donâ€™t omit either of the mailing
lists when sending your issue report by mail later! Maintainers are busy people
and might leave some work for other developers on the subsystem specific list;
and LKML is important to have one place where all issue reports can be found.”…””}”(hjÔ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M«hjÓ  hžhubeh}”(h]”Œ how-to-read-the-maintainers-file”ah ]”h"]”Œ how to read the maintainers file”ah$]”h&]”uh1hÂhj…  hžhhŸh³h MeubhÃ)”}”(hhh]”(hÈ)”}”(hŒ1Finding the maintainers with the help of a script”h]”hŒ1Finding the maintainers with the help of a script”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjþ  hžhhŸh³h M¸ubhé)”}”(hXp  For people that have the Linux sources at hand there is a second option to find
the proper place to report: the script 'scripts/get_maintainer.pl' which tries
to find all people to contact. It queries the MAINTAINERS file and needs to be
called with a path to the source code in question. For drivers compiled as
module if often can be found with a command like this::”h]”hXs  For people that have the Linux sources at hand there is a second option to find
the proper place to report: the script â€˜scripts/get_maintainer.plâ€™ which tries
to find all people to contact. It queries the MAINTAINERS file and needs to be
called with a path to the source code in question. For drivers compiled as
module if often can be found with a command like this:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mºhjþ  hžhubj[  )”}”(hŒ™$ modinfo ath10k_pci | grep filename | sed 's!/lib/modules/.*/kernel/!!; s!filename:!!; s!\.ko\(\|\.xz\)!!'
drivers/net/wireless/ath/ath10k/ath10k_pci.ko”h]”hŒ™$ modinfo ath10k_pci | grep filename | sed 's!/lib/modules/.*/kernel/!!; s!filename:!!; s!\.ko\(\|\.xz\)!!'
drivers/net/wireless/ath/ath10k/ath10k_pci.ko”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h MÀhjþ  hžhubhé)”}”(hŒ"Pass parts of this to the script::”h]”hŒ!Pass parts of this to the script:”…””}”(hj+  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÃhjþ  hžhubj[  )”}”(hXÖ  $ ./scripts/get_maintainer.pl -f drivers/net/wireless/ath/ath10k*
Some Human <shuman@example.com> (supporter:QUALCOMM ATHEROS ATH10K WIRELESS DRIVER)
Another S. Human <asomehuman@example.com> (maintainer:NETWORKING DRIVERS)
ath10k@lists.infradead.org (open list:QUALCOMM ATHEROS ATH10K WIRELESS DRIVER)
linux-wireless@vger.kernel.org (open list:NETWORKING DRIVERS (WIRELESS))
netdev@vger.kernel.org (open list:NETWORKING DRIVERS)
linux-kernel@vger.kernel.org (open list)”•      h]”hXÖ  $ ./scripts/get_maintainer.pl -f drivers/net/wireless/ath/ath10k*
Some Human <shuman@example.com> (supporter:QUALCOMM ATHEROS ATH10K WIRELESS DRIVER)
Another S. Human <asomehuman@example.com> (maintainer:NETWORKING DRIVERS)
ath10k@lists.infradead.org (open list:QUALCOMM ATHEROS ATH10K WIRELESS DRIVER)
linux-wireless@vger.kernel.org (open list:NETWORKING DRIVERS (WIRELESS))
netdev@vger.kernel.org (open list:NETWORKING DRIVERS)
linux-kernel@vger.kernel.org (open list)”…””}”hj9  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h MÅhjþ  hžhubhé)”}”(hXy  Don't sent your report to all of them. Send it to the maintainers, which the
script calls "supporter:"; additionally CC the most specific mailing list for
the code as well as the Linux Kernel Mailing List (LKML). In this case you thus
would need to send the report to 'Some Human <shuman@example.com>' with
'ath10k@lists.infradead.org' and 'linux-kernel@vger.kernel.org' in CC.”h]”(hX!  Donâ€™t sent your report to all of them. Send it to the maintainers, which the
script calls â€œsupporter:â€; additionally CC the most specific mailing list for
the code as well as the Linux Kernel Mailing List (LKML). In this case you thus
would need to send the report to â€˜Some Human <”…””}”(hjG  hžhhŸNh Nubhó)”}”(hŒshuman@example.com”h]”hŒshuman@example.com”…””}”(hjO  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:shuman@example.com”uh1hòhjG  ubhŒ
>â€™ with
”…””}”(hjG  hžhhŸNh Nubhó)”}”(hŒ'ath10k@lists.infradead.org”h]”hŒâ€˜ath10k@lists.infradead.org”…””}”(hjc  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ"mailto:'ath10k@lists.infradead.org”uh1hòhjG  ubhŒâ€™ and ”…””}”(hjG  hžhhŸNh Nubhó)”}”(hŒ'linux-kernel@vger.kernel.org”h]”hŒâ€˜linux-kernel@vger.kernel.org”…””}”(hjw  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ$mailto:'linux-kernel@vger.kernel.org”uh1hòhjG  ubhŒ
â€™ in CC.”…””}”(hjG  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÍhjþ  hžhubhé)”}”(hX6  Note: in case you cloned the Linux sources with git you might want to call
``get_maintainer.pl`` a second time with ``--git``. The script then will look
at the commit history to find which people recently worked on the code in
question, as they might be able to help. But use these results with care, as it
can easily send you in a wrong direction. That for example happens quickly in
areas rarely changed (like old or unmaintained drivers): sometimes such code is
modified during tree-wide cleanups by developers that do not care about the
particular driver at all.”h]”(hŒKNote: in case you cloned the Linux sources with git you might want to call
”…””}”(hj‘  hžhhŸNh Nubj  )”}”(hŒ``get_maintainer.pl``”h]”hŒget_maintainer.pl”…””}”(hj™  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj‘  ubhŒ a second time with ”…””}”(hj‘  hžhhŸNh Nubj  )”}”(hŒ	``--git``”h]”hŒ--git”…””}”(hj«  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj‘  ubhX¹  . The script then will look
at the commit history to find which people recently worked on the code in
question, as they might be able to help. But use these results with care, as it
can easily send you in a wrong direction. That for example happens quickly in
areas rarely changed (like old or unmaintained drivers): sometimes such code is
modified during tree-wide cleanups by developers that do not care about the
particular driver at all.”…””}”(hj‘  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÓhjþ  hžhubeh}”(h]”Œ1finding-the-maintainers-with-the-help-of-a-script”ah ]”h"]”Œ1finding the maintainers with the help of a script”ah$]”h&]”uh1hÂhj…  hžhhŸh³h M¸ubeh}”(h]”Œ)check-where-you-need-to-report-your-issue”ah ]”h"]”Œ)check where you need to report your issue”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MOubhÃ)”}”(hhh]”(hÈ)”}”(hŒ'Search for existing reports, second run”h]”hŒ'Search for existing reports, second run”…””}”(hjÖ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÓ  hžhhŸh³h MÞubj™  )”}”(hŒÄ*Search the archives of the bug tracker or mailing list in question
thoroughly for reports that might match your issue. If you find anything,
join the discussion instead of sending a new report.*
”h]”hé)”}”(hŒÃ*Search the archives of the bug tracker or mailing list in question
thoroughly for reports that might match your issue. If you find anything,
join the discussion instead of sending a new report.*”h]”j¾  )”}”(hjê  h]”hŒÁSearch the archives of the bug tracker or mailing list in question
thoroughly for reports that might match your issue. If you find anything,
join the discussion instead of sending a new report.”…””}”(hjì  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjè  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Màhjä  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MàhjÓ  hžhubhé)”}”(hX€  As mentioned earlier already: reporting an issue that someone else already
brought forward is often a waste of time for everyone involved, especially you
as the reporter. That's why you should search for existing report again, now
that you know where they need to be reported to. If it's mailing list, you will
often find its archives on `lore.kernel.org <https://lore.kernel.org/>`_.”h]”(hXV  As mentioned earlier already: reporting an issue that someone else already
brought forward is often a waste of time for everyone involved, especially you
as the reporter. Thatâ€™s why you should search for existing report again, now
that you know where they need to be reported to. If itâ€™s mailing list, you will
often find its archives on ”…””}”(hj  hžhhŸNh Nubhó)”}”(hŒ-`lore.kernel.org <https://lore.kernel.org/>`_”h]”hŒlore.kernel.org”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œlore.kernel.org”j  Œhttps://lore.kernel.org/”uh1hòhj  ubj  )”}”(hŒ <https://lore.kernel.org/>”h]”h}”(h]”Œlore-kernel-org”ah ]”h"]”Œlore.kernel.org”ah$]”h&]”Œrefuri”j  uh1j  j  Khj  ubhŒ.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MähjÓ  hžhubhé)”}”(hXó  But some list are hosted in different places. That for example is the case for
the ath10k WiFi driver used as example in the previous step. But you'll often
find the archives for these lists easily on the net. Searching for 'archive
ath10k@lists.infradead.org' for example will lead you to the `Info page for the
ath10k mailing list <https://lists.infradead.org/mailman/listinfo/ath10k>`_,
which at the top links to its
`list archives <https://lists.infradead.org/pipermail/ath10k/>`_. Sadly this and
quite a few other lists miss a way to search the archives. In those cases use a
regular internet search engine and add something like
'site:lists.infradead.org/pipermail/ath10k/' to your search terms, which limits
the results to the archives at that URL.”h]”(hŒíBut some list are hosted in different places. That for example is the case for
the ath10k WiFi driver used as example in the previous step. But youâ€™ll often
find the archives for these lists easily on the net. Searching for â€˜archive
”…””}”(hj5  hžhhŸNh Nubhó)”}”(hŒath10k@lists.infradead.org”h]”hŒath10k@lists.infradead.org”…””}”(hj=  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ!mailto:ath10k@lists.infradead.org”uh1hòhj5  ubhŒ%â€™ for example will lead you to the ”…””}”(hj5  hžhhŸNh Nubhó)”}”(hŒ^`Info page for the
ath10k mailing list <https://lists.infradead.org/mailman/listinfo/ath10k>`_”h]”hŒ%Info page for the
ath10k mailing list”…””}”(hjQ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ%Info page for the ath10k mailing list”j  Œ3https://lists.infradead.org/mailman/listinfo/ath10k”uh1hòhj5  ubj  )”}”(hŒ6 <https://lists.infradead.org/mailman/listinfo/ath10k>”h]”h}”(h]”Œ%info-page-for-the-ath10k-mailing-list”ah ]”h"]”Œ%info page for the ath10k mailing list”ah$]”h&]”Œrefuri”ja  uh1j  j  Khj5  ubhŒ ,
which at the top links to its
”…””}”(hj5  hžhhŸNh Nubhó)”}”(hŒ@`list archives <https://lists.infradead.org/pipermail/ath10k/>`_”h]”hŒlist archives”…””}”(hjs  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œlist archives”j  Œ-https://lists.infradead.org/pipermail/ath10k/”uh1hòhj5  ubj  )”}”(hŒ0 <https://lists.infradead.org/pipermail/ath10k/>”h]”h}”(h]”Œlist-archives”ah ]”h"]”Œlist archives”ah$]”h&]”Œrefuri”jƒ  uh1j  j  Khj5  ubhX  . Sadly this and
quite a few other lists miss a way to search the archives. In those cases use a
regular internet search engine and add something like
â€˜site:lists.infradead.org/pipermail/ath10k/â€™ to your search terms, which limits
the results to the archives at that URL.”…””}”(hj5  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MêhjÓ  hžhubhé)”}”(hX	  It's also wise to check the internet, LKML and maybe bugzilla.kernel.org again
at this point. If your report needs to be filed in a bug tracker, you may want
to check the mailing list archives for the subsystem as well, as someone might
have reported it only there.”h]”hX  Itâ€™s also wise to check the internet, LKML and maybe bugzilla.kernel.org again
at this point. If your report needs to be filed in a bug tracker, you may want
to check the mailing list archives for the subsystem as well, as someone might
have reported it only there.”…””}”(hj›  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MöhjÓ  hžhubhé)”}”(hŒyFor details how to search and what to do if you find matching reports see
"Search for existing reports, first run" above.”h]”hŒ}For details how to search and what to do if you find matching reports see
â€œSearch for existing reports, first runâ€ above.”…””}”(hj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MûhjÓ  hžhubhé)”}”(hŒšDo not hurry with this step of the reporting process: spending 30 to 60 minutes
or even more time can save you and others quite a lot of time and trouble.”h]”hŒšDo not hurry with this step of the reporting process: spending 30 to 60 minutes
or even more time can save you and others quite a lot of time and trouble.”…””}”(hj·  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MþhjÓ  hžhubeh}”(h]”Œ&search-for-existing-reports-second-run”ah ]”h"]”Œ'search for existing reports, second run”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MÞubhÃ)”}”(hhh]”(hÈ)”}”(hŒ"Install a fresh kernel for testing”h]”hŒ"Install a fresh kernel for testing”…””}”(hjÐ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÍ  hžhhŸh³h Mubj™  )”}”(hX5  *Unless you are already running the latest 'mainline' Linux kernel, better
go and install it for the reporting process. Testing and reporting with
the latest 'stable' Linux can be an acceptable alternative in some
situations; during the merge window that actually might be even the best
approach, but in that development phase it can be an even better idea to
suspend your efforts for a few days anyway. Whatever version you choose,
ideally use a 'vanilla' built. Ignoring these advices will dramatically
increase the risk your report will be rejected or ignored.*
”h]”hé)”}”(hX4  *Unless you are already running the latest 'mainline' Linux kernel, better
go and install it for the reporting process. Testing and reporting with
the latest 'stable' Linux can be an acceptable alternative in some
situations; during the merge window that actually might be even the best
approach, but in that development phase it can be an even better idea to
suspend your efforts for a few days anyway. Whatever version you choose,
ideally use a 'vanilla' built. Ignoring these advices will dramatically
increase the risk your report will be rejected or ignored.*”h]”j¾  )”}”(hjä  h]”hX>  Unless you are already running the latest â€˜mainlineâ€™ Linux kernel, better
go and install it for the reporting process. Testing and reporting with
the latest â€˜stableâ€™ Linux can be an acceptable alternative in some
situations; during the merge window that actually might be even the best
approach, but in that development phase it can be an even better idea to
suspend your efforts for a few days anyway. Whatever version you choose,
ideally use a â€˜vanillaâ€™ built. Ignoring these advices will dramatically
increase the risk your report will be rejected or ignored.”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjâ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MhjÞ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MhjÍ  hžhubhé)”}”(hX6  As mentioned in the detailed explanation for the first step already: Like most
programmers, Linux kernel developers don't like to spend time dealing with
reports for issues that don't even happen with the current code. It's just a
waste everybody's time, especially yours. That's why it's in everybody's
interest that you confirm the issue still exists with the latest upstream code
before reporting it. You are free to ignore this advice, but as outlined
earlier: doing so dramatically increases the risk that your issue report might
get rejected or simply ignored.”h]”hXD  As mentioned in the detailed explanation for the first step already: Like most
programmers, Linux kernel developers donâ€™t like to spend time dealing with
reports for issues that donâ€™t even happen with the current code. Itâ€™s just a
waste everybodyâ€™s time, especially yours. Thatâ€™s why itâ€™s in everybodyâ€™s
interest that you confirm the issue still exists with the latest upstream code
before reporting it. You are free to ignore this advice, but as outlined
earlier: doing so dramatically increases the risk that your issue report might
get rejected or simply ignored.”…””}”(hjÿ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MhjÍ  hžhubhé)”}”(hŒ<In the scope of the kernel "latest upstream" normally means:”h]”hŒ@In the scope of the kernel â€œlatest upstreamâ€ normally means:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MhjÍ  hžhubj™  )”}”(hXF  * Install a mainline kernel; the latest stable kernel can be an option, but
  most of the time is better avoided. Longterm kernels (sometimes called 'LTS
  kernels') are unsuitable at this point of the process. The next subsection
  explains all of this in more detail.

* The over next subsection describes way to obtain and install such a kernel.
  It also outlines that using a pre-compiled kernel are fine, but better are
  vanilla, which means: it was built using Linux sources taken straight `from
  kernel.org <https://kernel.org/>`_ and not modified or enhanced in any way.
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hX  Install a mainline kernel; the latest stable kernel can be an option, but
most of the time is better avoided. Longterm kernels (sometimes called 'LTS
kernels') are unsuitable at this point of the process. The next subsection
explains all of this in more detail.
”h]”hé)”}”(hX  Install a mainline kernel; the latest stable kernel can be an option, but
most of the time is better avoided. Longterm kernels (sometimes called 'LTS
kernels') are unsuitable at this point of the process. The next subsection
explains all of this in more detail.”h]”hX	  Install a mainline kernel; the latest stable kernel can be an option, but
most of the time is better avoided. Longterm kernels (sometimes called â€˜LTS
kernelsâ€™) are unsuitable at this point of the process. The next subsection
explains all of this in more detail.”…””}”(hj&  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj"  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubj¤  )”}”(hX/  The over next subsection describes way to obtain and install such a kernel.
It also outlines that using a pre-compiled kernel are fine, but better are
vanilla, which means: it was built using Linux sources taken straight `from
kernel.org <https://kernel.org/>`_ and not modified or enhanced in any way.
”h]”hé)”}”(hX.  The over next subsection describes way to obtain and install such a kernel.
It also outlines that using a pre-compiled kernel are fine, but better are
vanilla, which means: it was built using Linux sources taken straight `from
kernel.org <https://kernel.org/>`_ and not modified or enhanced in any way.”h]”(hŒÝThe over next subsection describes way to obtain and install such a kernel.
It also outlines that using a pre-compiled kernel are fine, but better are
vanilla, which means: it was built using Linux sources taken straight ”…””}”(hj>  hžhhŸNh Nubhó)”}”(hŒ(`from
kernel.org <https://kernel.org/>`_”h]”hŒfrom
kernel.org”…””}”(hjF  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œfrom kernel.org”j  Œhttps://kernel.org/”uh1hòhj>  ubj  )”}”(hŒ <https://kernel.org/>”h]”h}”(h]”Œfrom-kernel-org”ah ]”h"]”Œfrom kernel.org”ah$]”h&]”Œrefuri”jV  uh1j  j  Khj>  ubhŒ) and not modified or enhanced in any way.”…””}”(hj>  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj:  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h Mhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MhjÍ  hžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒ&Choosing the right version for testing”h]”hŒ&Choosing the right version for testing”…””}”(hjƒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj€  hžhhŸh³h M$ubhé)”}”(hXc  Head over to `kernel.org <https://kernel.org/>`_ to find out which version you
want to use for testing. Ignore the big yellow button that says 'Latest release'
and look a little lower at the table. At its top you'll see a line starting with
mainline, which most of the time will point to a pre-release with a version
number like '5.8-rc2'. If that's the case, you'll want to use this mainline
kernel for testing, as that where all fixes have to be applied first. Do not let
that 'rc' scare you, these 'development kernels' are pretty reliable â€” and you
made a backup, as you were instructed above, didn't you?”h]”(hŒHead over to ”…””}”(hj‘  hžhhŸNh Nubhó)”}”(hŒ#`kernel.org <https://kernel.org/>`_”h]”hŒ
kernel.org”…””}”(hj™  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ
kernel.org”j  Œhttps://kernel.org/”uh1hòhj‘  ubj  )”}”(hŒ <https://kernel.org/>”h]”h}”(h]”Œ
kernel-org”ah ]”h"]”Œ
kernel.org”ah$]”h&]”Œrefuri”j©  uh1j  j  Khj‘  ubhXK   to find out which version you
want to use for testing. Ignore the big yellow button that says â€˜Latest releaseâ€™
and look a little lower at the table. At its top youâ€™ll see a line starting with
mainline, which most of the time will point to a pre-release with a version
number like â€˜5.8-rc2â€™. If thatâ€™s the case, youâ€™ll want to use this mainline
kernel for testing, as that where all fixes have to be applied first. Do not let
that â€˜rcâ€™ scare you, these â€˜development kernelsâ€™ are pretty reliable â€” and you
made a backup, as you were instructed above, didnâ€™t you?”…””}”(hj‘  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M&hj€  hžhubhé)”}”(hXg  In about two out of every nine to ten weeks, mainline might point you to a
proper release with a version number like '5.7'. If that happens, consider
suspending the reporting process until the first pre-release of the next
version (5.8-rc1) shows up on kernel.org. That's because the Linux development
cycle then is in its two-week long 'merge window'. The bulk of the changes and
all intrusive ones get merged for the next release during this time. It's a bit
more risky to use mainline during this period. Kernel developers are also often
quite busy then and might have no spare time to deal with issue reports. It's
also quite possible that one of the many changes applied during the merge
window fixes the issue you face; that's why you soon would have to retest with
a newer kernel version anyway, as outlined below in the section 'Duties after
the report went out'.”h]”hX{  In about two out of every nine to ten weeks, mainline might point you to a
proper release with a version number like â€˜5.7â€™. If that happens, consider
suspending the reporting process until the first pre-release of the next
version (5.8-rc1) shows up on kernel.org. Thatâ€™s because the Linux development
cycle then is in its two-week long â€˜merge windowâ€™. The bulk of the changes and
all intrusive ones get merged for the next release during this time. Itâ€™s a bit
more risky to use mainline during this period. Kernel developers are also often
quite busy then and might have no spare time to deal with issue reports. Itâ€™s
also quite possible that one of the many changes applied during the merge
window fixes the issue you face; thatâ€™s why you soon would have to retest with
a newer kernel version anyway, as outlined below in the section â€˜Duties after
the report went outâ€™.”…””}”(hjÁ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M/hj€  hžhubhé)”}”(hXÙ  That's why it might make sense to wait till the merge window is over. But don't
to that if you're dealing with something that shouldn't wait. In that case
consider obtaining the latest mainline kernel via git (see below) or use the
latest stable version offered on kernel.org. Using that is also acceptable in
case mainline for some reason does currently not work for you. An in general:
using it for reproducing the issue is also better than not reporting it issue
at all.”h]”hXá  Thatâ€™s why it might make sense to wait till the merge window is over. But donâ€™t
to that if youâ€™re dealing with something that shouldnâ€™t wait. In that case
consider obtaining the latest mainline kernel via git (see below) or use the
latest stable version offered on kernel.org. Using that is also acceptable in
case mainline for some reason does currently not work for you. An in general:
using it for reproducing the issue is also better than not reporting it issue
at all.”…””}”(hjÏ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M<hj€  hžhubhé)”}”(hXà  Better avoid using the latest stable kernel outside merge windows, as all fixes
must be applied to mainline first. That's why checking the latest mainline
kernel is so important: any issue you want to see fixed in older version lines
needs to be fixed in mainline first before it can get backported, which can
take a few days or weeks. Another reason: the fix you hope for might be too
hard or risky for backporting; reporting the issue again hence is unlikely to
change anything.”h]”hXâ  Better avoid using the latest stable kernel outside merge windows, as all fixes
must be applied to mainline first. Thatâ€™s why checking the latest mainline
kernel is so important: any issue you want to see fixed in older version lines
needs to be fixed in mainline first before it can get backported, which can
take a few days or weeks. Another reason: the fix you hope for might be too
hard or risky for backporting; reporting the issue again hence is unlikely to
change anything.”…””}”(hjÝ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MDhj€  hžhubhé)”}”(hX†  These aspects are also why longterm kernels (sometimes called "LTS kernels")
are unsuitable for this part of the reporting process: they are to distant from
the current code. Hence go and test mainline first and follow the process
further: if the issue doesn't occur with mainline it will guide you how to get
it fixed in older version lines, if that's in the cards for the fix in question.”h]”hXŽ  These aspects are also why longterm kernels (sometimes called â€œLTS kernelsâ€)
are unsuitable for this part of the reporting process: they are to distant from
the current code. Hence go and test mainline first and follow the process
further: if the issue doesnâ€™t occur with mainline it will guide you how to get
it fixed in older version lines, if thatâ€™s in the cards for the fix in question.”…””}”(hjë  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MLhj€  hžhubeh}”(h]”Œ&choosing-the-right-version-for-testing”ah ]”h"]”Œ&choosing the right version for testing”ah$]”h&]”uh1hÂhjÍ  hžhhŸh³h M$ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ"How to obtain a fresh Linux kernel”h]”hŒ"How to obtain a fresh Linux kernel”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj  hžhhŸh³h MSubhé)”}”(hX«  **Using a pre-compiled kernel**: This is often the quickest, easiest, and safest
way for testing â€” especially is you are unfamiliar with the Linux kernel. The
problem: most of those shipped by distributors or add-on repositories are build
from modified Linux sources. They are thus not vanilla and therefore often
unsuitable for testing and issue reporting: the changes might cause the issue
you face or influence it somehow.”h]”(j  )”}”(hŒ**Using a pre-compiled kernel**”h]”hŒUsing a pre-compiled kernel”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubhXŒ  : This is often the quickest, easiest, and safest
way for testing â€” especially is you are unfamiliar with the Linux kernel. The
problem: most of those shipped by distributors or add-on repositories are build
from modified Linux sources. They are thus not vanilla and therefore often
unsuitable for testing and issue reporting: the changes might cause the issue
you face or influence it somehow.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MUhj  hžhubhé)”}”(hX:  But you are in luck if you are using a popular Linux distribution: for quite a
few of them you'll find repositories on the net that contain packages with the
latest mainline or stable Linux built as vanilla kernel. It's totally okay to
use these, just make sure from the repository's description they are vanilla or
at least close to it. Additionally ensure the packages contain the latest
versions as offered on kernel.org. The packages are likely unsuitable if they
are older than a week, as new mainline and stable kernels typically get released
at least once a week.”h]”hX@  But you are in luck if you are using a popular Linux distribution: for quite a
few of them youâ€™ll find repositories on the net that contain packages with the
latest mainline or stable Linux built as vanilla kernel. Itâ€™s totally okay to
use these, just make sure from the repositoryâ€™s description they are vanilla or
at least close to it. Additionally ensure the packages contain the latest
versions as offered on kernel.org. The packages are likely unsuitable if they
are older than a week, as new mainline and stable kernels typically get released
at least once a week.”…””}”(hj.  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M\hj  hžhubhé)”}”(hX÷  Please note that you might need to build your own kernel manually later: that's
sometimes needed for debugging or testing fixes, as described later in this
document. Also be aware that pre-compiled kernels might lack debug symbols that
are needed to decode messages the kernel prints when a panic, Oops, warning, or
BUG occurs; if you plan to decode those, you might be better off compiling a
kernel yourself (see the end of this subsection and the section titled 'Decode
failure messages' for details).”h]”hXý  Please note that you might need to build your own kernel manually later: thatâ€™s
sometimes needed for debugging or testing fixes, as described later in this
document. Also be aware that pre-compiled kernels might lack debug symbols that
are needed to decode messages the kernel prints when a panic, Oops, warning, or
BUG occurs; if you plan to decode those, you might be better off compiling a
kernel yourself (see the end of this subsection and the section titled â€˜Decode
failure messagesâ€™ for details).”…””}”(hj<  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mehj  hžhubhé)”}”(hX  **Using git**: Developers and experienced Linux users familiar with git are
often best served by obtaining the latest Linux kernel sources straight from the
`official development repository on kernel.org
<https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/>`_.
Those are likely a bit ahead of the latest mainline pre-release. Don't worry
about it: they are as reliable as a proper pre-release, unless the kernel's
development cycle is currently in the middle of a merge window. But even then
they are quite reliable.”h]”(j  )”}”(hŒ**Using git**”h]”hŒ	Using git”…””}”(hjN  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjJ  ubhŒ: Developers and experienced Linux users familiar with git are
often best served by obtaining the latest Linux kernel sources straight from the
”…””}”(hjJ  hžhhŸNh Nubhó)”}”(hŒ{`official development repository on kernel.org
<https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/>`_”h]”hŒ-official development repository on kernel.org”…””}”(hj`  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ-official development repository on kernel.org”j  ŒHhttps://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/”uh1hòhjJ  ubj  )”}”(hŒK
<https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/>”h]”h}”(h]”Œ-official-development-repository-on-kernel-org”ah ]”h"]”Œ-official development repository on kernel.org”ah$]”h&]”Œrefuri”jp  uh1j  j  KhjJ  ubhX  .
Those are likely a bit ahead of the latest mainline pre-release. Donâ€™t worry
about it: they are as reliable as a proper pre-release, unless the kernelâ€™s
development cycle is currently in the middle of a merge window. But even then
they are quite reliable.”…””}”(hjJ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mmhj  hžhubhé)”}”(hŒ’**Conventional**: People unfamiliar with git are often best served by
downloading the sources as tarball from `kernel.org <https://kernel.org/>`_.”h]”(j  )”}”(hŒ**Conventional**”h]”hŒConventional”…””}”(hjŒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjˆ  ubhŒ^: People unfamiliar with git are often best served by
downloading the sources as tarball from ”…””}”(hjˆ  hžhhŸNh Nubhó)”}”(hŒ#`kernel.org <https://kernel.org/>`_”h]”hŒ
kernel.org”…””}”(hjž  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ
kernel.org”j  Œhttps://kernel.org/”uh1hòhjˆ  ubj  )”}”(hŒ <https://kernel.org/>”h]”h}”(h]”Œid3”ah ]”h"]”h$]”Œ
kernel.org”ah&]”Œrefuri”j®  uh1j  j  Khjˆ  ubhŒ.”…””}”(hjˆ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mvhj  hžhubhé)”}”(hX›  How to actually build a kernel is not described here, as many websites explain
the necessary steps already. If you are new to it, consider following one of
those how-to's that suggest to use ``make localmodconfig``, as that tries to
pick up the configuration of your current kernel and then tries to adjust it
somewhat for your system. That does not make the resulting kernel any better,
but quicker to compile.”h]”(hŒÁHow to actually build a kernel is not described here, as many websites explain
the necessary steps already. If you are new to it, consider following one of
those how-toâ€™s that suggest to use ”…””}”(hjÆ  hžhhŸNh Nubj  )”}”(hŒ``make localmodconfig``”h]”hŒmake localmodconfig”…””}”(hjÎ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjÆ  ubhŒÅ, as that tries to
pick up the configuration of your current kernel and then tries to adjust it
somewhat for your system. That does not make the resulting kernel any better,
but quicker to compile.”…””}”(hjÆ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Myhj  hžhubhé)”}”(hXX  Note: If you are dealing with a panic, Oops, warning, or BUG from the kernel,
please try to enable CONFIG_KALLSYMS when configuring your kernel.
Additionally, enable CONFIG_DEBUG_KERNEL and CONFIG_DEBUG_INFO, too; the
latter is the relevant one of those two, but can only be reached if you enable
the former. Be aware CONFIG_DEBUG_INFO increases the storage space required to
build a kernel by quite a bit. But that's worth it, as these options will allow
you later to pinpoint the exact line of code that triggers your issue. The
section 'Decode failure messages' below explains this in more detail.”h]”hX^  Note: If you are dealing with a panic, Oops, warning, or BUG from the kernel,
please try to enable CONFIG_KALLSYMS when configuring your kernel.
Additionally, enable CONFIG_DEBUG_KERNEL and CONFIG_DEBUG_INFO, too; the
latter is the relevant one of those two, but can only be reached if you enable
the former. Be aware CONFIG_DEBUG_INFO increases the storage space required to
build a kernel by quite a bit. But thatâ€™s worth it, as these options will allow
you later to pinpoint the exact line of code that triggers your issue. The
section â€˜Decode failure messagesâ€™ below explains this in more detail.”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M€hj  hžhubhé)”}”(hŒ«But keep in mind: Always keep a record of the issue encountered in case it is
hard to reproduce. Sending an undecoded report is better than not reporting
the issue at all.”h]”hŒ«But keep in mind: Always keep a record of the issue encountered in case it is
hard to reproduce. Sending an undecoded report is better than not reporting
the issue at all.”…””}”(hjô  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M‰hj  hžhubeh}”(h]”Œ"how-to-obtain-a-fresh-linux-kernel”ah ]”h"]”Œ"how to obtain a fresh linux kernel”ah$]”h&]”uh1hÂhjÍ  hžhhŸh³h MSubeh}”(h]”Œ"install-a-fresh-kernel-for-testing”ah ]”h"]”Œ"install a fresh kernel for testing”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MubhÃ)”}”(hhh]”(hÈ)”}”(hŒCheck 'taint' flag”h]”hŒCheck â€˜taintâ€™ flag”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj  hžhhŸh³h Mubj™  )”}”(hŒM*Ensure the kernel you just installed does not 'taint' itself when
running.*
”h]”hé)”}”(hŒL*Ensure the kernel you just installed does not 'taint' itself when
running.*”h]”j¾  )”}”(hj)  h]”hŒNEnsure the kernel you just installed does not â€˜taintâ€™ itself when
running.”…””}”(hj+  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj'  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M‘hj#  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M‘hj  hžhubhé)”}”(hX§  As outlined above in more detail already: the kernel sets a 'taint' flag when
something happens that can lead to follow-up errors that look totally
unrelated. That's why you need to check if the kernel you just installed does
not set this flag. And if it does, you in almost all the cases needs to
eliminate the reason for it before you reporting issues that occur with it. See
the section above for details how to do that.”h]”hX­  As outlined above in more detail already: the kernel sets a â€˜taintâ€™ flag when
something happens that can lead to follow-up errors that look totally
unrelated. Thatâ€™s why you need to check if the kernel you just installed does
not set this flag. And if it does, you in almost all the cases needs to
eliminate the reason for it before you reporting issues that occur with it. See
the section above for details how to do that.”…””}”(hjD  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M”hj  hžhubeh}”(h]”Œid4”ah ]”h"]”h$]”j×  ah&]”uh1hÂhj¨  hžhhŸh³h Mj  KubhÃ)”}”(hhh]”(hÈ)”}”(hŒ%Reproduce issue with the fresh kernel”h]”hŒ%Reproduce issue with the fresh kernel”…””}”(hj\  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjY  hžhhŸh³h Mubj™  )”}”(hŒ³*Reproduce the issue with the kernel you just installed. If it doesn't show
up there, scroll down to the instructions for issues only happening with
stable and longterm kernels.*
”h]”hé)”}”(hŒ²*Reproduce the issue with the kernel you just installed. If it doesn't show
up there, scroll down to the instructions for issues only happening with
stable and longterm kernels.*”h]”j¾  )”}”(hjp  h]”hŒ²Reproduce the issue with the kernel you just installed. If it doesnâ€™t show
up there, scroll down to the instructions for issues only happening with
stable and longterm kernels.”…””}”(hjr  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjn  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MŸhjj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MŸhjY  hžhubhé)”}”(hX7  Check if the issue occurs with the fresh Linux kernel version you just
installed. If it was fixed there already, consider sticking with this version
line and abandoning your plan to report the issue. But keep in mind that other
users might still be plagued by it, as long as it's not fixed in either stable
and longterm version from kernel.org (and thus vendor kernels derived from
those). If you prefer to use one of those or just want to help their users,
head over to the section "Details about reporting issues only occurring in
older kernel version lines" below.”h]”hX=  Check if the issue occurs with the fresh Linux kernel version you just
installed. If it was fixed there already, consider sticking with this version
line and abandoning your plan to report the issue. But keep in mind that other
users might still be plagued by it, as long as itâ€™s not fixed in either stable
and longterm version from kernel.org (and thus vendor kernels derived from
those). If you prefer to use one of those or just want to help their users,
head over to the section â€œDetails about reporting issues only occurring in
older kernel version linesâ€ below.”…””}”(hj‹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M£hjY  hžhubeh}”(h]”Œ%reproduce-issue-with-the-fresh-kernel”ah ]”h"]”Œ%reproduce issue with the fresh kernel”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MubhÃ)”}”(hhh]”(hÈ)”}”(hŒ'Optimize description to reproduce issue”h]”hŒ'Optimize description to reproduce issue”…””}”(hj¤  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj¡  hžhhŸh³h M®ubj™  )”}”(hXn  *Optimize your notes: try to find and write the most straightforward way to
reproduce your issue. Make sure the end result has all the important
details, and at the same time is easy to read and understand for others
that hear about it for the first time. And if you learned something in this
process, consider searching again for existing reports about the issue.*
”h]”hé)”}”(hXm  *Optimize your notes: try to find and write the most straightforward way to
reproduce your issue. Make sure the end result has all the important
details, and at the same time is easy to read and understand for others
that hear about it for the first time. And if you learned something in this
process, consider searching again for existing reports about the issue.*”h]”j¾  )”}”(hj¸  h]”hXk  Optimize your notes: try to find and write the most straightforward way to
reproduce your issue. Make sure the end result has all the important
details, and at the same time is easy to read and understand for others
that hear about it for the first time. And if you learned something in this
process, consider searching again for existing reports about the issue.”…””}”(hjº  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj¶  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M°hj²  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M°hj¡  hžhubhé)”}”(hX  An unnecessarily complex report will make it hard for others to understand your
report. Thus try to find a reproducer that's straight forward to describe and
thus easy to understand in written form. Include all important details, but at
the same time try to keep it as short as possible.”h]”hX!  An unnecessarily complex report will make it hard for others to understand your
report. Thus try to find a reproducer thatâ€™s straight forward to describe and
thus easy to understand in written form. Include all important details, but at
the same time try to keep it as short as possible.”…””}”(hjÓ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M¶hj¡  hžhubhé)”}”(hŒ­In this in the previous steps you likely have learned a thing or two about the
issue you face. Use this knowledge and search again for existing reports
instead you can join.”h]”hŒ­In this in the previous steps you likely have learned a thing or two about the
issue you face. Use this knowledge and search again for existing reports
instead you can join.”…””}”(hjá  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M»hj¡  hžhubeh}”(h]”Œ'optimize-description-to-reproduce-issue”ah ]”h"]”Œ'optimize description to reproduce issue”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h M®ubhÃ)”}”(hhh]”(hÈ)”}”(hŒDecode failure messages”h]”hŒDecode failure messages”…””}”(hjú  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj÷  hžhhŸh³h MÁubj™  )”}”(hŒ—*If your failure involves a 'panic', 'Oops', 'warning', or 'BUG', consider
decoding the kernel log to find the line of code that triggered the error.*
”h]”hé)”}”(hŒ–*If your failure involves a 'panic', 'Oops', 'warning', or 'BUG', consider
decoding the kernel log to find the line of code that triggered the error.*”h]”j¾  )”}”(hj  h]”hŒ¤If your failure involves a â€˜panicâ€™, â€˜Oopsâ€™, â€˜warningâ€™, or â€˜BUGâ€™, consider
decoding the kernel log to find the line of code that triggered the error.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÃhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MÃhj÷  hžhubhé)”}”(hX-  When the kernel detects an internal problem, it will log some information about
the executed code. This makes it possible to pinpoint the exact line in the
source code that triggered the issue and shows how it was called. But that only
works if you enabled CONFIG_DEBUG_INFO and CONFIG_KALLSYMS when configuring
your kernel. If you did so, consider to decode the information from the
kernel's log. That will make it a lot easier to understand what lead to the
'panic', 'Oops', 'warning', or 'BUG', which increases the chances that someone
can provide a fix.”h]”hX?  When the kernel detects an internal problem, it will log some information about
the executed code. This makes it possible to pinpoint the exact line in the
source code that triggered the issue and shows how it was called. But that only
works if you enabled CONFIG_DEBUG_INFO and CONFIG_KALLSYMS when configuring
your kernel. If you did so, consider to decode the information from the
kernelâ€™s log. That will make it a lot easier to understand what lead to the
â€˜panicâ€™, â€˜Oopsâ€™, â€˜warningâ€™, or â€˜BUGâ€™, which increases the chances that someone
can provide a fix.”…””}”(hj)  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÆhj÷  hžhubhé)”}”(hŒ”Decoding can be done with a script you find in the Linux source tree. If you
are running a kernel you compiled yourself earlier, call it like this::”h]”hŒ“Decoding can be done with a script you find in the Linux source tree. If you
are running a kernel you compiled yourself earlier, call it like this:”…””}”(hj7  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÏhj÷  hžhubj[  )”}”(hŒc[user@something ~]$ sudo dmesg | ./linux-5.10.5/scripts/decode_stacktrace.sh ./linux-5.10.5/vmlinux”h]”hŒc[user@something ~]$ sudo dmesg | ./linux-5.10.5/scripts/decode_stacktrace.sh ./linux-5.10.5/vmlinux”…””}”hjE  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h MÒhj÷  hžhubhé)”}”(hŒõIf you are running a packaged vanilla kernel, you will likely have to install
the corresponding packages with debug symbols. Then call the script (which you
might need to get from the Linux sources if your distro does not package it)
like this::”h]”hŒôIf you are running a packaged vanilla kernel, you will likely have to install
the corresponding packages with debug symbols. Then call the script (which you
might need to get from the Linux sources if your distro does not package it)
like this:”…””}”(hjS  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÔhj÷  hžhubj[  )”}”(hŒª[user@something ~]$ sudo dmesg | ./linux-5.10.5/scripts/decode_stacktrace.sh \
 /usr/lib/debug/lib/modules/5.10.10-4.1.x86_64/vmlinux /usr/src/kernels/5.10.10-4.1.x86_64/”h]”hŒª[user@something ~]$ sudo dmesg | ./linux-5.10.5/scripts/decode_stacktrace.sh \
 /usr/lib/debug/lib/modules/5.10.10-4.1.x86_64/vmlinux /usr/src/kernels/5.10.10-4.1.x86_64/”…””}”hja  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h MÙhj÷  hžhubhé)”}”(hŒ‹The script will work on log lines like the following, which show the address of
the code the kernel was executing when the error occurred::”h]”hŒŠThe script will work on log lines like the following, which show the address of
the code the kernel was executing when the error occurred:”…””}”(hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÜhj÷  hžhubj[  )”}”(hŒA[   68.387301] RIP: 0010:test_module_init+0x5/0xffa [test_module]”h]”hŒA[   68.387301] RIP: 0010:test_module_init+0x5/0xffa [test_module]”…””}”hj}  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h Mßhj÷  hžhubhé)”}”(hŒ/Once decoded, these lines will look like this::”h]”hŒ.Once decoded, these lines will look like this:”…””}”(hj‹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Máhj÷  hžhubj[  )”}”(hŒp[   68.387301] RIP: 0010:test_module_init (/home/username/linux-5.10.5/test-module/test-module.c:16) test_module”h]”hŒp[   68.387301] RIP: 0010:test_module_init (/home/username/linux-5.10.5/test-module/test-module.c:16) test_module”…””}”hj™  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jZ  hŸh³h Mãhj÷  hžhubhé)”}”(hŒ In this case the executed code was built from the file
'~/linux-5.10.5/test-module/test-module.c' and the error occurred by the
instructions found in line '16'.”h]”hŒ¨In this case the executed code was built from the file
â€˜~/linux-5.10.5/test-module/test-module.câ€™ and the error occurred by the
instructions found in line â€˜16â€™.”…””}”(hj§  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Måhj÷  hžhubhé)”}”(hX
  The script will similarly decode the addresses mentioned in the section
starting with 'Call trace', which show the path to the function where the
problem occurred. Additionally, the script will show the assembler output for
the code section the kernel was executing.”h]”hX  The script will similarly decode the addresses mentioned in the section
starting with â€˜Call traceâ€™, which show the path to the function where the
problem occurred. Additionally, the script will show the assembler output for
the code section the kernel was executing.”…””}”(hjµ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Méhj÷  hžhubhé)”}”(hXÁ  Note, if you can't get this to work, simply skip this step and mention the
reason for it in the report. If you're lucky, it might not be needed. And if it
is, someone might help you to get things going. Also be aware this is just one
of several ways to decode kernel stack traces. Sometimes different steps will
be required to retrieve the relevant details. Don't worry about that, if that's
needed in your case, developers will tell you what to do.”h]”hXÉ  Note, if you canâ€™t get this to work, simply skip this step and mention the
reason for it in the report. If youâ€™re lucky, it might not be needed. And if it
is, someone might help you to get things going. Also be aware this is just one
of several ways to decode kernel stack traces. Sometimes different steps will
be required to retrieve the relevant details. Donâ€™t worry about that, if thatâ€™s
needed in your case, developers will tell you what to do.”…””}”(hjÃ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mîhj÷  hžhubeh}”(h]”Œdecode-failure-messages”ah ]”h"]”Œdecode failure messages”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MÁubhÃ)”}”(hhh]”(hÈ)”}”(hŒSpecial care for regressions”h]”hŒSpecial care for regressions”…””}”(hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÙ  hžhhŸh³h M÷ubj™  )”}”(hŒi*If your problem is a regression, try to narrow down when the issue was
introduced as much as possible.*
”h]”hé)”}”(hŒh*If your problem is a regression, try to narrow down when the issue was
introduced as much as possible.*”h]”j¾  )”}”(hjð  h]”hŒfIf your problem is a regression, try to narrow down when the issue was
introduced as much as possible.”…””}”(hjò  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjî  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mùhjê  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MùhjÙ  hžhubhé)”}”(hX}  Linux lead developer Linus Torvalds insists that the Linux kernel never
worsens, that's why he deems regressions as unacceptable and wants to see them
fixed quickly. That's why changes that introduced a regression are often
promptly reverted if the issue they cause can't get solved quickly any other
way. Reporting a regression is thus a bit like playing a kind of trump card to
get something quickly fixed. But for that to happen the change that's causing
the regression needs to be known. Normally it's up to the reporter to track
down the culprit, as maintainers often won't have the time or setup at hand to
reproduce it themselves.”h]”hX‰  Linux lead developer Linus Torvalds insists that the Linux kernel never
worsens, thatâ€™s why he deems regressions as unacceptable and wants to see them
fixed quickly. Thatâ€™s why changes that introduced a regression are often
promptly reverted if the issue they cause canâ€™t get solved quickly any other
way. Reporting a regression is thus a bit like playing a kind of trump card to
get something quickly fixed. But for that to happen the change thatâ€™s causing
the regression needs to be known. Normally itâ€™s up to the reporter to track
down the culprit, as maintainers often wonâ€™t have the time or setup at hand to
reproduce it themselves.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MühjÙ  hžhubhé)”}”(hXÝ  To find the change there is a process called 'bisection' which the document
Documentation/admin-guide/bug-bisect.rst describes in detail. That process
will often require you to build about ten to twenty kernel images, trying to
reproduce the issue with each of them before building the next. Yes, that takes
some time, but don't worry, it works a lot quicker than most people assume.
Thanks to a 'binary search' this will lead you to the one commit in the source
code management system that's causing the regression. Once you find it, search
the net for the subject of the change, its commit id and the shortened commit id
(the first 12 characters of the commit id). This will lead you to existing
reports about it, if there are any.”h]”hXé  To find the change there is a process called â€˜bisectionâ€™ which the document
Documentation/admin-guide/bug-bisect.rst describes in detail. That process
will often require you to build about ten to twenty kernel images, trying to
reproduce the issue with each of them before building the next. Yes, that takes
some time, but donâ€™t worry, it works a lot quicker than most people assume.
Thanks to a â€˜binary searchâ€™ this will lead you to the one commit in the source
code management system thatâ€™s causing the regression. Once you find it, search
the net for the subject of the change, its commit id and the shortened commit id
(the first 12 characters of the commit id). This will lead you to existing
reports about it, if there are any.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MhjÙ  hžhubhé)”}”(hXa  Note, a bisection needs a bit of know-how, which not everyone has, and quite a
bit of effort, which not everyone is willing to invest. Nevertheless, it's
highly recommended performing a bisection yourself. If you really can't or
don't want to go down that route at least find out which mainline kernel
introduced the regression. If something for example breaks when switching from
5.5.15 to 5.8.4, then try at least all the mainline releases in that area (5.6,
5.7 and 5.8) to check when it first showed up. Unless you're trying to find a
regression in a stable or longterm kernel, avoid testing versions which number
has three sections (5.6.12, 5.7.8), as that makes the outcome hard to
interpret, which might render your testing useless. Once you found the major
version which introduced the regression, feel free to move on in the reporting
process. But keep in mind: it depends on the issue at hand if the developers
will be able to help without knowing the culprit. Sometimes they might
recognize from the report want went wrong and can fix it; other times they will
be unable to help unless you perform a bisection.”h]”hXi  Note, a bisection needs a bit of know-how, which not everyone has, and quite a
bit of effort, which not everyone is willing to invest. Nevertheless, itâ€™s
highly recommended performing a bisection yourself. If you really canâ€™t or
donâ€™t want to go down that route at least find out which mainline kernel
introduced the regression. If something for example breaks when switching from
5.5.15 to 5.8.4, then try at least all the mainline releases in that area (5.6,
5.7 and 5.8) to check when it first showed up. Unless youâ€™re trying to find a
regression in a stable or longterm kernel, avoid testing versions which number
has three sections (5.6.12, 5.7.8), as that makes the outcome hard to
interpret, which might render your testing useless. Once you found the major
version which introduced the regression, feel free to move on in the reporting
process. But keep in mind: it depends on the issue at hand if the developers
will be able to help without knowing the culprit. Sometimes they might
recognize from the report want went wrong and can fix it; other times they will
be unable to help unless you perform a bisection.”…””}”(hj'  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MhjÙ  hžhubhé)”}”(hŒWhen dealing with regressions make sure the issue you face is really caused by
the kernel and not by something else, as outlined above already.”h]”hŒWhen dealing with regressions make sure the issue you face is really caused by
the kernel and not by something else, as outlined above already.”…””}”(hj5  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M!hjÙ  hžhubhé)”}”(hX‰  In the whole process keep in mind: an issue only qualifies as regression if the
older and the newer kernel got built with a similar configuration. This can be
achieved by using ``make olddefconfig``, as explained in more detail by
Documentation/admin-guide/reporting-regressions.rst; that document also
provides a good deal of other information about regressions you might want to be
aware of.”h]”(hŒ±In the whole process keep in mind: an issue only qualifies as regression if the
older and the newer kernel got built with a similar configuration. This can be
achieved by using ”…””}”(hjC  hžhhŸNh Nubj  )”}”(hŒ``make olddefconfig``”h]”hŒmake olddefconfig”…””}”(hjK  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjC  ubhŒÃ, as explained in more detail by
Documentation/admin-guide/reporting-regressions.rst; that document also
provides a good deal of other information about regressions you might want to be
aware of.”…””}”(hjC  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M$hjÙ  hžhubeh}”(h]”Œspecial-care-for-regressions”ah ]”h"]”Œspecial care for regressions”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h M÷ubhÃ)”}”(hhh]”(hÈ)”}”(hŒWrite and send the report”h]”hŒWrite and send the report”…””}”(hjn  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjk  hžhhŸh³h M-ubj™  )”}”(hX  *Start to compile the report by writing a detailed description about the
issue. Always mention a few things: the latest kernel version you installed
for reproducing, the Linux Distribution used, and your notes on how to
reproduce the issue. Ideally, make the kernel's build configuration
(.config) and the output from ``dmesg`` available somewhere on the net and
link to it. Include or upload all other information that might be relevant,
like the output/screenshot of an Oops or the output from ``lspci``. Once
you wrote this main part, insert a normal length paragraph on top of it
outlining the issue and the impact quickly. On top of this add one sentence
that briefly describes the problem and gets people to read on. Now give the
thing a descriptive title or subject that yet again is shorter. Then you're
ready to send or file the report like the MAINTAINERS file told you, unless
you are dealing with one of those 'issues of high priority': they need
special care which is explained in 'Special handling for high priority
issues' below.*
”h]”hé)”}”(hX  *Start to compile the report by writing a detailed description about the
issue. Always mention a few things: the latest kernel version you installed
for reproducing, the Linux Distribution used, and your notes on how to
reproduce the issue. Ideally, make the kernel's build configuration
(.config) and the output from ``dmesg`` available somewhere on the net and
link to it. Include or upload all other information that might be relevant,
like the output/screenshot of an Oops or the output from ``lspci``. Once
you wrote this main part, insert a normal length paragraph on top of it
outlining the issue and the impact quickly. On top of this add one sentence
that briefly describes the problem and gets people to read on. Now give the
thing a descriptive title or subject that yet again is shorter. Then you're
ready to send or file the report like the MAINTAINERS file told you, unless
you are dealing with one of those 'issues of high priority': they need
special care which is explained in 'Special handling for high priority
issues' below.*”h]”j¾  )”}”(hj‚  h]”hX  Start to compile the report by writing a detailed description about the
issue. Always mention a few things: the latest kernel version you installed
for reproducing, the Linux Distribution used, and your notes on how to
reproduce the issue. Ideally, make the kernelâ€™s build configuration
(.config) and the output from ``dmesg`` available somewhere on the net and
link to it. Include or upload all other information that might be relevant,
like the output/screenshot of an Oops or the output from ``lspci``. Once
you wrote this main part, insert a normal length paragraph on top of it
outlining the issue and the impact quickly. On top of this add one sentence
that briefly describes the problem and gets people to read on. Now give the
thing a descriptive title or subject that yet again is shorter. Then youâ€™re
ready to send or file the report like the MAINTAINERS file told you, unless
you are dealing with one of those â€˜issues of high priorityâ€™: they need
special care which is explained in â€˜Special handling for high priority
issuesâ€™ below.”…””}”(hj„  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj€  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M/hj|  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M/hjk  hžhubhé)”}”(hX  Now that you have prepared everything it's time to write your report. How to do
that is partly explained by the three documents linked to in the preface above.
That's why this text will only mention a few of the essentials as well as
things specific to the Linux kernel.”h]”hX  Now that you have prepared everything itâ€™s time to write your report. How to do
that is partly explained by the three documents linked to in the preface above.
Thatâ€™s why this text will only mention a few of the essentials as well as
things specific to the Linux kernel.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M?hjk  hžhubhé)”}”(hXô  There is one thing that fits both categories: the most crucial parts of your
report are the title/subject, the first sentence, and the first paragraph.
Developers often get quite a lot of mail. They thus often just take a few
seconds to skim a mail before deciding to move on or look closer. Thus: the
better the top section of your report, the higher are the chances that someone
will look into it and help you. And that is why you should ignore them for now
and write the detailed report first. ;-)”h]”hXô  There is one thing that fits both categories: the most crucial parts of your
report are the title/subject, the first sentence, and the first paragraph.
Developers often get quite a lot of mail. They thus often just take a few
seconds to skim a mail before deciding to move on or look closer. Thus: the
better the top section of your report, the higher are the chances that someone
will look into it and help you. And that is why you should ignore them for now
and write the detailed report first. ;-)”…””}”(hj«  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MDhjk  hžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒ!Things each report should mention”h]”hŒ!Things each report should mention”…””}”(hj¼  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj¹  hžhhŸh³h MMubhé)”}”(hX<  Describe in detail how your issue happens with the fresh vanilla kernel you
installed. Try to include the step-by-step instructions you wrote and optimized
earlier that outline how you and ideally others can reproduce the issue; in
those rare cases where that's impossible try to describe what you did to
trigger it.”h]”hX>  Describe in detail how your issue happens with the fresh vanilla kernel you
installed. Try to include the step-by-step instructions you wrote and optimized
earlier that outline how you and ideally others can reproduce the issue; in
those rare cases where thatâ€™s impossible try to describe what you did to
trigger it.”…””}”(hjÊ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MOhj¹  hžhubhé)”}”(hŒÐAlso include all the relevant information others might need to understand the
issue and its environment. What's actually needed depends a lot on the issue,
but there are some things you should include always:”h]”hŒÒAlso include all the relevant information others might need to understand the
issue and its environment. Whatâ€™s actually needed depends a lot on the issue,
but there are some things you should include always:”…””}”(hjØ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MUhj¹  hžhubj™  )”}”(hX²  * the output from ``cat /proc/version``, which contains the Linux kernel
  version number and the compiler it was built with.

* the Linux distribution the machine is running (``hostnamectl | grep
  "Operating System"``)

* the architecture of the CPU and the operating system (``uname -mi``)

* if you are dealing with a regression and performed a bisection, mention the
  subject and the commit-id of the change that is causing it.
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hŒzthe output from ``cat /proc/version``, which contains the Linux kernel
version number and the compiler it was built with.
”h]”hé)”}”(hŒythe output from ``cat /proc/version``, which contains the Linux kernel
version number and the compiler it was built with.”h]”(hŒthe output from ”…””}”(hjñ  hžhhŸNh Nubj  )”}”(hŒ``cat /proc/version``”h]”hŒcat /proc/version”…””}”(hjù  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjñ  ubhŒT, which contains the Linux kernel
version number and the compiler it was built with.”…””}”(hjñ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MYhjí  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjê  ubj¤  )”}”(hŒZthe Linux distribution the machine is running (``hostnamectl | grep
"Operating System"``)
”h]”hé)”}”(hŒYthe Linux distribution the machine is running (``hostnamectl | grep
"Operating System"``)”h]”(hŒ/the Linux distribution the machine is running (”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ)``hostnamectl | grep
"Operating System"``”h]”hŒ%hostnamectl | grep
"Operating System"”…””}”(hj#  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒ)”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M\hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjê  ubj¤  )”}”(hŒEthe architecture of the CPU and the operating system (``uname -mi``)
”h]”hé)”}”(hŒDthe architecture of the CPU and the operating system (``uname -mi``)”h]”(hŒ6the architecture of the CPU and the operating system (”…””}”(hjE  hžhhŸNh Nubj  )”}”(hŒ``uname -mi``”h]”hŒ	uname -mi”…””}”(hjM  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjE  ubhŒ)”…””}”(hjE  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M_hjA  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjê  ubj¤  )”}”(hŒˆif you are dealing with a regression and performed a bisection, mention the
subject and the commit-id of the change that is causing it.
”h]”hé)”}”(hŒ‡if you are dealing with a regression and performed a bisection, mention the
subject and the commit-id of the change that is causing it.”h]”hŒ‡if you are dealing with a regression and performed a bisection, mention the
subject and the commit-id of the change that is causing it.”…””}”(hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mahjk  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjê  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h MYhjæ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MYhj¹  hžhubhé)”}”(hŒbIn a lot of cases it's also wise to make two more things available to those
that read your report:”h]”hŒdIn a lot of cases itâ€™s also wise to make two more things available to those
that read your report:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mdhj¹  hžhubj™  )”}”(hX3  * the configuration used for building your Linux kernel (the '.config' file)

* the kernel's messages that you get from ``dmesg`` written to a file. Make
  sure that it starts with a line like 'Linux version 5.8-1
  (foobar@example.com) (gcc (GCC) 10.2.1, GNU ld version 2.34) #1 SMP Mon Aug
  3 14:54:37 UTC 2020' If it's missing, then important messages from the first
  boot phase already got discarded. In this case instead consider using
  ``journalctl -b 0 -k``; alternatively you can also reboot, reproduce the
  issue and call ``dmesg`` right afterwards.
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hŒKthe configuration used for building your Linux kernel (the '.config' file)
”h]”hé)”}”(hŒJthe configuration used for building your Linux kernel (the '.config' file)”•×      h]”hŒNthe configuration used for building your Linux kernel (the â€˜.configâ€™ file)”…””}”(hj¨  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mghj¤  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj¡  ubj¤  )”}”(hX×  the kernel's messages that you get from ``dmesg`` written to a file. Make
sure that it starts with a line like 'Linux version 5.8-1
(foobar@example.com) (gcc (GCC) 10.2.1, GNU ld version 2.34) #1 SMP Mon Aug
3 14:54:37 UTC 2020' If it's missing, then important messages from the first
boot phase already got discarded. In this case instead consider using
``journalctl -b 0 -k``; alternatively you can also reboot, reproduce the
issue and call ``dmesg`` right afterwards.
”h]”hé)”}”(hXÖ  the kernel's messages that you get from ``dmesg`` written to a file. Make
sure that it starts with a line like 'Linux version 5.8-1
(foobar@example.com) (gcc (GCC) 10.2.1, GNU ld version 2.34) #1 SMP Mon Aug
3 14:54:37 UTC 2020' If it's missing, then important messages from the first
boot phase already got discarded. In this case instead consider using
``journalctl -b 0 -k``; alternatively you can also reboot, reproduce the
issue and call ``dmesg`` right afterwards.”h]”(hŒ*the kernelâ€™s messages that you get from ”…””}”(hjÀ  hžhhŸNh Nubj  )”}”(hŒ	``dmesg``”h]”hŒdmesg”…””}”(hjÈ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjÀ  ubhŒV written to a file. Make
sure that it starts with a line like â€˜Linux version 5.8-1
(”…””}”(hjÀ  hžhhŸNh Nubhó)”}”(hŒfoobar@example.com”h]”hŒfoobar@example.com”…””}”(hjÚ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:foobar@example.com”uh1hòhjÀ  ubhŒÐ) (gcc (GCC) 10.2.1, GNU ld version 2.34) #1 SMP Mon Aug
3 14:54:37 UTC 2020â€™ If itâ€™s missing, then important messages from the first
boot phase already got discarded. In this case instead consider using
”…””}”(hjÀ  hžhhŸNh Nubj  )”}”(hŒ``journalctl -b 0 -k``”h]”hŒjournalctl -b 0 -k”…””}”(hjî  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjÀ  ubhŒB; alternatively you can also reboot, reproduce the
issue and call ”…””}”(hjÀ  hžhhŸNh Nubj  )”}”(hŒ	``dmesg``”h]”hŒdmesg”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hjÀ  ubhŒ right afterwards.”…””}”(hjÀ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mihj¼  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj¡  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h Mghj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Mghj¹  hžhubhé)”}”(hX  These two files are big, that's why it's a bad idea to put them directly into
your report. If you are filing the issue in a bug tracker then attach them to
the ticket. If you report the issue by mail do not attach them, as that makes
the mail too large; instead do one of these things:”h]”hX!  These two files are big, thatâ€™s why itâ€™s a bad idea to put them directly into
your report. If you are filing the issue in a bug tracker then attach them to
the ticket. If you report the issue by mail do not attach them, as that makes
the mail too large; instead do one of these things:”…””}”(hj*  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mqhj¹  hžhubj™  )”}”(hX  * Upload the files somewhere public (your website, a public file paste
  service, a ticket created just for this purpose on `bugzilla.kernel.org
  <https://bugzilla.kernel.org/>`_, ...) and include a link to them in your
  report. Ideally use something where the files stay available for years, as
  they could be useful to someone many years from now; this for example can
  happen if five or ten years from now a developer works on some code that was
  changed just to fix your issue.

* Put the files aside and mention you will send them later in individual
  replies to your own mail. Just remember to actually do that once the report
  went out. ;-)
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hXÙ  Upload the files somewhere public (your website, a public file paste
service, a ticket created just for this purpose on `bugzilla.kernel.org
<https://bugzilla.kernel.org/>`_, ...) and include a link to them in your
report. Ideally use something where the files stay available for years, as
they could be useful to someone many years from now; this for example can
happen if five or ten years from now a developer works on some code that was
changed just to fix your issue.
”h]”hé)”}”(hXØ  Upload the files somewhere public (your website, a public file paste
service, a ticket created just for this purpose on `bugzilla.kernel.org
<https://bugzilla.kernel.org/>`_, ...) and include a link to them in your
report. Ideally use something where the files stay available for years, as
they could be useful to someone many years from now; this for example can
happen if five or ten years from now a developer works on some code that was
changed just to fix your issue.”h]”(hŒxUpload the files somewhere public (your website, a public file paste
service, a ticket created just for this purpose on ”…””}”(hjC  hžhhŸNh Nubhó)”}”(hŒ5`bugzilla.kernel.org
<https://bugzilla.kernel.org/>`_”h]”hŒbugzilla.kernel.org”…””}”(hjK  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œbugzilla.kernel.org”j  Œhttps://bugzilla.kernel.org/”uh1hòhjC  ubj  )”}”(hŒ
<https://bugzilla.kernel.org/>”h]”h}”(h]”Œid5”ah ]”h"]”h$]”Œbugzilla.kernel.org”ah&]”Œrefuri”j[  uh1j  j  KhjC  ubhX+  , ...) and include a link to them in your
report. Ideally use something where the files stay available for years, as
they could be useful to someone many years from now; this for example can
happen if five or ten years from now a developer works on some code that was
changed just to fix your issue.”…””}”(hjC  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mvhj?  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj<  ubj¤  )”}”(hŒ¡Put the files aside and mention you will send them later in individual
replies to your own mail. Just remember to actually do that once the report
went out. ;-)
”h]”hé)”}”(hŒ Put the files aside and mention you will send them later in individual
replies to your own mail. Just remember to actually do that once the report
went out. ;-)”h]”hŒ Put the files aside and mention you will send them later in individual
replies to your own mail. Just remember to actually do that once the report
went out. ;-)”…””}”(hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M~hjy  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj<  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h Mvhj8  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Mvhj¹  hžhubeh}”(h]”Œ!things-each-report-should-mention”ah ]”h"]”Œ!things each report should mention”ah$]”h&]”uh1hÂhjk  hžhhŸh³h MMubhÃ)”}”(hhh]”(hÈ)”}”(hŒ$Things that might be wise to provide”h]”hŒ$Things that might be wise to provide”…””}”(hj¨  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj¥  hžhhŸh³h Mƒubhé)”}”(hŒ|Depending on the issue you might need to add more background data. Here are a
few suggestions what often is good to provide:”h]”hŒ|Depending on the issue you might need to add more background data. Here are a
few suggestions what often is good to provide:”…””}”(hj¶  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M…hj¥  hžhubj™  )”}”(hX«  * If you are dealing with a 'warning', an 'OOPS' or a 'panic' from the kernel,
  include it. If you can't copy'n'paste it, try to capture a netconsole trace
  or at least take a picture of the screen.

* If the issue might be related to your computer hardware, mention what kind
  of system you use. If you for example have problems with your graphics card,
  mention its manufacturer, the card's model, and what chip is uses. If it's a
  laptop mention its name, but try to make sure it's meaningful. 'Dell XPS 13'
  for example is not, because it might be the one from 2012; that one looks
  not that different from the one sold today, but apart from that the two have
  nothing in common. Hence, in such cases add the exact model number, which
  for example are '9380' or '7390' for XPS 13 models introduced during 2019.
  Names like 'Lenovo Thinkpad T590' are also somewhat ambiguous: there are
  variants of this laptop with and without a dedicated graphics chip, so try
  to find the exact model name or specify the main components.

* Mention the relevant software in use. If you have problems with loading
  modules, you want to mention the versions of kmod, systemd, and udev in use.
  If one of the DRM drivers misbehaves, you want to state the versions of
  libdrm and Mesa; also specify your Wayland compositor or the X-Server and
  its driver. If you have a filesystem issue, mention the version of
  corresponding filesystem utilities (e2fsprogs, btrfs-progs, xfsprogs, ...).

* Gather additional information from the kernel that might be of interest. The
  output from ``lspci -nn`` will for example help others to identify what
  hardware you use. If you have a problem with hardware you even might want to
  make the output from ``sudo lspci -vvv`` available, as that provides
  insights how the components were configured. For some issues it might be
  good to include the contents of files like ``/proc/cpuinfo``,
  ``/proc/ioports``, ``/proc/iomem``, ``/proc/modules``, or
  ``/proc/scsi/scsi``. Some subsystem also offer tools to collect relevant
  information. One such tool is ``alsa-info.sh`` `which the audio/sound
  subsystem developers provide <https://www.alsa-project.org/wiki/AlsaInfo>`_.
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hŒÃIf you are dealing with a 'warning', an 'OOPS' or a 'panic' from the kernel,
include it. If you can't copy'n'paste it, try to capture a netconsole trace
or at least take a picture of the screen.
”h]”hé)”}”(hŒÂIf you are dealing with a 'warning', an 'OOPS' or a 'panic' from the kernel,
include it. If you can't copy'n'paste it, try to capture a netconsole trace
or at least take a picture of the screen.”h]”hŒÔIf you are dealing with a â€˜warningâ€™, an â€˜OOPSâ€™ or a â€˜panicâ€™ from the kernel,
include it. If you canâ€™t copyâ€™nâ€™paste it, try to capture a netconsole trace
or at least take a picture of the screen.”…””}”(hjÏ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MˆhjË  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjÈ  ubj¤  )”}”(hX/  If the issue might be related to your computer hardware, mention what kind
of system you use. If you for example have problems with your graphics card,
mention its manufacturer, the card's model, and what chip is uses. If it's a
laptop mention its name, but try to make sure it's meaningful. 'Dell XPS 13'
for example is not, because it might be the one from 2012; that one looks
not that different from the one sold today, but apart from that the two have
nothing in common. Hence, in such cases add the exact model number, which
for example are '9380' or '7390' for XPS 13 models introduced during 2019.
Names like 'Lenovo Thinkpad T590' are also somewhat ambiguous: there are
variants of this laptop with and without a dedicated graphics chip, so try
to find the exact model name or specify the main components.
”h]”hé)”}”(hX.  If the issue might be related to your computer hardware, mention what kind
of system you use. If you for example have problems with your graphics card,
mention its manufacturer, the card's model, and what chip is uses. If it's a
laptop mention its name, but try to make sure it's meaningful. 'Dell XPS 13'
for example is not, because it might be the one from 2012; that one looks
not that different from the one sold today, but apart from that the two have
nothing in common. Hence, in such cases add the exact model number, which
for example are '9380' or '7390' for XPS 13 models introduced during 2019.
Names like 'Lenovo Thinkpad T590' are also somewhat ambiguous: there are
variants of this laptop with and without a dedicated graphics chip, so try
to find the exact model name or specify the main components.”h]”hXD  If the issue might be related to your computer hardware, mention what kind
of system you use. If you for example have problems with your graphics card,
mention its manufacturer, the cardâ€™s model, and what chip is uses. If itâ€™s a
laptop mention its name, but try to make sure itâ€™s meaningful. â€˜Dell XPS 13â€™
for example is not, because it might be the one from 2012; that one looks
not that different from the one sold today, but apart from that the two have
nothing in common. Hence, in such cases add the exact model number, which
for example are â€˜9380â€™ or â€˜7390â€™ for XPS 13 models introduced during 2019.
Names like â€˜Lenovo Thinkpad T590â€™ are also somewhat ambiguous: there are
variants of this laptop with and without a dedicated graphics chip, so try
to find the exact model name or specify the main components.”…””}”(hjç  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MŒhjã  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjÈ  ubj¤  )”}”(hX¶  Mention the relevant software in use. If you have problems with loading
modules, you want to mention the versions of kmod, systemd, and udev in use.
If one of the DRM drivers misbehaves, you want to state the versions of
libdrm and Mesa; also specify your Wayland compositor or the X-Server and
its driver. If you have a filesystem issue, mention the version of
corresponding filesystem utilities (e2fsprogs, btrfs-progs, xfsprogs, ...).
”h]”hé)”}”(hXµ  Mention the relevant software in use. If you have problems with loading
modules, you want to mention the versions of kmod, systemd, and udev in use.
If one of the DRM drivers misbehaves, you want to state the versions of
libdrm and Mesa; also specify your Wayland compositor or the X-Server and
its driver. If you have a filesystem issue, mention the version of
corresponding filesystem utilities (e2fsprogs, btrfs-progs, xfsprogs, ...).”h]”hXµ  Mention the relevant software in use. If you have problems with loading
modules, you want to mention the versions of kmod, systemd, and udev in use.
If one of the DRM drivers misbehaves, you want to state the versions of
libdrm and Mesa; also specify your Wayland compositor or the X-Server and
its driver. If you have a filesystem issue, mention the version of
corresponding filesystem utilities (e2fsprogs, btrfs-progs, xfsprogs, ...).”…””}”(hjÿ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M˜hjû  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjÈ  ubj¤  )”}”(hXÄ  Gather additional information from the kernel that might be of interest. The
output from ``lspci -nn`` will for example help others to identify what
hardware you use. If you have a problem with hardware you even might want to
make the output from ``sudo lspci -vvv`` available, as that provides
insights how the components were configured. For some issues it might be
good to include the contents of files like ``/proc/cpuinfo``,
``/proc/ioports``, ``/proc/iomem``, ``/proc/modules``, or
``/proc/scsi/scsi``. Some subsystem also offer tools to collect relevant
information. One such tool is ``alsa-info.sh`` `which the audio/sound
subsystem developers provide <https://www.alsa-project.org/wiki/AlsaInfo>`_.
”h]”hé)”}”(hXÃ  Gather additional information from the kernel that might be of interest. The
output from ``lspci -nn`` will for example help others to identify what
hardware you use. If you have a problem with hardware you even might want to
make the output from ``sudo lspci -vvv`` available, as that provides
insights how the components were configured. For some issues it might be
good to include the contents of files like ``/proc/cpuinfo``,
``/proc/ioports``, ``/proc/iomem``, ``/proc/modules``, or
``/proc/scsi/scsi``. Some subsystem also offer tools to collect relevant
information. One such tool is ``alsa-info.sh`` `which the audio/sound
subsystem developers provide <https://www.alsa-project.org/wiki/AlsaInfo>`_.”h]”(hŒYGather additional information from the kernel that might be of interest. The
output from ”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``lspci -nn``”h]”hŒ	lspci -nn”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒ‘ will for example help others to identify what
hardware you use. If you have a problem with hardware you even might want to
make the output from ”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``sudo lspci -vvv``”h]”hŒsudo lspci -vvv”…””}”(hj1  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒ‘ available, as that provides
insights how the components were configured. For some issues it might be
good to include the contents of files like ”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``/proc/cpuinfo``”h]”hŒ/proc/cpuinfo”…””}”(hjC  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒ,
”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``/proc/ioports``”h]”hŒ/proc/ioports”…””}”(hjU  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒ, ”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``/proc/iomem``”h]”hŒ/proc/iomem”…””}”(hjg  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒ, ”…””}”hj  sbj  )”}”(hŒ``/proc/modules``”h]”hŒ/proc/modules”…””}”(hjy  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒ, or
”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``/proc/scsi/scsi``”h]”hŒ/proc/scsi/scsi”…””}”(hj‹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒT. Some subsystem also offer tools to collect relevant
information. One such tool is ”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``alsa-info.sh``”h]”hŒalsa-info.sh”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒ ”…””}”(hj  hžhhŸNh Nubhó)”}”(hŒb`which the audio/sound
subsystem developers provide <https://www.alsa-project.org/wiki/AlsaInfo>`_”h]”hŒ2which the audio/sound
subsystem developers provide”…””}”(hj¯  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ2which the audio/sound subsystem developers provide”j  Œ*https://www.alsa-project.org/wiki/AlsaInfo”uh1hòhj  ubj  )”}”(hŒ- <https://www.alsa-project.org/wiki/AlsaInfo>”h]”h}”(h]”Œ2which-the-audio-sound-subsystem-developers-provide”ah ]”h"]”Œ2which the audio/sound subsystem developers provide”ah$]”h&]”Œrefuri”j¿  uh1j  j  Khj  ubhŒ.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MŸhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjÈ  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h MˆhjÄ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Mˆhj¥  hžhubhé)”}”(hXq  Those examples should give your some ideas of what data might be wise to
attach, but you have to think yourself what will be helpful for others to know.
Don't worry too much about forgetting something, as developers will ask for
additional details they need. But making everything important available from
the start increases the chance someone will take a closer look.”h]”hXs  Those examples should give your some ideas of what data might be wise to
attach, but you have to think yourself what will be helpful for others to know.
Donâ€™t worry too much about forgetting something, as developers will ask for
additional details they need. But making everything important available from
the start increases the chance someone will take a closer look.”…””}”(hjé  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mªhj¥  hžhubeh}”(h]”Œ$things-that-might-be-wise-to-provide”ah ]”h"]”Œ$things that might be wise to provide”ah$]”h&]”uh1hÂhjk  hžhhŸh³h MƒubhÃ)”}”(hhh]”(hÈ)”}”(hŒ+The important part: the head of your report”h]”hŒ+The important part: the head of your report”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÿ  hžhhŸh³h M²ubhé)”}”(hX  Now that you have the detailed part of the report prepared let's get to the
most important section: the first few sentences. Thus go to the top, add
something like 'The detailed description:' before the part you just wrote and
insert two newlines at the top. Now write one normal length paragraph that
describes the issue roughly. Leave out all boring details and focus on the
crucial parts readers need to know to understand what this is all about; if you
think this bug affects a lot of users, mention this to get people interested.”h]”hX  Now that you have the detailed part of the report prepared letâ€™s get to the
most important section: the first few sentences. Thus go to the top, add
something like â€˜The detailed description:â€™ before the part you just wrote and
insert two newlines at the top. Now write one normal length paragraph that
describes the issue roughly. Leave out all boring details and focus on the
crucial parts readers need to know to understand what this is all about; if you
think this bug affects a lot of users, mention this to get people interested.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M´hjÿ  hžhubhé)”}”(hŒéOnce you did that insert two more lines at the top and write a one sentence
summary that explains quickly what the report is about. After that you have to
get even more abstract and write an even shorter subject/title for the report.”h]”hŒéOnce you did that insert two more lines at the top and write a one sentence
summary that explains quickly what the report is about. After that you have to
get even more abstract and write an even shorter subject/title for the report.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M¼hjÿ  hžhubhé)”}”(hŒÓNow that you have written this part take some time to optimize it, as it is the
most important parts of your report: a lot of people will only read this before
they decide if reading the rest is time well spent.”h]”hŒÓNow that you have written this part take some time to optimize it, as it is the
most important parts of your report: a lot of people will only read this before
they decide if reading the rest is time well spent.”…””}”(hj,  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÀhjÿ  hžhubhé)”}”(hŒòNow send or file the report like the :ref:`MAINTAINERS <maintainers>` file told
you, unless it's one of those 'issues of high priority' outlined earlier: in
that case please read the next subsection first before sending the report on
its way.”h]”(hŒ%Now send or file the report like the ”…””}”(hj:  hžhhŸNh Nubh)”}”(hŒ :ref:`MAINTAINERS <maintainers>`”h]”j™  )”}”(hjD  h]”hŒMAINTAINERS”…””}”(hjF  hžhhŸNh Nubah}”(h]”h ]”(j¤  Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j˜  hjB  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j±  Œ	refdomain”jP  Œreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆj·  Œmaintainers”uh1hhŸh³h MÄhj:  ubhŒ³ file told
you, unless itâ€™s one of those â€˜issues of high priorityâ€™ outlined earlier: in
that case please read the next subsection first before sending the report on
its way.”…””}”(hj:  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÄhjÿ  hžhubeh}”(h]”Œ*the-important-part-the-head-of-your-report”ah ]”h"]”Œ+the important part: the head of your report”ah$]”h&]”uh1hÂhjk  hžhhŸh³h M²ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ)Special handling for high priority issues”h]”hŒ)Special handling for high priority issues”…””}”(hjw  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjt  hžhhŸh³h MÊubhé)”}”(hŒ7Reports for high priority issues need special handling.”h]”hŒ7Reports for high priority issues need special handling.”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÌhjt  hžhubhé)”}”(hŒu**Severe issues**: make sure the subject or ticket title as well as the first
paragraph makes the severeness obvious.”h]”(j  )”}”(hŒ**Severe issues**”h]”hŒSevere issues”…””}”(hj—  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj“  ubhŒd: make sure the subject or ticket title as well as the first
paragraph makes the severeness obvious.”…””}”(hj“  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÎhjt  hžhubhé)”}”(hŒE**Regressions**: make the report's subject start with '[REGRESSION]'.”h]”(j  )”}”(hŒ**Regressions**”h]”hŒRegressions”…””}”(hj³  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj¯  ubhŒ<: make the reportâ€™s subject start with â€˜[REGRESSION]â€™.”…””}”(hj¯  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÑhjt  hžhubhé)”}”(hXs  In case you performed a successful bisection, use the title of the change that
introduced the regression as the second part of your subject. Make the report
also mention the commit id of the culprit. In case of an unsuccessful bisection,
make your report mention the latest tested version that's working fine (say 5.7)
and the oldest where the issue occurs (say 5.8-rc1).”h]”hXu  In case you performed a successful bisection, use the title of the change that
introduced the regression as the second part of your subject. Make the report
also mention the commit id of the culprit. In case of an unsuccessful bisection,
make your report mention the latest tested version thatâ€™s working fine (say 5.7)
and the oldest where the issue occurs (say 5.8-rc1).”…””}”(hjË  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÓhjt  hžhubhé)”}”(hXÃ  When sending the report by mail, CC the Linux regressions mailing list
(regressions@lists.linux.dev). In case the report needs to be filed to some web
tracker, proceed to do so. Once filed, forward the report by mail to the
regressions list; CC the maintainer and the mailing list for the subsystem in
question. Make sure to inline the forwarded report, hence do not attach it.
Also add a short note at the top where you mention the URL to the ticket.”h]”(hŒHWhen sending the report by mail, CC the Linux regressions mailing list
(”…””}”(hjÙ  hžhhŸNh Nubhó)”}”(hŒregressions@lists.linux.dev”h]”hŒregressions@lists.linux.dev”…””}”(hjá  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ"mailto:regressions@lists.linux.dev”uh1hòhjÙ  ubhX`  ). In case the report needs to be filed to some web
tracker, proceed to do so. Once filed, forward the report by mail to the
regressions list; CC the maintainer and the mailing list for the subsystem in
question. Make sure to inline the forwarded report, hence do not attach it.
Also add a short note at the top where you mention the URL to the ticket.”…””}”(hjÙ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÙhjt  hžhubhé)”}”(hŒ×When mailing or forwarding the report, in case of a successful bisection add the
author of the culprit to the recipients; also CC everyone in the signed-off-by
chain, which you find at the end of its commit message.”h]”hŒ×When mailing or forwarding the report, in case of a successful bisection add the
author of the culprit to the recipients; also CC everyone in the signed-off-by
chain, which you find at the end of its commit message.”…””}”(hjû  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Màhjt  hžhubhé)”}”(hX:  **Security issues**: for these issues your will have to evaluate if a
short-term risk to other users would arise if details were publicly disclosed.
If that's not the case simply proceed with reporting the issue as described.
For issues that bear such a risk you will need to adjust the reporting process
slightly:”h]”(j  )”}”(hŒ**Security issues**”h]”hŒSecurity issues”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj	  ubhX)  : for these issues your will have to evaluate if a
short-term risk to other users would arise if details were publicly disclosed.
If thatâ€™s not the case simply proceed with reporting the issue as described.
For issues that bear such a risk you will need to adjust the reporting process
slightly:”…””}”(hj	  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mähjt  hžhubj™  )”}”(hX€  * If the MAINTAINERS file instructed you to report the issue by mail, do not
  CC any public mailing lists.

* If you were supposed to file the issue in a bug tracker make sure to mark
  the ticket as 'private' or 'security issue'. If the bug tracker does not
  offer a way to keep reports private, forget about it and send your report as
  a private mail to the maintainers instead.
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hŒhIf the MAINTAINERS file instructed you to report the issue by mail, do not
CC any public mailing lists.
”h]”hé)”}”(hŒgIf the MAINTAINERS file instructed you to report the issue by mail, do not
CC any public mailing lists.”h]”hŒgIf the MAINTAINERS file instructed you to report the issue by mail, do not
CC any public mailing lists.”…””}”(hj0  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mêhj,  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj)  ubj¤  )”}”(hX  If you were supposed to file the issue in a bug tracker make sure to mark
the ticket as 'private' or 'security issue'. If the bug tracker does not
offer a way to keep reports private, forget about it and send your report as
a private mail to the maintainers instead.
”h]”hé)”}”(hX
  If you were supposed to file the issue in a bug tracker make sure to mark
the ticket as 'private' or 'security issue'. If the bug tracker does not
offer a way to keep reports private, forget about it and send your report as
a private mail to the maintainers instead.”h]”hX  If you were supposed to file the issue in a bug tracker make sure to mark
the ticket as â€˜privateâ€™ or â€˜security issueâ€™. If the bug tracker does not
offer a way to keep reports private, forget about it and send your report as
a private mail to the maintainers instead.”…””}”(hjH  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MíhjD  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj)  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h Mêhj%  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Mêhjt  hžhubhé)”}”(hXj  In both cases make sure to also mail your report to the addresses the
MAINTAINERS file lists in the section 'security contact'. Ideally directly CC
them when sending the report by mail. If you filed it in a bug tracker, forward
the report's text to these addresses; but on top of it put a small note where
you mention that you filed it with a link to the ticket.”h]”hXp  In both cases make sure to also mail your report to the addresses the
MAINTAINERS file lists in the section â€˜security contactâ€™. Ideally directly CC
them when sending the report by mail. If you filed it in a bug tracker, forward
the reportâ€™s text to these addresses; but on top of it put a small note where
you mention that you filed it with a link to the ticket.”…””}”(hjh  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mòhjt  hžhubhé)”}”(hŒASee Documentation/process/security-bugs.rst for more information.”h]”hŒASee Documentation/process/security-bugs.rst for more information.”…””}”(hjv  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Møhjt  hžhubeh}”(h]”Œ)special-handling-for-high-priority-issues”ah ]”h"]”Œ)special handling for high priority issues”ah$]”h&]”uh1hÂhjk  hžhhŸh³h MÊubeh}”(h]”Œwrite-and-send-the-report”ah ]”h"]”Œwrite and send the report”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h M-ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ Duties after the report went out”h]”hŒ Duties after the report went out”…””}”(hj—  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj”  hžhhŸh³h Müubj™  )”}”(hX³  *Wait for reactions and keep the thing rolling until you can accept the
outcome in one way or the other. Thus react publicly and in a timely manner
to any inquiries. Test proposed fixes. Do proactive testing: retest with at
least every first release candidate (RC) of a new mainline version and
report your results. Send friendly reminders if things stall. And try to
help yourself, if you don't get any help or if it's unsatisfying.*
”h]”hé)”}”(hX²  *Wait for reactions and keep the thing rolling until you can accept the
outcome in one way or the other. Thus react publicly and in a timely manner
to any inquiries. Test proposed fixes. Do proactive testing: retest with at
least every first release candidate (RC) of a new mainline version and
report your results. Send friendly reminders if things stall. And try to
help yourself, if you don't get any help or if it's unsatisfying.*”h]”j¾  )”}”(hj«  h]”hX´  Wait for reactions and keep the thing rolling until you can accept the
outcome in one way or the other. Thus react publicly and in a timely manner
to any inquiries. Test proposed fixes. Do proactive testing: retest with at
least every first release candidate (RC) of a new mainline version and
report your results. Send friendly reminders if things stall. And try to
help yourself, if you donâ€™t get any help or if itâ€™s unsatisfying.”…””}”(hj­  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj©  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mþhj¥  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Mþhj”  hžhubhé)”}”(hXª  If your report was good and you are really lucky then one of the developers
might immediately spot what's causing the issue; they then might write a patch
to fix it, test it, and send it straight for integration in mainline while
tagging it for later backport to stable and longterm kernels that need it. Then
all you need to do is reply with a 'Thank you very much' and switch to a version
with the fix once it gets released.”h]”hX°  If your report was good and you are really lucky then one of the developers
might immediately spot whatâ€™s causing the issue; they then might write a patch
to fix it, test it, and send it straight for integration in mainline while
tagging it for later backport to stable and longterm kernels that need it. Then
all you need to do is reply with a â€˜Thank you very muchâ€™ and switch to a version
with the fix once it gets released.”…””}”(hjÆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj”  hžhubhé)”}”(hXD  But this ideal scenario rarely happens. That's why the job is only starting
once you got the report out. What you'll have to do depends on the situations,
but often it will be the things listed below. But before digging into the
details, here are a few important things you need to keep in mind for this part
of the process.”h]”hXH  But this ideal scenario rarely happens. Thatâ€™s why the job is only starting
once you got the report out. What youâ€™ll have to do depends on the situations,
but often it will be the things listed below. But before digging into the
details, here are a few important things you need to keep in mind for this part
of the process.”…””}”(hjÔ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj”  hžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒ'General advice for further interactions”h]”hŒ'General advice for further interactions”…””}”(hjå  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjâ  hžhhŸh³h Mubhé)”}”(hX£  **Always reply in public**: When you filed the issue in a bug tracker, always
reply there and do not contact any of the developers privately about it. For
mailed reports always use the 'Reply-all' function when replying to any mails
you receive. That includes mails with any additional data you might want to add
to your report: go to your mail applications 'Sent' folder and use 'reply-all'
on your mail with the report. This approach will make sure the public mailing
list(s) and everyone else that gets involved over time stays in the loop; it
also keeps the mail thread intact, which among others is really important for
mailing lists to group all related mails together.”h]”(j  )”}”(hŒ**Always reply in public**”h]”hŒAlways reply in public”…””}”(hj÷  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjó  ubhX•  : When you filed the issue in a bug tracker, always
reply there and do not contact any of the developers privately about it. For
mailed reports always use the â€˜Reply-allâ€™ function when replying to any mails
you receive. That includes mails with any additional data you might want to add
to your report: go to your mail applications â€˜Sentâ€™ folder and use â€˜reply-allâ€™
on your mail with the report. This approach will make sure the public mailing
list(s) and everyone else that gets involved over time stays in the loop; it
also keeps the mail thread intact, which among others is really important for
mailing lists to group all related mails together.”…””}”(hjó  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhjâ  hžhubhé)”}”(hŒ^There are just two situations where a comment in a bug tracker or a 'Reply-all'
is unsuitable:”h]”hŒbThere are just two situations where a comment in a bug tracker or a â€˜Reply-allâ€™
is unsuitable:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M hjâ  hžhubj™  )”}”(hX]  * Someone tells you to send something privately.

* You were told to send something, but noticed it contains sensitive
  information that needs to be kept private. In that case it's okay to send it
  in private to the developer that asked for it. But note in the ticket or a
  mail that you did that, so everyone else knows you honored the request.
”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hŒ/Someone tells you to send something privately.
”h]”hé)”}”(hŒ.Someone tells you to send something privately.”h]”hŒ.Someone tells you to send something privately.”…””}”(hj(  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M#hj$  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj!  ubj¤  )”}”(hX#  You were told to send something, but noticed it contains sensitive
information that needs to be kept private. In that case it's okay to send it
in private to the developer that asked for it. But note in the ticket or a
mail that you did that, so everyone else knows you honored the request.
”h]”hé)”}”(hX"  You were told to send something, but noticed it contains sensitive
information that needs to be kept private. In that case it's okay to send it
in private to the developer that asked for it. But note in the ticket or a
mail that you did that, so everyone else knows you honored the request.”h]”hX$  You were told to send something, but noticed it contains sensitive
information that needs to be kept private. In that case itâ€™s okay to send it
in private to the developer that asked for it. But note in the ticket or a
mail that you did that, so everyone else knows you honored the request.”…””}”(hj@  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M%hj<  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj!  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h M#hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M#hjâ  hžhubhé)”}”(hX¢  **Do research before asking for clarifications or help**: In this part of the
process someone might tell you to do something that requires a skill you might
not have mastered yet. For example, you might be asked to use some test tools
you never have heard of yet; or you might be asked to apply a patch to the
Linux kernel sources to test if it helps. In some cases it will be fine sending
a reply asking for instructions how to do that. But before going that route try
to find the answer own your own by searching the internet; alternatively
consider asking in other places for advice. For example ask a friend or post
about it to a chatroom or forum you normally hang out.”h]”(j  )”}”(hŒ8**Do research before asking for clarifications or help**”h]”hŒ4Do research before asking for clarifications or help”…””}”(hjd  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj`  ubhXj  : In this part of the
process someone might tell you to do something that requires a skill you might
not have mastered yet. For example, you might be asked to use some test tools
you never have heard of yet; or you might be asked to apply a patch to the
Linux kernel sources to test if it helps. In some cases it will be fine sending
a reply asking for instructions how to do that. But before going that route try
to find the answer own your own by searching the internet; alternatively
consider asking in other places for advice. For example ask a friend or post
about it to a chatroom or forum you normally hang out.”…””}”(hj`  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M*hjâ  hžhubhé)”}”(hX$  **Be patient**: If you are really lucky you might get a reply to your report
within a few hours. But most of the time it will take longer, as maintainers
are scattered around the globe and thus might be in a different time zone â€“ one
where they already enjoy their night away from keyboard.”h]”(j  )”}”(hŒ**Be patient**”h]”hŒ
Be patient”…””}”(hj€  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj|  ubhX  : If you are really lucky you might get a reply to your report
within a few hours. But most of the time it will take longer, as maintainers
are scattered around the globe and thus might be in a different time zone â€“ one
where they already enjoy their night away from keyboard.”…””}”(hj|  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M4hjâ  hžhubhé)”}”(hŒûIn general, kernel developers will take one to five business days to respond to
reports. Sometimes it will take longer, as they might be busy with the merge
windows, other work, visiting developer conferences, or simply enjoying a long
summer holiday.”h]”hŒûIn general, kernel developers will take one to five business days to respond to
reports. Sometimes it will take longer, as they might be busy with the merge
windows, other work, visiting developer conferences, or simply enjoying a long
summer holiday.”…””}”(hj˜  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M9hjâ  hžhubhé)”}”(hX  The 'issues of high priority' (see above for an explanation) are an exception
here: maintainers should address them as soon as possible; that's why you
should wait a week at maximum (or just two days if it's something urgent)
before sending a friendly reminder.”h]”hX  The â€˜issues of high priorityâ€™ (see above for an explanation) are an exception
here: maintainers should address them as soon as possible; thatâ€™s why you
should wait a week at maximum (or just two days if itâ€™s something urgent)
before sending a friendly reminder.”…””}”(hj¦  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M>hjâ  hžhubhé)”}”(hX:  Sometimes the maintainer might not be responding in a timely manner; other
times there might be disagreements, for example if an issue qualifies as
regression or not. In such cases raise your concerns on the mailing list and
ask others for public or private replies how to move on. If that fails, it
might be appropriate to get a higher authority involved. In case of a WiFi
driver that would be the wireless maintainers; if there are no higher level
maintainers or all else fails, it might be one of those rare situations where
it's okay to get Linus Torvalds involved.”h]”hX<  Sometimes the maintainer might not be responding in a timely manner; other
times there might be disagreements, for example if an issue qualifies as
regression or not. In such cases raise your concerns on the mailing list and
ask others for public or private replies how to move on. If that fails, it
might be appropriate to get a higher authority involved. In case of a WiFi
driver that would be the wireless maintainers; if there are no higher level
maintainers or all else fails, it might be one of those rare situations where
itâ€™s okay to get Linus Torvalds involved.”…””}”(hj´  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MChjâ  hžhubhé)”}”(hXÍ  **Proactive testing**: Every time the first pre-release (the 'rc1') of a new
mainline kernel version gets released, go and check if the issue is fixed there
or if anything of importance changed. Mention the outcome in the ticket or in a
mail you sent as reply to your report (make sure it has all those in the CC
that up to that point participated in the discussion). This will show your
commitment and that you are willing to help. It also tells developers if the
issue persists and makes sure they do not forget about it. A few other
occasional retests (for example with rc3, rc5 and the final) are also a good
idea, but only report your results if something relevant changed or if you are
writing something anyway.”h]”(j  )”}”(hŒ**Proactive testing**”h]”hŒProactive testing”…””}”(hjÆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÂ  ubhX¼  : Every time the first pre-release (the â€˜rc1â€™) of a new
mainline kernel version gets released, go and check if the issue is fixed there
or if anything of importance changed. Mention the outcome in the ticket or in a
mail you sent as reply to your report (make sure it has all those in the CC
that up to that point participated in the discussion). This will show your
commitment and that you are willing to help. It also tells developers if the
issue persists and makes sure they do not forget about it. A few other
occasional retests (for example with rc3, rc5 and the final) are also a good
idea, but only report your results if something relevant changed or if you are
writing something anyway.”…””}”(hjÂ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MLhjâ  hžhubhé)”}”(hŒ…With all these general things off the table let's get into the details of how
to help to get issues resolved once they were reported.”h]”hŒ‡With all these general things off the table letâ€™s get into the details of how
to help to get issues resolved once they were reported.”…””}”(hjÞ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MWhjâ  hžhubeh}”(h]”Œ'general-advice-for-further-interactions”ah ]”h"]”Œ'general advice for further interactions”ah$]”h&]”uh1hÂhj”  hžhhŸh³h MubhÃ)”}”(hhh]”(hÈ)”}”(hŒInquires and testing request”h]”hŒInquires and testing request”…””}”(hj÷  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjô  hžhhŸh³h M[ubhé)”}”(hŒ<Here are your duties in case you got replies to your report:”h]”hŒ<Here are your duties in case you got replies to your report:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M]hjô  hžhubhé)”}”(hXÉ  **Check who you deal with**: Most of the time it will be the maintainer or a
developer of the particular code area that will respond to your report. But as
issues are normally reported in public it could be anyone that's replying â€”
including people that want to help, but in the end might guide you totally off
track with their questions or requests. That rarely happens, but it's one of
many reasons why it's wise to quickly run an internet search to see who you're
interacting with. By doing this you also get aware if your report was heard by
the right people, as a reminder to the maintainer (see below) might be in order
later if discussion fades out without leading to a satisfying solution for the
issue.”h]”(j  )”}”(hŒ**Check who you deal with**”h]”hŒCheck who you deal with”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubhX¶  : Most of the time it will be the maintainer or a
developer of the particular code area that will respond to your report. But as
issues are normally reported in public it could be anyone thatâ€™s replying â€”
including people that want to help, but in the end might guide you totally off
track with their questions or requests. That rarely happens, but itâ€™s one of
many reasons why itâ€™s wise to quickly run an internet search to see who youâ€™re
interacting with. By doing this you also get aware if your report was heard by
the right people, as a reminder to the maintainer (see below) might be in order
later if discussion fades out without leading to a satisfying solution for the
issue.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M_hjô  hžhubhé)”}”(hXJ  **Inquiries for data**: Often you will be asked to test something or provide
additional details. Try to provide the requested information soon, as you have
the attention of someone that might help and risk losing it the longer you
wait; that outcome is even likely if you do not provide the information within
a few business days.”h]”(j  )”}”(hŒ**Inquiries for data**”h]”hŒInquiries for data”…””}”(hj3  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj/  ubhX4  : Often you will be asked to test something or provide
additional details. Try to provide the requested information soon, as you have
the attention of someone that might help and risk losing it the longer you
wait; that outcome is even likely if you do not provide the information within
a few business days.”…””}”(hj/  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mjhjô  hžhubhé)”}”(hX  **Requests for testing**: When you are asked to test a diagnostic patch or a
possible fix, try to test it in timely manner, too. But do it properly and make
sure to not rush it: mixing things up can happen easily and can lead to a lot
of confusion for everyone involved. A common mistake for example is thinking a
proposed patch with a fix was applied, but in fact wasn't. Things like that
happen even to experienced testers occasionally, but they most of the time will
notice when the kernel with the fix behaves just as one without it.”h]”(j  )”}”(hŒ**Requests for testing**”h]”hŒRequests for testing”…””}”(hjO  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjK  ubhX  : When you are asked to test a diagnostic patch or a
possible fix, try to test it in timely manner, too. But do it properly and make
sure to not rush it: mixing things up can happen easily and can lead to a lot
of confusion for everyone involved. A common mistake for example is thinking a
proposed patch with a fix was applied, but in fact wasnâ€™t. Things like that
happen even to experienced testers occasionally, but they most of the time will
notice when the kernel with the fix behaves just as one without it.”…””}”(hjK  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mphjô  hžhubeh}”(h]”Œinquires-and-testing-request”ah ]”h"]”Œinquires and testing request”ah$]”h&]”uh1hÂhj”  hžhhŸh³h M[ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ,What to do when nothing of substance happens”h]”hŒ,What to do when nothing of substance happens”…””}”(hjr  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjo  hžhhŸh³h Myubhé)”}”(hŒ¸Some reports will not get any reaction from the responsible Linux kernel
developers; or a discussion around the issue evolved, but faded out with
nothing of substance coming out of it.”h]”hŒ¸Some reports will not get any reaction from the responsible Linux kernel
developers; or a discussion around the issue evolved, but faded out with
nothing of substance coming out of it.”…””}”(hj€  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M{hjo  hžhubhé)”}”(hX¼  In these cases wait two (better: three) weeks before sending a friendly
reminder: maybe the maintainer was just away from keyboard for a while when
your report arrived or had something more important to take care of. When
writing the reminder, kindly ask if anything else from your side is needed to
get the ball running somehow. If the report got out by mail, do that in the
first lines of a mail that is a reply to your initial mail (see above) which
includes a full quote of the original report below: that's on of those few
situations where such a 'TOFU' (Text Over, Fullquote Under) is the right
approach, as then all the recipients will have the details at hand immediately
in the proper order.”h]”hXÂ  In these cases wait two (better: three) weeks before sending a friendly
reminder: maybe the maintainer was just away from keyboard for a while when
your report arrived or had something more important to take care of. When
writing the reminder, kindly ask if anything else from your side is needed to
get the ball running somehow. If the report got out by mail, do that in the
first lines of a mail that is a reply to your initial mail (see above) which
includes a full quote of the original report below: thatâ€™s on of those few
situations where such a â€˜TOFUâ€™ (Text Over, Fullquote Under) is the right
approach, as then all the recipients will have the details at hand immediately
in the proper order.”…””}”(hjŽ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhjo  hžhubhé)”}”(hXÒ  After the reminder wait three more weeks for replies. If you still don't get a
proper reaction, you first should reconsider your approach. Did you maybe try
to reach out to the wrong people? Was the report maybe offensive or so
confusing that people decided to completely stay away from it? The best way to
rule out such factors: show the report to one or two people familiar with FLOSS
issue reporting and ask for their opinion. Also ask them for their advice how
to move forward. That might mean: prepare a better report and make those people
review it before you send it out. Such an approach is totally fine; just
mention that this is the second and improved report on the issue and include a
link to the first report.”h]”hXÔ  After the reminder wait three more weeks for replies. If you still donâ€™t get a
proper reaction, you first should reconsider your approach. Did you maybe try
to reach out to the wrong people? Was the report maybe offensive or so
confusing that people decided to completely stay away from it? The best way to
rule out such factors: show the report to one or two people familiar with FLOSS
issue reporting and ask for their opinion. Also ask them for their advice how
to move forward. That might mean: prepare a better report and make those people
review it before you send it out. Such an approach is totally fine; just
mention that this is the second and improved report on the issue and include a
link to the first report.”…””}”(hjœ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MŠhjo  hžhubhé)”}”(hXT  If the report was proper you can send a second reminder; in it ask for advice
why the report did not get any replies. A good moment for this second reminder
mail is shortly after the first pre-release (the 'rc1') of a new Linux kernel
version got published, as you should retest and provide a status update at that
point anyway (see above).”h]”hXX  If the report was proper you can send a second reminder; in it ask for advice
why the report did not get any replies. A good moment for this second reminder
mail is shortly after the first pre-release (the â€˜rc1â€™) of a new Linux kernel
version got published, as you should retest and provide a status update at that
point anyway (see above).”…””}”(hjª  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M•hjo  hžhubhé)”}”(hŒÓIf the second reminder again results in no reaction within a week, try to
contact a higher-level maintainer asking for advice: even busy maintainers by
then should at least have sent some kind of acknowledgment.”h]”hŒÓIf the second reminder again results in no reaction within a week, try to
contact a higher-level maintainer asking for advice: even busy maintainers by
then should at least have sent some kind of acknowledgment.”…””}”(hj¸  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M›hjo  hžhubhé)”}”(hX–  Remember to prepare yourself for a disappointment: maintainers ideally should
react somehow to every issue report, but they are only obliged to fix those
'issues of high priority' outlined earlier. So don't be too devastating if you
get a reply along the lines of 'thanks for the report, I have more important
issues to deal with currently and won't have time to look into this for the
foreseeable future'.”h]”hX¢  Remember to prepare yourself for a disappointment: maintainers ideally should
react somehow to every issue report, but they are only obliged to fix those
â€˜issues of high priorityâ€™ outlined earlier. So donâ€™t be too devastating if you
get a reply along the lines of â€˜thanks for the report, I have more important
issues to deal with currently and wonâ€™t have time to look into this for the
foreseeable futureâ€™.”…””}”(hjÆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MŸhjo  hžhubhé)”}”(hX¿  It's also possible that after some discussion in the bug tracker or on a list
nothing happens anymore and reminders don't help to motivate anyone to work out
a fix. Such situations can be devastating, but is within the cards when it
comes to Linux kernel development. This and several other reasons for not
getting help are explained in 'Why some issues won't get any reaction or remain
unfixed after being reported' near the end of this document.”h]”hXÉ  Itâ€™s also possible that after some discussion in the bug tracker or on a list
nothing happens anymore and reminders donâ€™t help to motivate anyone to work out
a fix. Such situations can be devastating, but is within the cards when it
comes to Linux kernel development. This and several other reasons for not
getting help are explained in â€˜Why some issues wonâ€™t get any reaction or remain
unfixed after being reportedâ€™ near the end of this document.”…””}”(hjÔ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M¦hjo  hžhubhé)”}”(hX©  Don't get devastated if you don't find any help or if the issue in the end does
not get solved: the Linux kernel is FLOSS and thus you can still help yourself.
You for example could try to find others that are affected and team up with
them to get the issue resolved. Such a team could prepare a fresh report
together that mentions how many you are and why this is something that in your
option should get fixed. Maybe together you can also narrow down the root cause
or the change that introduced a regression, which often makes developing a fix
easier. And with a bit of luck there might be someone in the team that knows a
bit about programming and might be able to write a fix.”h]”hX­  Donâ€™t get devastated if you donâ€™t find any help or if the issue in the end does
not get solved: the Linux kernel is FLOSS and thus you can still help yourself.
You for example could try to find others that are affected and team up with
them to get the issue resolved. Such a team could prepare a fresh report
together that mentions how many you are and why this is something that in your
option should get fixed. Maybe together you can also narrow down the root cause
or the change that introduced a regression, which often makes developing a fix
easier. And with a bit of luck there might be someone in the team that knows a
bit about programming and might be able to write a fix.”…””}”(hjâ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M­hjo  hžhubeh}”(h]”Œ,what-to-do-when-nothing-of-substance-happens”ah ]”h"]”Œ,what to do when nothing of substance happens”ah$]”h&]”uh1hÂhj”  hžhhŸh³h Myubeh}”(h]”Œ duties-after-the-report-went-out”ah ]”h"]”Œ duties after the report went out”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h MüubhÃ)”}”(hhh]”(hÈ)”}”(hŒNReference for "Reporting regressions within a stable and longterm kernel line"”h]”hŒRReference for â€œReporting regressions within a stable and longterm kernel lineâ€”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj   hžhhŸh³h M¹ubhé)”}”(hŒ…This subsection provides details for the steps you need to perform if you face
a regression within a stable and longterm kernel line.”h]”hŒ…This subsection provides details for the steps you need to perform if you face
a regression within a stable and longterm kernel line.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M»hj   hžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒ8Make sure the particular version line still gets support”h]”hŒ8Make sure the particular version line still gets support”…””}”(hj"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj  hžhhŸh³h M¿ubj™  )”}”(hŒå*Check if the kernel developers still maintain the Linux kernel version
line you care about: go to the front page of kernel.org and make sure it
mentions the latest release of the particular version line without an
'[EOL]' tag.*
”h]”hé)”}”(hŒä*Check if the kernel developers still maintain the Linux kernel version
line you care about: go to the front page of kernel.org and make sure it
mentions the latest release of the particular version line without an
'[EOL]' tag.*”h]”j¾  )”}”(hj6  h]”hŒæCheck if the kernel developers still maintain the Linux kernel version
line you care about: go to the front page of kernel.org and make sure it
mentions the latest release of the particular version line without an
â€˜[EOL]â€™ tag.”…””}”(hj8  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj4  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÁhj0  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MÁhj  hžhubhé)”}”(hX4  Most kernel version lines only get supported for about three months, as
maintaining them longer is quite a lot of work. Hence, only one per year is
chosen and gets supported for at least two years (often six). That's why you
need to check if the kernel developers still support the version line you care
for.”h]”hX6  Most kernel version lines only get supported for about three months, as
maintaining them longer is quite a lot of work. Hence, only one per year is
chosen and gets supported for at least two years (often six). Thatâ€™s why you
need to check if the kernel developers still support the version line you care
for.”…””}”(hjQ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÆhj  hžhubhé)”}”(hX‰  Note, if kernel.org lists two stable version lines on the front page, you
should consider switching to the newer one and forget about the older one:
support for it is likely to be abandoned soon. Then it will get a "end-of-life"
(EOL) stamp. Version lines that reached that point still get mentioned on the
kernel.org front page for a week or two, but are unsuitable for testing and
reporting.”h]”hX  Note, if kernel.org lists two stable version lines on the front page, you
should consider switching to the newer one and forget about the older one:
support for it is likely to be abandoned soon. Then it will get a â€œend-of-lifeâ€
(EOL) stamp. Version lines that reached that point still get mentioned on the
kernel.org front page for a week or two, but are unsuitable for testing and
reporting.”…””}”(hj_  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÌhj  hžhubeh}”(h]”Œ8make-sure-the-particular-version-line-still-gets-support”ah ]”h"]”Œ8make sure the particular version line still gets support”ah$]”h&]”uh1hÂhj   hžhhŸh³h M¿ubhÃ)”}”(hhh]”(hÈ)”}”(hŒSearch stable mailing list”h]”hŒSearch stable mailing list”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhju  hžhhŸh³h MÔubj™  )”}”(hŒL*Check the archives of the Linux stable mailing list for existing reports.*
”h]”hé)”}”(hŒK*Check the archives of the Linux stable mailing list for existing reports.*”h]”j¾  )”}”(hjŒ  h]”hŒICheck the archives of the Linux stable mailing list for existing reports.”…””}”(hjŽ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjŠ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÖhj†  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MÖhju  hžhubhé)”}”(hXO  Maybe the issue you face is already known and was fixed or is about to. Hence,
`search the archives of the Linux stable mailing list
<https://lore.kernel.org/stable/>`_ for reports about an issue like yours. If
you find any matches, consider joining the discussion, unless the fix is
already finished and scheduled to get applied soon.”h]”(hŒOMaybe the issue you face is already known and was fixed or is about to. Hence,
”…””}”(hj§  hžhhŸNh Nubhó)”}”(hŒY`search the archives of the Linux stable mailing list
<https://lore.kernel.org/stable/>`_”h]”hŒ4search the archives of the Linux stable mailing list”…””}”(hj¯  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ4search the archives of the Linux stable mailing list”j  Œhttps://lore.kernel.org/stable/”uh1hòhj§  ubj  )”}”(hŒ"
<https://lore.kernel.org/stable/>”h]”h}”(h]”Œ4search-the-archives-of-the-linux-stable-mailing-list”ah ]”h"]”Œ4search the archives of the linux stable mailing list”ah$]”h&]”Œrefuri”j¿  uh1j  j  Khj§  ubhŒ§ for reports about an issue like yours. If
you find any matches, consider joining the discussion, unless the fix is
already finished and scheduled to get applied soon.”…””}”(hj§  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MØhju  hžhubeh}”(h]”Œsearch-stable-mailing-list”ah ]”h"]”Œsearch stable mailing list”ah$]”h&]”uh1hÂhj   hžhhŸh³h MÔubhÃ)”}”(hhh]”(hÈ)”}”(hŒ'Reproduce issue with the newest release”h]”hŒ'Reproduce issue with the newest release”…””}”(hjâ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjß  hžhhŸh³h Mßubj™  )”}”(hXJ  *Install the latest release from the particular version line as a vanilla
kernel. Ensure this kernel is not tainted and still shows the problem, as
the issue might have already been fixed there. If you first noticed the
problem with a vendor kernel, check a vanilla build of the last version
known to work performs fine as well.*
”h]”hé)”}”(hXI  *Install the latest release from the particular version line as a vanilla
kernel. Ensure this kernel is not tainted and still shows the problem, as
the issue might have already been fixed there. If you first noticed the
problem with a vendor kernel, check a vanilla build of the last version
known to work performs fine as well.*”h]”j¾  )”}”(hjö  h]”hXG  Install the latest release from the particular version line as a vanilla
kernel. Ensure this kernel is not tainted and still shows the problem, as
the issue might have already been fixed there. If you first noticed the
problem with a vendor kernel, check a vanilla build of the last version
known to work performs fine as well.”…””}”(hjø  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjô  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Máhjð  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Máhjß  hžhubhé)”}”(hXF  Before investing any more time in this process you want to check if the issue
was already fixed in the latest release of version line you're interested in.
This kernel needs to be vanilla and shouldn't be tainted before the issue
happens, as detailed outlined already above in the section "Install a fresh
kernel for testing".”•§¸      h]”hXN  Before investing any more time in this process you want to check if the issue
was already fixed in the latest release of version line youâ€™re interested in.
This kernel needs to be vanilla and shouldnâ€™t be tainted before the issue
happens, as detailed outlined already above in the section â€œInstall a fresh
kernel for testingâ€.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mçhjß  hžhubhé)”}”(hX  Did you first notice the regression with a vendor kernel? Then changes the
vendor applied might be interfering. You need to rule that out by performing
a recheck. Say something broke when you updated from 5.10.4-vendor.42 to
5.10.5-vendor.43. Then after testing the latest 5.10 release as outlined in
the previous paragraph check if a vanilla build of Linux 5.10.4 works fine as
well. If things are broken there, the issue does not qualify as upstream
regression and you need switch back to the main step-by-step guide to report
the issue.”h]”hX  Did you first notice the regression with a vendor kernel? Then changes the
vendor applied might be interfering. You need to rule that out by performing
a recheck. Say something broke when you updated from 5.10.4-vendor.42 to
5.10.5-vendor.43. Then after testing the latest 5.10 release as outlined in
the previous paragraph check if a vanilla build of Linux 5.10.4 works fine as
well. If things are broken there, the issue does not qualify as upstream
regression and you need switch back to the main step-by-step guide to report
the issue.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Míhjß  hžhubeh}”(h]”Œ'reproduce-issue-with-the-newest-release”ah ]”h"]”Œ'reproduce issue with the newest release”ah$]”h&]”uh1hÂhj   hžhhŸh³h MßubhÃ)”}”(hhh]”(hÈ)”}”(hŒReport the regression”h]”hŒReport the regression”…””}”(hj8  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj5  hžhhŸh³h M÷ubj™  )”}”(hXÀ  *Send a short problem report to the Linux stable mailing list
(stable@vger.kernel.org) and CC the Linux regressions mailing list
(regressions@lists.linux.dev); if you suspect the cause in a particular
subsystem, CC its maintainer and its mailing list. Roughly describe the
issue and ideally explain how to reproduce it. Mention the first version
that shows the problem and the last version that's working fine. Then
wait for further instructions.*
”h]”hé)”}”(hX¿  *Send a short problem report to the Linux stable mailing list
(stable@vger.kernel.org) and CC the Linux regressions mailing list
(regressions@lists.linux.dev); if you suspect the cause in a particular
subsystem, CC its maintainer and its mailing list. Roughly describe the
issue and ideally explain how to reproduce it. Mention the first version
that shows the problem and the last version that's working fine. Then
wait for further instructions.*”h]”j¾  )”}”(hjL  h]”hX¿  Send a short problem report to the Linux stable mailing list
(stable@vger.kernel.org) and CC the Linux regressions mailing list
(regressions@lists.linux.dev); if you suspect the cause in a particular
subsystem, CC its maintainer and its mailing list. Roughly describe the
issue and ideally explain how to reproduce it. Mention the first version
that shows the problem and the last version thatâ€™s working fine. Then
wait for further instructions.”…””}”(hjN  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjJ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MùhjF  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Mùhj5  hžhubhé)”}”(hX«  When reporting a regression that happens within a stable or longterm kernel
line (say when updating from 5.10.4 to 5.10.5) a brief report is enough for
the start to get the issue reported quickly. Hence a rough description to the
stable and regressions mailing list is all it takes; but in case you suspect
the cause in a particular subsystem, CC its maintainers and its mailing list
as well, because that will speed things up.”h]”hX«  When reporting a regression that happens within a stable or longterm kernel
line (say when updating from 5.10.4 to 5.10.5) a brief report is enough for
the start to get the issue reported quickly. Hence a rough description to the
stable and regressions mailing list is all it takes; but in case you suspect
the cause in a particular subsystem, CC its maintainers and its mailing list
as well, because that will speed things up.”…””}”(hjg  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj5  hžhubhé)”}”(hX×  And note, it helps developers a great deal if you can specify the exact version
that introduced the problem. Hence if possible within a reasonable time frame,
try to find that version using vanilla kernels. Lets assume something broke when
your distributor released a update from Linux kernel 5.10.5 to 5.10.8. Then as
instructed above go and check the latest kernel from that version line, say
5.10.9. If it shows the problem, try a vanilla 5.10.5 to ensure that no patches
the distributor applied interfere. If the issue doesn't manifest itself there,
try 5.10.7 and then (depending on the outcome) 5.10.8 or 5.10.6 to find the
first version where things broke. Mention it in the report and state that 5.10.9
is still broken.”h]”hXÙ  And note, it helps developers a great deal if you can specify the exact version
that introduced the problem. Hence if possible within a reasonable time frame,
try to find that version using vanilla kernels. Lets assume something broke when
your distributor released a update from Linux kernel 5.10.5 to 5.10.8. Then as
instructed above go and check the latest kernel from that version line, say
5.10.9. If it shows the problem, try a vanilla 5.10.5 to ensure that no patches
the distributor applied interfere. If the issue doesnâ€™t manifest itself there,
try 5.10.7 and then (depending on the outcome) 5.10.8 or 5.10.6 to find the
first version where things broke. Mention it in the report and state that 5.10.9
is still broken.”…””}”(hju  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj5  hžhubhé)”}”(hX‹  What the previous paragraph outlines is basically a rough manual 'bisection'.
Once your report is out your might get asked to do a proper one, as it allows to
pinpoint the exact change that causes the issue (which then can easily get
reverted to fix the issue quickly). Hence consider to do a proper bisection
right away if time permits. See the section 'Special care for regressions' and
the document Documentation/admin-guide/bug-bisect.rst for details how to
perform one. In case of a successful bisection add the author of the culprit to
the recipients; also CC everyone in the signed-off-by chain, which you find at
the end of its commit message.”h]”hX“  What the previous paragraph outlines is basically a rough manual â€˜bisectionâ€™.
Once your report is out your might get asked to do a proper one, as it allows to
pinpoint the exact change that causes the issue (which then can easily get
reverted to fix the issue quickly). Hence consider to do a proper bisection
right away if time permits. See the section â€˜Special care for regressionsâ€™ and
the document Documentation/admin-guide/bug-bisect.rst for details how to
perform one. In case of a successful bisection add the author of the culprit to
the recipients; also CC everyone in the signed-off-by chain, which you find at
the end of its commit message.”…””}”(hjƒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mhj5  hžhubeh}”(h]”Œreport-the-regression”ah ]”h"]”Œreport the regression”ah$]”h&]”uh1hÂhj   hžhhŸh³h M÷ubeh}”(h]”ŒLreference-for-reporting-regressions-within-a-stable-and-longterm-kernel-line”ah ]”h"]”ŒNreference for "reporting regressions within a stable and longterm kernel line"”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h M¹ubhÃ)”}”(hhh]”(hÈ)”}”(hŒMReference for "Reporting issues only occurring in older kernel version lines"”h]”hŒQReference for â€œReporting issues only occurring in older kernel version linesâ€”…””}”(hj¤  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj¡  hžhhŸh³h Mubhé)”}”(hŒÍThis section provides details for the steps you need to take if you could not
reproduce your issue with a mainline kernel, but want to see it fixed in older
version lines (aka stable and longterm kernels).”h]”hŒÍThis section provides details for the steps you need to take if you could not
reproduce your issue with a mainline kernel, but want to see it fixed in older
version lines (aka stable and longterm kernels).”…””}”(hj²  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M!hj¡  hžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒSome fixes are too complex”h]”hŒSome fixes are too complex”…””}”(hjÃ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÀ  hžhhŸh³h M&ubj™  )”}”(hŒº*Prepare yourself for the possibility that going through the next few steps
might not get the issue solved in older releases: the fix might be too big
or risky to get backported there.*
”h]”hé)”}”(hŒ¹*Prepare yourself for the possibility that going through the next few steps
might not get the issue solved in older releases: the fix might be too big
or risky to get backported there.*”h]”j¾  )”}”(hj×  h]”hŒ·Prepare yourself for the possibility that going through the next few steps
might not get the issue solved in older releases: the fix might be too big
or risky to get backported there.”…””}”(hjÙ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjÕ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M(hjÑ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M(hjÀ  hžhubhé)”}”(hX.  Even small and seemingly obvious code-changes sometimes introduce new and
totally unexpected problems. The maintainers of the stable and longterm kernels
are very aware of that and thus only apply changes to these kernels that are
within rules outlined in Documentation/process/stable-kernel-rules.rst.”h]”hX.  Even small and seemingly obvious code-changes sometimes introduce new and
totally unexpected problems. The maintainers of the stable and longterm kernels
are very aware of that and thus only apply changes to these kernels that are
within rules outlined in Documentation/process/stable-kernel-rules.rst.”…””}”(hjò  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M,hjÀ  hžhubhé)”}”(hXù  Complex or risky changes for example do not qualify and thus only get applied
to mainline. Other fixes are easy to get backported to the newest stable and
longterm kernels, but too risky to integrate into older ones. So be aware the
fix you are hoping for might be one of those that won't be backported to the
version line your care about. In that case you'll have no other choice then to
live with the issue or switch to a newer Linux version, unless you want to
patch the fix into your kernels yourself.”h]”hXý  Complex or risky changes for example do not qualify and thus only get applied
to mainline. Other fixes are easy to get backported to the newest stable and
longterm kernels, but too risky to integrate into older ones. So be aware the
fix you are hoping for might be one of those that wonâ€™t be backported to the
version line your care about. In that case youâ€™ll have no other choice then to
live with the issue or switch to a newer Linux version, unless you want to
patch the fix into your kernels yourself.”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M1hjÀ  hžhubeh}”(h]”Œsome-fixes-are-too-complex”ah ]”h"]”Œsome fixes are too complex”ah$]”h&]”uh1hÂhj¡  hžhhŸh³h M&ubhÃ)”}”(hhh]”(hÈ)”}”(hŒCommon preparations”h]”hŒCommon preparations”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj  hžhhŸh³h M:ubj™  )”}”(hŒv*Perform the first three steps in the section "Reporting issues only
occurring in older kernel version lines" above.*
”h]”hé)”}”(hŒu*Perform the first three steps in the section "Reporting issues only
occurring in older kernel version lines" above.*”h]”j¾  )”}”(hj-  h]”hŒwPerform the first three steps in the section â€œReporting issues only
occurring in older kernel version linesâ€ above.”…””}”(hj/  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj+  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M<hj'  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M<hj  hžhubhé)”}”(hŒoYou need to carry out a few steps already described in another section of this
guide. Those steps will let you:”h]”hŒoYou need to carry out a few steps already described in another section of this
guide. Those steps will let you:”…””}”(hjH  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M?hj  hžhubj™  )”}”(hŒÀ* Check if the kernel developers still maintain the Linux kernel version line
  you care about.

* Search the Linux stable mailing list for exiting reports.

* Check with the latest release.

”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hŒ\Check if the kernel developers still maintain the Linux kernel version line
you care about.
”h]”hé)”}”(hŒ[Check if the kernel developers still maintain the Linux kernel version line
you care about.”h]”hŒ[Check if the kernel developers still maintain the Linux kernel version line
you care about.”…””}”(hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MBhj]  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjZ  ubj¤  )”}”(hŒ:Search the Linux stable mailing list for exiting reports.
”h]”hé)”}”(hŒ9Search the Linux stable mailing list for exiting reports.”h]”hŒ9Search the Linux stable mailing list for exiting reports.”…””}”(hjy  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MEhju  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjZ  ubj¤  )”}”(hŒ Check with the latest release.

”h]”hé)”}”(hŒCheck with the latest release.”h]”hŒCheck with the latest release.”…””}”(hj‘  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MGhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjZ  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h MBhjV  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MBhj  hžhubeh}”(h]”Œcommon-preparations”ah ]”h"]”Œcommon preparations”ah$]”h&]”uh1hÂhj¡  hžhhŸh³h M:ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ6Check code history and search for existing discussions”h]”hŒ6Check code history and search for existing discussions”…””}”(hj¼  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj¹  hžhhŸh³h MKubj™  )”}”(hXö  *Search the Linux kernel version control system for the change that fixed
the issue in mainline, as its commit message might tell you if the fix is
scheduled for backporting already. If you don't find anything that way,
search the appropriate mailing lists for posts that discuss such an issue
or peer-review possible fixes; then check the discussions if the fix was
deemed unsuitable for backporting. If backporting was not considered at
all, join the newest discussion, asking if it's in the cards.*
”h]”hé)”}”(hXõ  *Search the Linux kernel version control system for the change that fixed
the issue in mainline, as its commit message might tell you if the fix is
scheduled for backporting already. If you don't find anything that way,
search the appropriate mailing lists for posts that discuss such an issue
or peer-review possible fixes; then check the discussions if the fix was
deemed unsuitable for backporting. If backporting was not considered at
all, join the newest discussion, asking if it's in the cards.*”h]”j¾  )”}”(hjÐ  h]”hX÷  Search the Linux kernel version control system for the change that fixed
the issue in mainline, as its commit message might tell you if the fix is
scheduled for backporting already. If you donâ€™t find anything that way,
search the appropriate mailing lists for posts that discuss such an issue
or peer-review possible fixes; then check the discussions if the fix was
deemed unsuitable for backporting. If backporting was not considered at
all, join the newest discussion, asking if itâ€™s in the cards.”…””}”(hjÒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hjÎ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MMhjÊ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MMhj¹  hžhubhé)”}”(hŒúIn a lot of cases the issue you deal with will have happened with mainline, but
got fixed there. The commit that fixed it would need to get backported as well
to get the issue solved. That's why you want to search for it or any
discussions abound it.”h]”hŒüIn a lot of cases the issue you deal with will have happened with mainline, but
got fixed there. The commit that fixed it would need to get backported as well
to get the issue solved. Thatâ€™s why you want to search for it or any
discussions abound it.”…””}”(hjë  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MUhj¹  hžhubj™  )”}”(hXa  * First try to find the fix in the Git repository that holds the Linux kernel
  sources. You can do this with the web interfaces `on kernel.org
  <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/>`_
  or its mirror `on GitHub <https://github.com/torvalds/linux>`_; if you have
  a local clone you alternatively can search on the command line with ``git
  log --grep=<pattern>``.

  If you find the fix, look if the commit message near the end contains a
  'stable tag' that looks like this:

         Cc: <stable@vger.kernel.org> # 5.4+

  If that's case the developer marked the fix safe for backporting to version
  line 5.4 and later. Most of the time it's getting applied there within two
  weeks, but sometimes it takes a bit longer.

* If the commit doesn't tell you anything or if you can't find the fix, look
  again for discussions about the issue. Search the net with your favorite
  internet search engine as well as the archives for the `Linux kernel
  developers mailing list <https://lore.kernel.org/lkml/>`_. Also read the
  section `Locate kernel area that causes the issue` above and follow the
  instructions to find the subsystem in question: its bug tracker or mailing
  list archive might have the answer you are looking for.

* If you see a proposed fix, search for it in the version control system as
  outlined above, as the commit might tell you if a backport can be expected.

  * Check the discussions for any indicators the fix might be too risky to get
    backported to the version line you care about. If that's the case you have
    to live with the issue or switch to the kernel version line where the fix
    got applied.

  * If the fix doesn't contain a stable tag and backporting was not discussed,
    join the discussion: mention the version where you face the issue and that
    you would like to see it fixed, if suitable.

”h]”jŸ  )”}”(hhh]”(j¤  )”}”(hXã  First try to find the fix in the Git repository that holds the Linux kernel
sources. You can do this with the web interfaces `on kernel.org
<https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/>`_
or its mirror `on GitHub <https://github.com/torvalds/linux>`_; if you have
a local clone you alternatively can search on the command line with ``git
log --grep=<pattern>``.

If you find the fix, look if the commit message near the end contains a
'stable tag' that looks like this:

       Cc: <stable@vger.kernel.org> # 5.4+

If that's case the developer marked the fix safe for backporting to version
line 5.4 and later. Most of the time it's getting applied there within two
weeks, but sometimes it takes a bit longer.
”h]”(hé)”}”(hX†  First try to find the fix in the Git repository that holds the Linux kernel
sources. You can do this with the web interfaces `on kernel.org
<https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/>`_
or its mirror `on GitHub <https://github.com/torvalds/linux>`_; if you have
a local clone you alternatively can search on the command line with ``git
log --grep=<pattern>``.”h]”(hŒ}First try to find the fix in the Git repository that holds the Linux kernel
sources. You can do this with the web interfaces ”…””}”(hj  hžhhŸNh Nubhó)”}”(hŒ[`on kernel.org
<https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/>`_”h]”hŒon kernel.org”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œon kernel.org”j  ŒHhttps://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/”uh1hòhj  ubj  )”}”(hŒK
<https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/>”h]”h}”(h]”Œon-kernel-org”ah ]”h"]”Œon kernel.org”ah$]”h&]”Œrefuri”j  uh1j  j  Khj  ubhŒ
or its mirror ”…””}”(hj  hžhhŸNh Nubhó)”}”(hŒ0`on GitHub <https://github.com/torvalds/linux>`_”h]”hŒ	on GitHub”…””}”(hj.  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ	on GitHub”j  Œ!https://github.com/torvalds/linux”uh1hòhj  ubj  )”}”(hŒ$ <https://github.com/torvalds/linux>”h]”h}”(h]”Œ	on-github”ah ]”h"]”Œ	on github”ah$]”h&]”Œrefuri”j>  uh1j  j  Khj  ubhŒR; if you have
a local clone you alternatively can search on the command line with ”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``git
log --grep=<pattern>``”h]”hŒgit
log --grep=<pattern>”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŽ  hj  ubhŒ.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MZhj   ubhé)”}”(hŒjIf you find the fix, look if the commit message near the end contains a
'stable tag' that looks like this:”h]”hŒnIf you find the fix, look if the commit message near the end contains a
â€˜stable tagâ€™ that looks like this:”…””}”(hjh  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mahj   ubj™  )”}”(hŒ$Cc: <stable@vger.kernel.org> # 5.4+
”h]”hé)”}”(hŒ#Cc: <stable@vger.kernel.org> # 5.4+”h]”(hŒCc: <”…””}”(hjz  hžhhŸNh Nubhó)”}”(hŒstable@vger.kernel.org”h]”hŒstable@vger.kernel.org”…””}”(hj‚  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:stable@vger.kernel.org”uh1hòhjz  ubhŒ> # 5.4+”…””}”(hjz  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mdhjv  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h Mdhj   ubhé)”}”(hŒÂIf that's case the developer marked the fix safe for backporting to version
line 5.4 and later. Most of the time it's getting applied there within two
weeks, but sometimes it takes a bit longer.”h]”hŒÆIf thatâ€™s case the developer marked the fix safe for backporting to version
line 5.4 and later. Most of the time itâ€™s getting applied there within two
weeks, but sometimes it takes a bit longer.”…””}”(hj¢  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mfhj   ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjý  ubj¤  )”}”(hXí  If the commit doesn't tell you anything or if you can't find the fix, look
again for discussions about the issue. Search the net with your favorite
internet search engine as well as the archives for the `Linux kernel
developers mailing list <https://lore.kernel.org/lkml/>`_. Also read the
section `Locate kernel area that causes the issue` above and follow the
instructions to find the subsystem in question: its bug tracker or mailing
list archive might have the answer you are looking for.
”h]”hé)”}”(hXì  If the commit doesn't tell you anything or if you can't find the fix, look
again for discussions about the issue. Search the net with your favorite
internet search engine as well as the archives for the `Linux kernel
developers mailing list <https://lore.kernel.org/lkml/>`_. Also read the
section `Locate kernel area that causes the issue` above and follow the
instructions to find the subsystem in question: its bug tracker or mailing
list archive might have the answer you are looking for.”h]”(hŒÏIf the commit doesnâ€™t tell you anything or if you canâ€™t find the fix, look
again for discussions about the issue. Search the net with your favorite
internet search engine as well as the archives for the ”…””}”(hjº  hžhhŸNh Nubhó)”}”(hŒG`Linux kernel
developers mailing list <https://lore.kernel.org/lkml/>`_”h]”hŒ$Linux kernel
developers mailing list”…””}”(hjÂ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ$Linux kernel developers mailing list”j  Œhttps://lore.kernel.org/lkml/”uh1hòhjº  ubj  )”}”(hŒ  <https://lore.kernel.org/lkml/>”h]”h}”(h]”Œ$linux-kernel-developers-mailing-list”ah ]”h"]”Œ$linux kernel developers mailing list”ah$]”h&]”Œrefuri”jÒ  uh1j  j  Khjº  ubhŒ. Also read the
section ”…””}”(hjº  hžhhŸNh NubhŒtitle_reference”“”)”}”(hŒ*`Locate kernel area that causes the issue`”h]”hŒ(Locate kernel area that causes the issue”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jä  hjº  ubhŒ˜ above and follow the
instructions to find the subsystem in question: its bug tracker or mailing
list archive might have the answer you are looking for.”…””}”(hjº  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mjhj¶  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjý  ubj¤  )”}”(hXW  If you see a proposed fix, search for it in the version control system as
outlined above, as the commit might tell you if a backport can be expected.

* Check the discussions for any indicators the fix might be too risky to get
  backported to the version line you care about. If that's the case you have
  to live with the issue or switch to the kernel version line where the fix
  got applied.

* If the fix doesn't contain a stable tag and backporting was not discussed,
  join the discussion: mention the version where you face the issue and that
  you would like to see it fixed, if suitable.

”h]”(hé)”}”(hŒ•If you see a proposed fix, search for it in the version control system as
outlined above, as the commit might tell you if a backport can be expected.”h]”hŒ•If you see a proposed fix, search for it in the version control system as
outlined above, as the commit might tell you if a backport can be expected.”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mrhj   ubjŸ  )”}”(hhh]”(j¤  )”}”(hŒíCheck the discussions for any indicators the fix might be too risky to get
backported to the version line you care about. If that's the case you have
to live with the issue or switch to the kernel version line where the fix
got applied.
”h]”hé)”}”(hŒìCheck the discussions for any indicators the fix might be too risky to get
backported to the version line you care about. If that's the case you have
to live with the issue or switch to the kernel version line where the fix
got applied.”h]”hŒîCheck the discussions for any indicators the fix might be too risky to get
backported to the version line you care about. If thatâ€™s the case you have
to live with the issue or switch to the kernel version line where the fix
got applied.”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Muhj   ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubj¤  )”}”(hŒÄIf the fix doesn't contain a stable tag and backporting was not discussed,
join the discussion: mention the version where you face the issue and that
you would like to see it fixed, if suitable.

”h]”hé)”}”(hŒÂIf the fix doesn't contain a stable tag and backporting was not discussed,
join the discussion: mention the version where you face the issue and that
you would like to see it fixed, if suitable.”h]”hŒÄIf the fix doesnâ€™t contain a stable tag and backporting was not discussed,
join the discussion: mention the version where you face the issue and that
you would like to see it fixed, if suitable.”…””}”(hj5   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Mzhj1   ubah}”(h]”h ]”h"]”h$]”h&]”uh1j£  hj   ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h Muhj   ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j£  hjý  ubeh}”(h]”h ]”h"]”h$]”h&]”jÕ  jÖ  uh1jž  hŸh³h MZhjù  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h MZhj¹  hžhubeh}”(h]”Œ6check-code-history-and-search-for-existing-discussions”ah ]”h"]”Œ6check code history and search for existing discussions”ah$]”h&]”uh1hÂhj¡  hžhhŸh³h MKubhÃ)”}”(hhh]”(hÈ)”}”(hŒAsk for advice”h]”hŒAsk for advice”…””}”(hjl   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhji   hžhhŸh³h M€ubj™  )”}”(hŒù*One of the former steps should lead to a solution. If that doesn't work
out, ask the maintainers for the subsystem that seems to be causing the
issue for advice; CC the mailing list for the particular subsystem as well
as the stable mailing list.*
”h]”hé)”}”(hŒø*One of the former steps should lead to a solution. If that doesn't work
out, ask the maintainers for the subsystem that seems to be causing the
issue for advice; CC the mailing list for the particular subsystem as well
as the stable mailing list.*”h]”j¾  )”}”(hj€   h]”hŒøOne of the former steps should lead to a solution. If that doesnâ€™t work
out, ask the maintainers for the subsystem that seems to be causing the
issue for advice; CC the mailing list for the particular subsystem as well
as the stable mailing list.”…””}”(hj‚   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hj~   ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M‚hjz   ubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hŸh³h M‚hji   hžhubhé)”}”(hX:  If the previous three steps didn't get you closer to a solution there is only
one option left: ask for advice. Do that in a mail you sent to the maintainers
for the subsystem where the issue seems to have its roots; CC the mailing list
for the subsystem as well as the stable mailing list (stable@vger.kernel.org).”h]”(hX$  If the previous three steps didnâ€™t get you closer to a solution there is only
one option left: ask for advice. Do that in a mail you sent to the maintainers
for the subsystem where the issue seems to have its roots; CC the mailing list
for the subsystem as well as the stable mailing list (”…””}”(hj›   hžhhŸNh Nubhó)”}”(hŒstable@vger.kernel.org”h]”hŒstable@vger.kernel.org”…””}”(hj£   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:stable@vger.kernel.org”uh1hòhj›   ubhŒ).”…””}”(hj›   hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M‡hji   hžhubeh}”(h]”Œask-for-advice”ah ]”h"]”Œask for advice”ah$]”h&]”uh1hÂhj¡  hžhhŸh³h M€ubeh}”(h]”ŒKreference-for-reporting-issues-only-occurring-in-older-kernel-version-lines”ah ]”h"]”ŒMreference for "reporting issues only occurring in older kernel version lines"”ah$]”h&]”uh1hÂhj¨  hžhhŸh³h Mubeh}”(h]”Œ<reference-section-reporting-issues-to-the-kernel-maintainers”ah ]”h"]”Œ=reference section: reporting issues to the kernel maintainers”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KëubhÃ)”}”(hhh]”(hÈ)”}”(hŒMWhy some issues won't get any reaction or remain unfixed after being reported”h]”hŒOWhy some issues wonâ€™t get any reaction or remain unfixed after being reported”…””}”(hjØ   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÕ   hžhhŸh³h MŽubhé)”}”(hXÁ  When reporting a problem to the Linux developers, be aware only 'issues of high
priority' (regressions, security issues, severe problems) are definitely going
to get resolved. The maintainers or if all else fails Linus Torvalds himself
will make sure of that. They and the other kernel developers will fix a lot of
other issues as well. But be aware that sometimes they can't or won't help; and
sometimes there isn't even anyone to send a report to.”h]”hXË  When reporting a problem to the Linux developers, be aware only â€˜issues of high
priorityâ€™ (regressions, security issues, severe problems) are definitely going
to get resolved. The maintainers or if all else fails Linus Torvalds himself
will make sure of that. They and the other kernel developers will fix a lot of
other issues as well. But be aware that sometimes they canâ€™t or wonâ€™t help; and
sometimes there isnâ€™t even anyone to send a report to.”…””}”(hjæ   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MhjÕ   hžhubhé)”}”(hX  This is best explained with kernel developers that contribute to the Linux
kernel in their spare time. Quite a few of the drivers in the kernel were
written by such programmers, often because they simply wanted to make their
hardware usable on their favorite operating system.”h]”hX  This is best explained with kernel developers that contribute to the Linux
kernel in their spare time. Quite a few of the drivers in the kernel were
written by such programmers, often because they simply wanted to make their
hardware usable on their favorite operating system.”…””}”(hjô   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M—hjÕ   hžhubhé)”}”(hŒ˜These programmers most of the time will happily fix problems other people
report. But nobody can force them to do, as they are contributing voluntarily.”h]”hŒ˜These programmers most of the time will happily fix problems other people
report. But nobody can force them to do, as they are contributing voluntarily.”…””}”(hj!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MœhjÕ   hžhubhé)”}”(hX  Then there are situations where such developers really want to fix an issue,
but can't: sometimes they lack hardware programming documentation to do so.
This often happens when the publicly available docs are superficial or the
driver was written with the help of reverse engineering.”h]”hX  Then there are situations where such developers really want to fix an issue,
but canâ€™t: sometimes they lack hardware programming documentation to do so.
This often happens when the publicly available docs are superficial or the
driver was written with the help of reverse engineering.”…””}”(hj!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MŸhjÕ   hžhubhé)”}”(hXŽ  Sooner or later spare time developers will also stop caring for the driver.
Maybe their test hardware broke, got replaced by something more fancy, or is so
old that it's something you don't find much outside of computer museums
anymore. Sometimes developer stops caring for their code and Linux at all, as
something different in their life became way more important. In some cases
nobody is willing to take over the job as maintainer â€“ and nobody can be forced
to, as contributing to the Linux kernel is done on a voluntary basis. Abandoned
drivers nevertheless remain in the kernel: they are still useful for people and
removing would be a regression.”h]”hX’  Sooner or later spare time developers will also stop caring for the driver.
Maybe their test hardware broke, got replaced by something more fancy, or is so
old that itâ€™s something you donâ€™t find much outside of computer museums
anymore. Sometimes developer stops caring for their code and Linux at all, as
something different in their life became way more important. In some cases
nobody is willing to take over the job as maintainer â€“ and nobody can be forced
to, as contributing to the Linux kernel is done on a voluntary basis. Abandoned
drivers nevertheless remain in the kernel: they are still useful for people and
removing would be a regression.”…””}”(hj!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M¤hjÕ   hžhubhé)”}”(hX  The situation is not that different with developers that are paid for their
work on the Linux kernel. Those contribute most changes these days. But their
employers sooner or later also stop caring for their code or make its
programmer focus on other things. Hardware vendors for example earn their money
mainly by selling new hardware; quite a few of them hence are not investing
much time and energy in maintaining a Linux kernel driver for something they
stopped selling years ago. Enterprise Linux distributors often care for a
longer time period, but in new versions often leave support for old and rare
hardware aside to limit the scope. Often spare time contributors take over once
a company orphans some code, but as mentioned above: sooner or later they will
leave the code behind, too.”h]”hX  The situation is not that different with developers that are paid for their
work on the Linux kernel. Those contribute most changes these days. But their
employers sooner or later also stop caring for their code or make its
programmer focus on other things. Hardware vendors for example earn their money
mainly by selling new hardware; quite a few of them hence are not investing
much time and energy in maintaining a Linux kernel driver for something they
stopped selling years ago. Enterprise Linux distributors often care for a
longer time period, but in new versions often leave support for old and rare
hardware aside to limit the scope. Often spare time contributors take over once
a company orphans some code, but as mentioned above: sooner or later they will
leave the code behind, too.”…””}”(hj,!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h M®hjÕ   hžhubhé)”}”(hXÿ  Priorities are another reason why some issues are not fixed, as maintainers
quite often are forced to set those, as time to work on Linux is limited.
That's true for spare time or the time employers grant their developers to
spend on maintenance work on the upstream kernel. Sometimes maintainers also
get overwhelmed with reports, even if a driver is working nearly perfectly. To
not get completely stuck, the programmer thus might have no other choice than
to prioritize issue reports and reject some of them.”h]”hX  Priorities are another reason why some issues are not fixed, as maintainers
quite often are forced to set those, as time to work on Linux is limited.
Thatâ€™s true for spare time or the time employers grant their developers to
spend on maintenance work on the upstream kernel. Sometimes maintainers also
get overwhelmed with reports, even if a driver is working nearly perfectly. To
not get completely stuck, the programmer thus might have no other choice than
to prioritize issue reports and reject some of them.”…””}”(hj:!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MºhjÕ   hžhubhé)”}”(hŒ“But don't worry too much about all of this, a lot of drivers have active
maintainers who are quite interested in fixing as many issues as possible.”h]”hŒ•But donâ€™t worry too much about all of this, a lot of drivers have active
maintainers who are quite interested in fixing as many issues as possible.”…””}”(hjH!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÂhjÕ   hžhubeh}”(h]”ŒMwhy-some-issues-won-t-get-any-reaction-or-remain-unfixed-after-being-reported”ah ]”h"]”ŒMwhy some issues won't get any reaction or remain unfixed after being reported”ah$]”h&]”uh1hÂhhÄhžhhŸh³h MŽubhÃ)”}”(hhh]”(hÈ)”}”(hŒClosing words”h]”hŒClosing words”…””}”(hja!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj^!  hžhhŸh³h MÇubhé)”}”(hXr  Compared with other Free/Libre & Open Source Software it's hard to report
issues to the Linux kernel developers: the length and complexity of this
document and the implications between the lines illustrate that. But that's how
it is for now. The main author of this text hopes documenting the state of the
art will lay some groundwork to improve the situation over time.”h]”hXv  Compared with other Free/Libre & Open Source Software itâ€™s hard to report
issues to the Linux kernel developers: the length and complexity of this
document and the implications between the lines illustrate that. But thatâ€™s how
it is for now. The main author of this text hopes documenting the state of the
art will lay some groundwork to improve the situation over time.”…””}”(hjo!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h MÉhj^!  hžhubh¢)”}”(hŒend-of-content”h]”hŒend-of-content”…””}”hj}!  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1h¡hj^!  hžhhŸh³h MÑubh¢)”}”(hXæ  This document is maintained by Thorsten Leemhuis <linux@leemhuis.info>. If
you spot a typo or small mistake, feel free to let him know directly and
he'll fix it. You are free to do the same in a mostly informal way if you
want to contribute changes to the text, but for copyright reasons please CC
linux-doc@vger.kernel.org and "sign-off" your contribution as
Documentation/process/submitting-patches.rst outlines in the section "Sign
your work - the Developer's Certificate of Origin".”h]”hXæ  This document is maintained by Thorsten Leemhuis <linux@leemhuis.info>. If
you spot a typo or small mistake, feel free to let him know directly and
he'll fix it. You are free to do the same in a mostly informal way if you
want to contribute changes to the text, but for copyright reasons please CC
linux-doc@vger.kernel.org and "sign-off" your contribution as
Documentation/process/submitting-patches.rst outlines in the section "Sign
your work - the Developer's Certificate of Origin".”…””}”hj‹!  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1h¡hj^!  hžhhŸh³h MÙubh¢)”}”(hX`  This text is available under GPL-2.0+ or CC-BY-4.0, as stated at the top
of the file. If you want to distribute this text under CC-BY-4.0 only,
please use "The Linux kernel developers" for author attribution and link
this as source:
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/admin-guide/reporting-issues.rst”h]”hX`  This text is available under GPL-2.0+ or CC-BY-4.0, as stated at the top
of the file. If you want to distribute this text under CC-BY-4.0 only,
please use "The Linux kernel developers" for author attribution and link
this as source:
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/admin-guide/reporting-issues.rst”…””}”hj™!  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1h¡hj^!  hžhhŸh³h Mßubh¢)”}”(hX  Note: Only the content of this RST file as found in the Linux kernel sources
is available under CC-BY-4.0, as versions of this text that were processed
(for example by the kernel's build system) might contain content taken from
files which use a more restrictive license.”h]”hX  Note: Only the content of this RST file as found in the Linux kernel sources
is available under CC-BY-4.0, as versions of this text that were processed
(for example by the kernel's build system) might contain content taken from
files which use a more restrictive license.”…””}”hj§!  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1h¡hj^!  hžhhŸh³h Mäubeh}”(h]”Œclosing-words”ah ]”h"]”Œclosing words”ah$]”h&]”uh1hÂhhÄhžhhŸh³h MÇubeh}”(h]”Œreporting-issues”ah ]”h"]”Œreporting issues”ah$]”h&]”uh1hÂhhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÇNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jè!  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jÂ!  j¿!  jh  je  j  j  j4  j1  jV  jS  jù  jö  j¥  j¢  jã  jà  jõ  jò  j0  j-  j  jš  jÒ   jÏ   j2  j/  jT  jQ  jv  js  j  j  jÙ  jÖ  jz  jw  jÆ  jÃ  jK	  jH	  j0
  j-
  jx
  ju
  jÎ
  jË
  Œcheck 'taint' flag”Nj:  j7  j‚  j  jÐ  jÍ  jû  jø  jÈ  jÅ  jÊ  jÇ  j'  j$  jk  jh  j  jŠ  j  j  j`  j]  jþ  jû  j³  j°  j  j  jz  jw  jž  j›  jô  jñ  jÖ  jÓ  jh  je  j‘  jŽ  j¢  jŸ  jü  jù  jÉ  jÆ  jq  jn  j‰  j†  jý  jú  jñ  jî  jl  ji  jõ  jò  jž  j›  jr  jo  jÜ  jÙ  jÉ  jÆ  j2  j/  j–  j“  jÊ   jÇ   j  j  j¶  j³  jf   jc   j&  j#  jH  jE  jÜ  jÙ  jÂ   j¿   j[!  jX!  jº!  j·!  uŒ	nametypes”}”(jÂ!  ‰jh  ‰j  ˆj4  ˆjV  ˆjù  ˆj¥  ‰jã  ˆjõ  ‰j0  ˆj  ‰jÒ   ‰j2  ˆjT  ˆjv  ˆj  ‰jÙ  ‰jz  ˆjÆ  ˆjK	  ‰j0
  ‰jx
  ‰jÎ
  ‰j,"  ‰j:  ‰j‚  ‰jÐ  ‰jû  ‰jÈ  ‰jÊ  ‰j'  ˆjk  ˆj  ˆj  ‰j`  ˆjþ  ‰j³  ˆj  ‰jz  ˆjž  ‰jô  ‰jÖ  ‰jh  ‰j‘  ‰j¢  ‰jü  ‰jÉ  ˆjq  ‰j‰  ‰jý  ‰jñ  ‰jl  ‰jõ  ‰jž  ‰jr  ‰jÜ  ‰jÉ  ˆj2  ‰j–  ‰jÊ   ‰j  ‰j¶  ‰jf   ‰j&  ˆjH  ˆjÜ  ˆjÂ   ‰j[!  ‰jº!  ‰uh}”(j¿!  hÄje  h×j  j  j1  j+  jS  jM  jÔ  jÎ  jö  jð  j¢  jk  jà  jÚ  jò  jä  j-  j'  jg  ja  jš  jø  jÏ   j¨  j/  j)  jQ  jK  js  jm  j  j¤  jÖ  j  jw  jq  jÃ  j½  jH	  jÜ  j-
  jN	  ju
  j3
  jË
  j{
  jÓ  jÑ
  j7  jÙ  j  j=  jÍ  j…  jø  jÓ  jÅ  jþ  jÇ  jÓ  j$  j  jh  jb  jŠ  j„  j  jÍ  j]  jW  jû  j€  j°  jª  j  j  jw  jq  jµ  j¯  jT  j  j›  jY  jñ  j¡  jÓ  j÷  je  jÙ  jŽ  jk  jŸ  j¹  jb  j\  jù  j¥  jÆ  jÀ  jn  jÿ  j†  jt  jú  j”  jî  jâ  ji  jô  jò  jo  j›  j   jo  j  jÙ  ju  jÆ  jÀ  j/  jß  j“  j5  jÇ   j¡  j  jÀ  j³  j  jc   j¹  j#  j  jE  j?  jÙ  jÓ  j¿   ji   jX!  jÕ   j·!  j^!  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”jö!  Ks…”R”Œparse_messages”]”(hŒsystem_message”“”)”}”(hhh]”hé)”}”(hŒ'Duplicate explicit target name: "lkml".”h]”hŒ+Duplicate explicit target name: â€œlkmlâ€.”…””}”(hjP"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjM"  ubah}”(h]”h ]”h"]”h$]”h&]”jÔ  aŒlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jK"  hh×hžhhŸh³h KubjL"  )”}”(hhh]”hé)”}”(hŒ<Duplicate explicit target name: "linux stable mailing list".”h]”hŒ@Duplicate explicit target name: â€œlinux stable mailing listâ€.”…””}”(hjl"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhji"  ubah}”(h]”h ]”h"]”h$]”h&]”jg  aŒlevel”KŒtype”jf"  Œsource”h³Œline”Kuh1jK"  hjD  ubjL"  )”}”(hhh]”hé)”}”(hŒ-Duplicate explicit target name: "kernel.org".”h]”hŒ1Duplicate explicit target name: â€œkernel.orgâ€.”…””}”(hj‡"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhj„"  ubah}”(h]”h ]”h"]”h$]”h&]”jµ  aŒlevel”KŒtype”jf"  Œsource”h³Œline”Kuh1jK"  hj  hžhhŸh³h MwubjL"  )”}”(hhh]”hé)”}”(hŒ5Duplicate implicit target name: "check 'taint' flag".”h]”hŒ=Duplicate implicit target name: â€œcheck â€˜taintâ€™ flagâ€.”…””}”(hj¢"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjŸ"  ubah}”(h]”h ]”h"]”h$]”h&]”jT  aŒlevel”KŒtype”jf"  Œsource”h³Œline”Muh1jK"  hj  hžhhŸh³h MubjL"  )”}”(hhh]”hé)”}”(hŒ6Duplicate explicit target name: "bugzilla.kernel.org".”h]”hŒ:Duplicate explicit target name: â€œbugzilla.kernel.orgâ€.”…””}”(hj½"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjº"  ubah}”(h]”h ]”h"]”h$]”h&]”jb  aŒlevel”KŒtype”jf"  Œsource”h³Œline”Kuh1jK"  hj?  ubeŒtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.