DebuggingKernelProblems

Differences between revisions 15 and 16
Revision 15 as of 2007-03-03 11:32:36
Size: 4508
Editor: clj46-234
Comment: lspci needs sudo, typos
Revision 16 as of 2007-03-06 16:03:32
Size: 4864
Editor: cF5A6BF51
Comment: templated
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== Initial reports == ||<tablestyle="float:right; font-size: 0.9em; width:30%; background:#F1F1ED; background-image: url('https://librarian.launchpad.net/1812570/bugsquad.png'); background-repeat: no-repeat; background-position: 98% 0.5ex; margin: 0 0 1em 1em; padding: 0.5em;">'''Contents'''[[BR]][[TableOfContents]]||
Line 3: Line 3:
All initial bug reports should be left in the '''Unconfirmed''' and '''Undecided''' states until the report is satisfactory for debugging. = Bug report workflow =

 * All initial bug reports should be left in the '''Unconfirmed''' and '''Undecided''' states until the report is satisfactory for debugging.
 * Once a bug contains all the relevant information, it can be assigned to the appropriate team, and moved to the '''Confirmed''' state. If information is requested from the submitter, the bug should be left in '''Needs Info''' state.
 * Bugs that have been assigned are then handled by the appropriate team, or someone acting on behalf of that team. Once a member of the team begins work on a bug, it should be changed to the '''In Progress''' state.

= Debugging =
Line 26: Line 32:
== Bug Classification == = Bug Classification =
Line 34: Line 40:
=== Subsystem specific === == Subsystem specific ==
Line 53: Line 59:
=== Architecture specific === == Architecture specific ==
Line 64: Line 70:
------
'''Also see:'''
Line 65: Line 73:
== Final ==

Once a bug contains all the relevant information, it can be assigned to the appropriate team, and moved to the '''Confirmed''' state. If information is requested from the submitter, the bug should be left in '''Needs Info''' state.

Bugs that have been assigned are then handled by the appropriate team, or someone acting on behalf of that team. Once a member of the team begins work on a bug, it should be changed to the '''In Progress''' state.
 * DebuggingProcedures

Bug report workflow

  • All initial bug reports should be left in the Unconfirmed and Undecided states until the report is satisfactory for debugging.

  • Once a bug contains all the relevant information, it can be assigned to the appropriate team, and moved to the Confirmed state. If information is requested from the submitter, the bug should be left in Needs Info state.

  • Bugs that have been assigned are then handled by the appropriate team, or someone acting on behalf of that team. Once a member of the team begins work on a bug, it should be changed to the In Progress state.

Debugging

All bug reports should contain at least the output of these commands:

  • uname -a > uname-a.log

  • dmesg > dmesg.log

  • sudo lspci -vvnn > lspci-vvnn.log

For clarification the arguments passed to lspci are v v for very verbose output and v v n n for very verbose output including numerical data. The > symbol instructs that the output of the commannd be saved in the stated .log file.

These three files should be attached to the bug report (not pasted into comments, as it makes things harder to read, and formatting is completely broken).

Dmesg output may be annotated to show before and after the problem occurred (e.g. if a device is attached and does not work, annotate where in dmesg the device was attached so that messages related to the attachment can be isolated).

Also, dmesg output should be done as early as possible after bootup to avoid extraneous output.

The submitter should provide as much information as possible in regards to whether the bug exists in previous versions of Ubuntu. Where possible, test the latest development version as well. Whether or not the bug affects other Linux distributions, or stock kernels is also of importance.

If the bug report involves a crash, it is hoped that a kernel backtrace is available. If the machine does not completely lockup from the crash, the backtrace should be available in the dmesg output. If the crash completely locks the system, then the user should be asked to supply a digital photo of the screen to capture the crash.

Sometimes crashes occur in X, and so terminal access is not available (to capture the kernel backtrace). When this occurs, the user should try to recreate the crash at the console (Alt+F1). If this is not possible, then annotate the bug as such.

Bug Classification

For the most part, kernel bugs should be assigned to the ubuntu-kernel-team. In many cases, however, a specific team is aimed at handling bugs in different sections of the kernel. These teams fall into two categories: Subsection specific teams, and Architecture specific teams.

When assigning to one of these teams, use the following guidelines. Remember that if a bug falls into more than one category (e.g. an IDE bug on powerpc), it should be assigned to the most relevant subsystem team (as opposed to the architecture team). Subsystem teams always take precedence on initial bug assignment.

Certain bug classifications below require additional info from the bug submitter. Be sure to obtain this information before moving the bug out of Needs Info status.

Subsystem specific

  • ubuntu-kernel-team: Drop through when bugs do not fall into a specific category.
  • ubuntu-server: Any bugs dealing with the -server kernels that are not reproducible on a standard kernel.
  • ubuntu-audio: Any bugs dealing with the ALSA sound system.
  • ubuntu-kernel-acpi: Any bugs dealing with ACPI, including hotkey features, cpu throttling, thermal detection, battery states, etc.
  • ubuntu-kernel-network: Any bugs dealing with network drivers (ethernet, wireless, etc) or the network stack (IP, ICMP, UDP, etc).
  • ubuntu-kernel-usb: All bugs related to USB and USB devices (except in cases such as storage, video, sound and networking, where the bug clearly has to do with that team as opposed to a general USB issue).
  • ubuntu-kernel-video: All bugs related to framebuffers, VGA, DRM, video acceleration, Video capture, etc.
  • ubuntu-kernel-storage: IDE, SATA, SCSI, RAID, etc.

Architecture specific

Architecure specific teams. Bugs should be assigned to these teams when it directly relates to the system in question. E.g. when the kernel wont boot on such a system.

  • ubuntu-amd64
  • sparc-port
  • ubuntu-hppa
  • ubuntu-ia64
  • ubuntu-x86
  • ubuntu-powerpc


Also see:


["CategoryKernel"] ["CategoryBugSquad"]

DebuggingKernelProblems (last edited 2009-06-14 14:23:36 by ip98-169-125-170)