Contrib: Add example GDB backtrace generator script and a small readme on how to use it - Note: DO read the README file before using.

(Allows for semi-automated crashreporting on GDB/*nix-based platforms with proper information included).

--HG--
branch : trunk

1 files changed, 13 insertions, 0 deletions

diff --git a/contrib/debugger/README b/contrib/debugger/README
new file mode 100644
index 00000000000..827607d6ec9
--- /dev/null
+++ b/contrib/debugger/README
@@ -0,0 +1,13 @@
+The included crashreport.gdb allows for semiautomated hunting of 
+crashes. The crashlog-file will be named backtrace.log and contains all 
+the commands required to partially automate a crashlog-creation with the 
+proper information.
+
+Usage: gdb -x crashreport.gdb <executable file>
+
+For creating an efficient backtrace, use -DCMAKE_BUILD_TYPE=Debug as a 
+parameter to CMake during configuration - this increases the filesize, 
+but includes all the needed information for a decent and efficient 
+crashreport.
+
+-- Good luck, and happy crashhunting.