TODO prettify, more detailed instructions

Contents 1 How to report bugs and performance problems 1.1 Needed information 1.2 External tools 1.2.1 Tracing 1.2.2 Debugging 1.2.3 gdb 1.3 Profiling 1.3.1 gprof 1.3.2 oprofile

How to report bugs and performance problems

Bugtracker : http://savannah.nongnu.org/bugs/?group=mldonkey

If unsure first ask at forum (irc).

Needed information

mldonkey commands :

 sysinfo
 set verbosity verb
 set verbosity all

logs /var/log/mldonkey/mlnet.log or mlnet.log near the binary (FIXME sysinfo should output path to the log!)

External tools

Tracing

strace, ktrace, dstat

Debugging

 ./configure --enable-debug

make and ensure that resulting binary is not stripped (make opt is ok, release.* targets are not ok).

gdb

Attach and thread apply all bt, During attach gdb should print messages about loading symbols. If symbols cannot be found it means that either binary was built without debugging or was stripped afterwards (refer to the previous chapter).

Profiling

gprof

 ./configure --enabe-profile --enable-debug

Ensure native code (FIXME sysinfo should show this too)

 make mlnet.static

run, wait, stop core normally (kill), send gmon.out and binary

oprofile