View source for Debugging

== Reporting bugs ==

Steps to do when you think you found a bug:

* verify the bug exists in the [[Git|latest version]]
* report it at [https://github.com/znc/znc/issues Github]

== Tracing crash bugs ==

Configure your [[ZNC]] version with --enable-debug.

<pre>
./configure --enable-debug --enable-other-things-you-may-want
make
make install
</pre>

Then you can run [[ZNC]] under gdb:

<pre>
set logging /tmp/znc.gdb.log
set logging on
gdb ./znc
handle SIGPIPE nostop
run -D
</pre>

If znc is already running, you can attach gdb to the already-running instance (where pid is znc's process id):

<pre>
set logging /tmp/znc.gdb.log
set logging on
gdb ./znc
attach pid
handle SIGPIPE nostop
cont
</pre>

Now you use [[ZNC]] as you would always do and try to make it crash. Once it crashed, gdb will show you something like this:

<pre>
Program received signal SIGSEGV, Segmentation fault.
</pre>

Now we can get the useful info. This info, together with an explanation how the bug happened are then very useful to the developers.

<pre>
bt full
</pre>

If you had logging file set and logging enabled, you can find the bt full and everything else in /tmp/znc.gdb.log. You might want to copy it somewhere safe and remove things before the backtrace.

=== Why use --enable-debug? ===

With this flag <code>bt full</code> shows much more info, which is needed to understand why the crash had happened.
If you're interested in details, search the Web for "debug symbols" or just try with and without.

[[Category:ZNC]]