From 6cbaeed351109f8e63b548579e93842def71f7f9 Mon Sep 17 00:00:00 2001
From: Sebastian Bachmann <me@free-minds.net>
Date: Thu, 7 Aug 2014 21:59:05 +0200
Subject: [PATCH] adding notes for gdb

---
 gdb/index.mdwn | 110 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 110 insertions(+)
 create mode 100644 gdb/index.mdwn

diff --git a/gdb/index.mdwn b/gdb/index.mdwn
new file mode 100644
index 0000000..741668c
--- /dev/null
+++ b/gdb/index.mdwn
@@ -0,0 +1,110 @@
+Debugging with gdb
+==================
+
+Our Demo Code:
+
+    #include <stdio.h>
+    #include <stdint.h>
+
+    int g_myvar = 42;
+    #define MYCONST 99
+
+    void sideeffect(void){
+        g_myvar += MYCONST;
+    }
+
+    uint8_t myfunction(uint8_t x){
+        return x+42;
+    }
+
+    int main(void){
+
+        uint8_t foo = 23;
+        uint8_t bla = 23;
+
+        uint8_t x = foo + bla;
+        uint8_t i;
+
+        uint8_t y = myfunction(bla);
+
+        uint8_t * verybad = 0;
+        
+        printf("%d\n", foo);
+        printf("%d\n", y);
+        // use this printf to cause a segfault
+        // printf("%d\n", *verybad);
+
+        for(i = 0; i < 10; ++i){
+            y = myfunction(y);
+            sideeffect();
+        }
+        printf("%d\n", y);
+
+
+        return 0;
+    }
+
+Resources
+---------
+
+* Vorlesungsfolien Betriebssysteme UE auf der TU Wien:
+[Debugging](http://ti.tuwien.ac.at/cps/teaching/courses/osue/slides/ss14_entwicklung_in_c.pdf)
+* Online Tutorial auf [beej.us](http://beej.us/guide/bggdb/)
+
+Basics
+------
+
+* gcc -g test.c -o test
+* gdb test
+* gdb test core
+* gdb --args
+
+Commands in GDB
+---------------
+
+* break
+* continue
+* next
+* info breakpoints
+* watch
+* list
+* print
+* bt full
+* catch signal
+* run
+* break .. if ...
+* delete
+* disable
+* enable
+* step
+* stepi
+* target record-full
+* reverse-next
+* set
+* quit
+
+Show preprocessor macros
+------------------------
+
+See [Thread on
+SO](http://stackoverflow.com/questions/2934006/how-do-i-print-a-defined-constant-in-gdb)
+
+    gcc -g3 test.c
+    gdb a.out
+    (gdb) info macro MYCONST
+    (gdb) macro expand MYCONST
+
+Fun with print
+--------------
+
+* print myfunction(y+23/7)/23.0
+* print printf("%d\n", 23 > 42 ? 111 : 222) 
+
+
+Enable history
+--------------
+
+create a file .gdbinit in ~ and put this line in:
+
+    set history save on
+
-- 
2.39.2