path: root/README
diff options
authorJukka Rissanen <>2013-03-13 08:33:27 (GMT)
committerPatrik Flykt <>2013-03-14 19:07:46 (GMT)
commit46ca83850e0083aceec845639f3a2085c6cc6a0a (patch)
tree9edf9e1e6df3329290f8d9cbb3551244f211d8e1 /README
parent9917659fbfba8fcdb98b042ecc1d1ec541f75894 (diff)
doc: Information about activating debugging in ConnMan
Diffstat (limited to 'README')
1 files changed, 43 insertions, 0 deletions
diff --git a/README b/README
index 0f86bc1..bfb246a 100644
--- a/README
+++ b/README
@@ -204,6 +204,49 @@ For a working system, certain configuration options need to be enabled:
in order to enable the dbus access.
+Activating debugging
+One can activate debugging prints in ConnMan using -d command line option.
+If the -d option has no parameters, then debugging is activated for all
+source code files. If the -d option has parameters, they tell which source
+code files have debugging activated. One can use wild cards in file names.
+ -d Activate all normal debug prints
+ -d src/service.c This prints debugging info from src/service.c
+ file only
+ -d src/network.c:src/ipconfig.c
+ This activates debug prints in src/network.c
+ and src/ipconfig.c files.
+ -d 'src/n*.c' This would activate debug print from all the C source
+ files starting with letter 'n' in src directory.
+ Note the quotation marks around option, that is to
+ prevent shell expansion.
+ -d '*/n*.c:*/i*.c' Activate debug prints for all C source files starting
+ with letters 'n' or 'i' in any sub-directory.
+Some components of ConnMan have environment variable activated debug prints.
+If the environment variable is set, then corresponding component will print
+some extra debugging information.
+Following environment variables can be used:
+ CONNMAN_DHCP_DEBUG DHCPv4 related debug information
+ CONNMAN_DHCPV6_DEBUG DHCPv6 related debug information
+ CONNMAN_IPTABLES_DEBUG Extra information when iptables is used
+ CONNMAN_RESOLV_DEBUG Name resolver debug prints. These debug prints
+ are used when ConnMan resolves host names for
+ its own use.
+ Note that the DNS proxy debug prints do not
+ use this environment variable. For that, one
+ can use "-d src/dnsproxy.c" command line option.
+ CONNMAN_SUPPLICANT_DEBUG Debugging prints for communication between
+ connmand and wpa_supplicant processes.
+ CONNMAN_WEB_DEBUG Debug information when ConnMan does Internet
+ connectivity check in Wispr and 6to4 components.
+ CONNMAN_WEB_DEBUG=1 src/connmand -n
Kernel configuration