aboutsummaryrefslogtreecommitdiff
path: root/docs/mozilla_brown_bag_talk.md
diff options
context:
space:
mode:
authorAndy Bonventre <andybons@chromium.org>2015-09-22 17:29:52 -0400
committerMark Mentovai <mark@chromium.org>2015-09-22 17:29:52 -0400
commit0ff15b41edf1dfd50776877edce7cae6e757574f (patch)
treec670617291b3476ab2622d7ea2509d8369db2f0d /docs/mozilla_brown_bag_talk.md
parentLinux ExceptionHandler: don't allocate the CrashContext on the stack (diff)
downloadbreakpad-0ff15b41edf1dfd50776877edce7cae6e757574f.tar.xz
[Docs] add markdown docs (converted from Wiki)
BUG=none R=mark CC=google-breakpad-dev@googlegroups.com Review URL: https://codereview.chromium.org/1357773004 . Patch from Andy Bonventre <andybons@chromium.org>.
Diffstat (limited to 'docs/mozilla_brown_bag_talk.md')
-rw-r--r--docs/mozilla_brown_bag_talk.md84
1 files changed, 84 insertions, 0 deletions
diff --git a/docs/mozilla_brown_bag_talk.md b/docs/mozilla_brown_bag_talk.md
new file mode 100644
index 00000000..8322d244
--- /dev/null
+++ b/docs/mozilla_brown_bag_talk.md
@@ -0,0 +1,84 @@
+# Breakpad Crash Reporting for Mozilla
+
+* January 24, 2007
+ * Links updated February 14, 2007
+* Mozilla HQ
+* Mark Mentovai
+* Brian Ryner
+
+## What is a crash reporter?
+
+* Enables developers to analyze crashes that occur in the wild
+* Produces stack backtraces that help identify how a program failed
+* Offers higher-level data aggregation (topcrashes, MTBF statistics)
+
+## Motivation
+
+* Talkback is proprietary and unmaintained
+* Smaller open-source projects have few options
+* Larger projects need flexibility and scalability
+
+## Design Options
+
+* Stackwalking done on client
+ * Apple CrashReporter
+ * GNOME BugBuddy
+* Client sends memory dump
+ * Talkback
+ * Windows Error Reporting
+ * Breakpad
+
+## Goals
+
+* Provide libraries around which systems can be based
+* Open-source
+* Cross-platform
+ * Mac OS X x86, PowerPC
+ * Linux x86
+ * Windows x86
+* No requirement to distribute symbols
+
+## Client Libraries
+
+* Exception handler installed at application startup
+ * Spawns a separate thread
+* Minidump file written at crash time
+ * Format used by Windows debuggers
+* Separate application invoked to send
+ * HTTP[S](S.md) POST, can include additional parameters
+
+## Symbols
+
+* Cross-platform symbol file format
+* Contents
+ * Function names
+ * Source file names and line numbers
+ * Windows: Frame pointer omission data
+ * Future: parameters and local variables
+* Symbol conversion methods
+
+## Processor
+
+* Examines minidump file and invokes stackwalker
+* Symbol files requested from a SymbolSupplier
+* Produces stack trace
+* Output may be placed where convenient
+
+## Intergation
+
+* Breakpad client present in Gran Paradiso Alpha 1 for Windows
+ * Disabled by default
+ * Enable with `MOZ_AIRBAG`
+* Proof-of-concept collector
+ * http://mavra.perilith.com/~luser/airbag-collector/list.pl
+* Other platforms coming soon
+
+## More Information
+
+* Project home: http://code.google.com/p/google-breakpad/
+* Mailing lists
+ * [google-breakpad-dev@googlegroups.com]
+ (http://groups.google.com/group/google-breakpad-dev/)
+ * [google-breakpad-discuss@googlegroups.com]
+ (http://groups.google.com/group/google-breakpad-discuss/)
+* Ask me (irc.mozilla.org: mento)