DebuggingProcedures
|
Size: 2277
Comment: Categorised page and made all links human-readable
|
Size: 4465
Comment: 1) Expanded Kernel Include to include missing sections that would be helpful. 2) RM'ed dup links. 3) Rename = Debugging Tools = as overlaps w/ kernel tools heading.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| ||<tablestyle="float:right; font-size: 0.9em; background:#F1F1ED;margin: 0 0 1em 1em;" style="padding:2.0em;">'''Contents'''[[BR]][[TableOfContents]]|| | ||<tablestyle="float:right; font-size: 0.9em; background:#F1F1ED;margin: 0 0 1em 1em;" style="padding:2.0em;"><<TableOfContents>>|| |
| Line 7: | Line 7: |
| Some common procedures for debugging problems, which deserve to be documented once, and properly, rather than hastily repeated again and again in the process of handling bug reports: | If you want to add information to this page on how to debug a package, use this [[DebuggingTemplate|template]]. |
| Line 9: | Line 9: |
| * '''[:Bugs/FindRightPackage:Find the Right Package]''' * [:DebuggingProgramCrash:Debugging program crashes] * [:DebuggingSystemCrash:Debugging system crashes] |
As part of triaging bug reports about specific packages or subsystems, bug triagers and developers have been writing debugging procedures for them. These include information about how to troubleshoot issues, gather the proper log files and common bug reports. If you find one missing, and if no one else can help, e-mail the Bug Squad! You can find them at [[ubuntu-bugsquad@lists.ubuntu.com]], or in #ubuntu-bugs on [[irc.ubuntu.com]]. |
| Line 13: | Line 11: |
| == Desktop Applications == | * '''[[Bugs/FindRightPackage|Find the Right Package]]''' * [[DebuggingProgramCrash|Debugging program crashes]] * [[DebuggingSystemCrash|Debugging system crashes]] * '''[[Apport#Per-package%20Apport%20Hooks|Using Apport-collect]]''' |
| Line 15: | Line 16: |
| * [:DebuggingFirefox:Firefox Web Browser] * [:DebuggingEvolution:Evolution Mail] * [:DebuggingGNOME:GNOME applications] * [:DebuggingGnash:Gnash Flash plugin] * [:DebuggingNetworkManager:Network Manager] * [:DebuggingTelepathy:Telepathy framework] |
= Desktop Applications = |
| Line 22: | Line 18: |
| == Server Applications == | * [[DebuggingAyatana|Ayatana project]] * [[Chromium/Debugging|Chromium]] * [[DebuggingEmacs|Emacs]] * [[DebuggingEmpathy|Empathy]] * [[DebuggingFirefox|Firefox Web Browser]] * [[DebuggingGnash|Gnash Flash plugin]] * [[DebuggingGNOME|GNOME applications - Applets, Banshee, Cheese, Evince, Evolution, Gconf, Nautilus, Network Manager, Power Manager, Screensaver (screen locking), System Tools]] * [[DebuggingGwibber|Gwibber]] * [[DebuggingJava|Java]] * [[DebuggingKDE|KDE applications]] * [[https://wiki.ubuntu.com/LibreOfficeBugWrangling|LibreOffice]] * [[DebuggingModemmanager|Modem Manager]] * [[DebuggingTelepathy|Telepathy framework]] * [[UbuntuOne#BugTriage|Ubuntuone]] * [[Unity/FilingBugs|Unity]] |
| Line 24: | Line 34: |
| * [:DebuggingApache2:Apache 2] * [:DebuggingLTSP:LTSP] |
= Server Applications = |
| Line 27: | Line 36: |
| == Hardware == | * [[DebuggingApache2|Apache 2]] * [[DebuggingLTSP|LTSP]] * [[DebuggingKVM|KVM]] * [[DebuggingMySQL|MySQL]] * [[DebuggingOpenldap|Open LDAP]] * [[DebuggingSamba|Samba]] |
| Line 29: | Line 43: |
| * [:DebuggingHardwareDetection:Hardware detection] * [:DebuggingUdev:Udev (device hotplugging)] * [:DebuggingIRQProblems:IRQ problems] * [:DebuggingACPI:ACPI (power-saving etc.)] * [:DebuggingSoundProblems:Sound problems] * [:DebuggingPrintingProblems:Printing problems] * [:DebuggingMouseDetection:Mouse detection] * [:DebuggingTouchpadDetection:Touchpad detection] * [:LaptopTestingTeam/HotkeyResearch:Non-working Hotkeys] |
= Application Debugging Tools = * [[Backtrace]] * [[MemoryTest|Memory test]] * [[Strace]] * [[Valgrind]] = Hardware = * [[DebuggingBluetooth|Bluetooth]] * [[DebuggingHardwareDetection|Hardware detection]] * [[DebuggingKeyboardDetection|Keyboard detection]] * [[DebuggingMouseDetection|Mouse detection]] * [[DebuggingPrintingProblems|Printing problems]] * [[DebuggingTouchpadDetection|Touchpad detection]] * [[Hotkeys/Troubleshooting|Troubleshooting Hotkeys]] * [[DebuggingUdev|Udev (device hotplugging)]] |
| Line 41: | Line 63: |
| * [:DebuggingIDEIssues:IDE issues] * [:DebuggingLvm:LVM (Logical Volume Management)] * [:DebuggingRemovableDevices:Removable devices] * [:DebuggingUSBStorage:USB storage devices] |
* [[DebuggingIDEIssues|IDE issues]] * [[DebuggingLvm|LVM (Logical Volume Management)]] * [[DebuggingRemovableDevices|Removable devices]] |
| Line 46: | Line 67: |
| == Kernel == | = Kernel = |
| Line 48: | Line 69: |
| * [:DebuggingKernelOops:Kernel Oops] * [:DebuggingKernelSuspend:Kernel suspend] * [:KernelTeamBugPolicies:Kernel Team bug policies] |
* [[KernelTeam/KernelTeamBugPolicies|Kernel Team bug policies]] |
| Line 52: | Line 71: |
| == Debugging Tools == | ## please add any new debugging pages to the page https://wiki.ubuntu.com/Kernel/Debugging in the Debugging Scenarios section and they will appear here and all other appropriate places together. <<Include(Kernel/Debugging, , from="== Introduction ==$", to="== Links ==$")>> |
| Line 54: | Line 74: |
| * [:MemoryTest:Memory test] * ["Backtrace"] * ["Strace"] * ["Valgrind"] |
= Installation and Upgrades = |
| Line 59: | Line 76: |
| == Miscellaneous == | * [[DebuggingInstallationIssues|Installing and updating packages (General issues)]] * [[DebuggingCasper|Live CD booting problems (casper)]] * [[DebuggingUbiquity|Live CD installation problems (ubiquity)]] * [[DebuggingUpdateManager|Upgrading releases and updating packages (update-manager)]] |
| Line 61: | Line 81: |
| * [:DebuggingUbiquity:Live CD installation problems (ubiquity)] * [:DebuggingUpdateManager:Upgrading releases (update-manager)] * [:X/Debugging:Debugging X (display problems etc.)] * [:DebuggingNonEnglishErrors:Debugging non-English errors] |
= Miscellaneous = * [[DebuggingApparmor|Debugging Apparmor profile errors]] * [[DebuggingCompiz|Debugging Compiz problems]] * [[DebuggingDBus|Debugging D-Bus problems]] * [[DebuggingHal|Debugging HAL problems]] * [[https://wiki.ubuntu.com/Bugs/Triaging/libmtp|Debugging libmtp, the MTP (Media Transfer Protocol) library]] * [[DebuggingNonEnglishErrors|Debugging non-English errors]] * [[DebuggingPlymouth|Debugging Plymouth Ubuntu's Bootsplash]] * [[DebuggingSecurity|Debugging security issues]] * [[DebuggingUsplash|Debugging usplash, the pretty logo you see while booting up or shutting down (usplash)*obsolete]] * [[X/Debugging|Debugging X (display problems etc.)]] = Template = We've created a template file for debugging procedure pages if you want to write a new one. The template provides a similar look and feel for all pages and ensures that they cover common subjects. * [[DebuggingTemplate|The debugging template file]] |
| Line 67: | Line 101: |
| CategoryBugSquad | CategoryBugSquad CategoryDebugging |
Note: If you wish to report a bug, see ReportingBugs and if you wish to help with bugs, see HelpingWithBugs
If you want to add information to this page on how to debug a package, use this template.
As part of triaging bug reports about specific packages or subsystems, bug triagers and developers have been writing debugging procedures for them. These include information about how to troubleshoot issues, gather the proper log files and common bug reports. If you find one missing, and if no one else can help, e-mail the Bug Squad! You can find them at ubuntu-bugsquad@lists.ubuntu.com, or in #ubuntu-bugs on irc.ubuntu.com.
Desktop Applications
Server Applications
Application Debugging Tools
Hardware
Storage devices
Kernel
To determine which guides are relevant to your problem see the symptom based debugging guide.
Kernel Debugging Scenarios
Backlight -- How to debug issues related to backlight brightness control
Hibernate/Resume -- Help debugging kernel hibernate/resume problems
High Temperatures -- How to debug thermal issues and/or fan related problems
Hotkeys -- How to debug non-working hotkeys
Kernel Boot -- debugging Kernel boot issues
Kernel Oops -- Analyzing Kernel Oopses
Suspend/Resume -- Help debugging kernel suspend/resume problems
Trace scheduling while atomic -- How to gather a trace to help debug "scheduling while atomic" bugs
Update Errors -- Debugging common errors seen when updating/upgrading
Kernel Debugging Guides
ACPI -- debugging ACPI (Advanced Configuration and Power Interface)
BIOS -- Debugging BIOS issues on Ubuntu (DSDT, Reboot, Suspend/Resume)
IRQ -- debugging interrupt related issues
Sound -- Basic troubleshooting tips for debugging sound problems
System Crash -- Tips for gather information regarding system crashes and lockups
Kernel Debugging Tools/Information
Firmware -- All about firmware and how to debug firmware loading issues
Kernel Debugging Tricks -- Some kernel debugging tricks and tips
linux-crashdump -- How to use linux-crashdump to capture a kernel oops/panic
Mainline Kernel Builds -- How to use mainline kernels for debugging
Netconsole -- Configuring console over network using netconsole
Systemtap -- Introduction to Systemtap for reboot free, dynamic instrumentation
Ubuntu Kernel Team PPA -- Instructions on how to use the Ubuntu Kernel Team's PPA, as well as using a specific kernel developer's PPA
Ubuntu to mainline kernel mapping -- A table of Ubuntu releases and which mainline version they are based on, including the current release pocket assignments
USB -- How to debug USB problems
View early printk via USB -- How to view early printk messages using USB debug
Voodoo -- Q&A for strange symptoms and how to debug
Kernel Debugging with QEMU/KVM -- How to debug a kernel running inside a QEMU/KVM instance
Installation and Upgrades
Miscellaneous
Template
We've created a template file for debugging procedure pages if you want to write a new one. The template provides a similar look and feel for all pages and ensures that they cover common subjects.
DebuggingProcedures (last edited 2019-07-19 13:37:58 by till-kamppeter)