Fedora

Personal tools

Log in

Views

View source

From FedoraProject

for Features/Apport

Jump to: navigation, search

You do not have permission to edit this page, for the following reason:

You are not allowed to execute the action you have requested.

You can view and copy the source of this page:

= Apport for Fedora =


THIS PLAN IS OBSOLETE: See [[Features/CrashHandling]]

== Summary ==

Apport is a set of tools from the Ubuntu project that can:

* Gather information about crashed processes
* Hooks into the kernel using /proc/sys/kernel/core_pattern to catch coredumps
* Does not require extra libraries like bug-buddy, [http://code.google.com/p/google-breakpad/ breakpad] , etc.
* Also has hooks for python tracebacks
* Supports per-package hooks, so (e.g.) crash reports for Xorg can include xorg.conf and Xorg.0.log
* Report that information to a crash database
* Retrace the coredump, adding proper debuginfo symbols
* Notice duplicate crashes and point users to the existing bug report

More information is available on the Ubuntu wiki: [https://wiki.ubuntu.com/Apport Apport]  and [https://wiki.ubuntu.com/CrashReporting CrashReporting] 

== Owner ==
* Name: WillWoods

== Current status ==
* Targeted release:
* Last modified: [[Date(2007-07-17T16:06:04Z)]  
* Percent complete: 75%

== Usage cases / rationale ==
* See summary

== Benefit to Fedora ==
* See summary

== Scope ==

== Testing ==

Much of the apport code contains unit tests, but here are some short recipes for testing out apport.

=== Testing the client code (crash handler, reporting GUI) ===

1. Install <code>apport</code> and <code>apport-gtk</code>
<code>apport-qt</code> requires PyQt4, which is not yet available in Fedora.
1. Start the apport service: <code>sudo /sbin/service apport start</code>
1. Enable core dumps by setting the core dump size limit to something reasonable: <code>ulimit -c 100000</code>
This will not be necessary once the kernel is patched to improve core handling.
1. Cause a program to crash, e.g. <code>sleep 5 & sleep 1; kill -SEGV %1</code>
Note that this will not work with most GNOME apps unless you start them with --disable-crash-dialog.
''Isn't there a env var that disables bug-buddy? We should set this when apport is enabled..''
(<code>GNOME_DISABLE_CRASH_DIALOG=1</code>, the <code>GTK_MODULES</code> version will need more care, if >1 module is listed, BastienNocera)
1. Wait a moment for the crash report to appear in <code>/var/crash</code>
1. Edit <code>/etc/apport/crashdb</code> and set <code>default = 'debug'</code>
This won't be needed in apport-0.91-0.ww2 and later.
1. Run <code>/usr/share/apport/apport-gtk</code>
apportd should be in the next apport package - it will do this for you.
1. Wait while the GUI gathers packaging information.
1. Examine and (optionally) send the crash report.

=== Testing the server code (apport-retrace, tg-crashdb) ===

TODO.

== Dependencies ==

1. <code>apport-qt</code> requires PyQt4

== Details ==

{| border="1"
|-
|Merging Fedora-specific client code upstream||Complete
|-
|Kernel patch for improved handling of core dumps to pipes||In progress - patch [http://lkml.org/lkml/2007/7/19/521 submitted upstream]
|-
|Implement CrashDB for Fedora||NEEDINFO - we have a mostly-complete Turbogears crashdb implementation and RH-bugzilla based implementation (see [https://partner-bugzilla.redhat.com/show_bug.cgi?id=248561 this example bug] ). Unsure which to use.
|-
|Crash notifier||apportd.c starts with the user's X session and uses inotify to watch /var/crash
|-
|PyQt4 for apport-qt||Package under review [https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=190189 here] , but qt-based interface is not required for release.
|-
|Packaging/Review||In progress- packages [http://wwoods.fedorapeople.org/apport/ here]
|}

== Optional ==

== User Experience ==

== Contingency plan ==

None needed - this is a new feature and can be safely deferred if it is not ready.

== Documentation ==

Information on installing & enabling apport (and reasons why you would want to do this) would be a good idea.

== Release Notes ==

None needed - this should not be installed or enabled by default in F8 final.

== Comments and Discussion ==

See [[Talk:Features/Apport]]

----

[[Category:FeaturePageIncomplete]]

Return to Features/Apport.

Retrieved from "https://fedoraproject.org/wiki/Features/Apport"