summaryrefslogtreecommitdiff
path: root/doc/devel/debug.dox
diff options
context:
space:
mode:
Diffstat (limited to 'doc/devel/debug.dox')
-rw-r--r--doc/devel/debug.dox22
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/devel/debug.dox b/doc/devel/debug.dox
new file mode 100644
index 00000000..43ba1a15
--- /dev/null
+++ b/doc/devel/debug.dox
@@ -0,0 +1,22 @@
+/**
+ *
+
+ @page debug Debugging
+ This page enumerates various techniques useful for debugging ISC DHCP software.
+
+
+ @section debugTips Debugging Tips & Tricks
+
+ISC DHCP code is somewhat convoluted. Due to extensive macros use, it is often
+difficult to even find whole function, much less to understand what they
+actually do. One way to find such a macro-defined function is to compile the
+code with debugging symbols (-g), load the binary into gdb and set a breakpoint
+for such a function. gdb will print out exact place in the code where the
+function is defined. Presumably one will find a macro at that specific location.
+For example to find where \ref lease_reference function is defined do:
+
+@verbatim
+gdb
+file dhcpd
+b lease_reference
+@endverbatim