Reporting bugs
==============


General information
-------------------

When reporting bugs, please specify UdmSearch version and provide us as 
more information about a problem as it possible. Such information as your
platform and OS details, database version, database statistics like number
of URLs in database or probably count of records in different tables would
be very helpful to find and fix possible bugs. Please, send bug reports to 
our discussion mail list <udmsearch@search.udm.net>. Do not send reports to 
developer list or to personal authors addresses!


Core dump reports
-----------------

If indexer or search.cgi die during their work and produce core, 
it would be very helpful to send us gdb (The GNU Debugger) output. 
To do this, please make the following steps. Imagine, that your 
binary is "indexer" and core file name is "indexer.core"
(or may be just "core" on some platforms).

Run GNU Debugger with a executable as a first argument and with a 
core file as a second:

>gdb indexer indexer.core

Some information about the place where crash was happen will appear:


Core was generated by `indexer'.
Program terminated with signal 8, Floating point exception.
Reading symbols from /usr/lib/libc.so.3...done.
Reading symbols from /usr/libexec/ld-elf.so.1...done.
#0  0x80483f3 in main () at indexer.c:4
4               printf("%d",0/0);


Then type "backtrace" command:

(gdb) backtrace
#0  0x80483f3 in main () at a.c:4
#1  0x804837d in _start ()


Send us both first and second outputs or just screenshot of
gdb session.

