Added SILC Thread Queue API
[crypto.git] / apps / irssi / docs / crash.txt
1 How to submit a good bug report?
2
3 Send them to bug reporting system in http://bugs.irssi.org/
4
5 First you should give the following information:
6  - irssi version, if CVS (or devel. tarball) then which day?
7  - operating system / distribution and it's version
8  - when did it crash? did you do something? can you reproduce the crash?
9
10 Getting backtrace of the crash also helps a lot, especially if irssi crashes
11 randomly. If after crash you see text:
12
13  "segmentation fault (core dumped)"
14
15 It writes a file named "core" or "irssi.core" depending on your OS to
16 directory where you started irssi. If it doesn't print the "(core dumped)"
17 or you can't find the core file, you'll have to raise the limit for max.
18 core file size before running irssi. To do this, say:
19
20  ulimit -c unlimited
21
22 So, if you have the core file and GNU debugger (gdb), you can get the
23 backtrace with:
24
25  gdb irssi core
26  bt
27
28 Paste all the lines starting from line having #0 at the beginning.
29
30 Here's an example session:
31
32 [cras@hurina] ~/cvs/m/irssi/src/fe-text$ gdb ./irssi core
33
34 GNU gdb 5.0
35 Copyright 2000 Free Software Foundation, Inc.
36 GDB is free software, covered by the GNU General Public License, and you are
37 welcome to change it and/or distribute copies of it under certain conditions.
38 Type "show copying" to see the conditions.
39 There is absolutely no warranty for GDB.  Type "show warranty" for details.
40 This GDB was configured as "i686-pc-linux-gnu"...
41
42 Core was generated by ./irssi'.
43 Program terminated with signal 11, Segmentation fault.
44 #0  0x805e949 in view_scroll (view=0x816cfb5, lines=0x816cfd9, 
45     subline=0x816cfdd, scrollcount=-11, draw_nonclean=1)
46     at textbuffer-view.c:528
47 528                             realcount += view->bottom_subline;
48
49 (gdb) bt
50
51 #0  0x805e949 in view_scroll (view=0x816cfb5, lines=0x816cfd9, 
52     subline=0x816cfdd, scrollcount=-11, draw_nonclean=1)
53     at textbuffer-view.c:528
54 #1  0x805ecb4 in textbuffer_view_scroll (view=0x816cfb5, lines=-11)
55     at textbuffer-view.c:669
56 #2  0x8058387 in gui_window_scroll (window=0x816cead, lines=-11)
57     at gui-windows.c:128
58 #3  0x8056b64 in window_prev_page () at gui-readline.c:109
59 #4  0x8057047 in key_scroll_backward () at gui-readline.c:334
60 ...
61 (gdb)