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