1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org">
<link rel="STYLESHEET" type="text/css" href="etherape.css">
<title>EtherApe: Reporting Bugs</title>
<h2>Known bugs</h2>
<p>For a list of known issues and bugs, point your browser to
<a href=
"http://sourceforge.net/bugs/?group_id=2712">http://sourceforge.net/bugs/?group_id=2712</a>
<h2>How to report a bug</h2>
<p>Having users is great, not only because it is the purpose of
creating this program in the first place, but because they stress
your program in many different ways and help you make it more
robust.
<p>If you do encounter a problem with this program, plase write a
bug report at <a href=
"http://sourceforge.net/bugs/?group_id=2712">http://sourceforge.net/bugs/?group_id=2712</a>
<p>When you write your report, I'd be thankful if you could
follow these guidelines, in order of importance.
<ol>
<li>Make sure that the most current version does have the bug.
Not only does this mean to download the latest version, but
also making sure that you are _running_ the latest version. Go
to src and run as ./etherape
<li>Things to include:
<ul>
<li>Operating system and distribution
<li>EtherApe version (etherape --version, or check the
about box)
<li>pcap version (and package version as well)
<li>gtk and gnome libs version (package version as well)
<li>If possible, a backtrace (See below)
<li>Please leave an email address or log in before posting
your bug, so that I can later get in contact with you.
</ul>
<li>Read this link first <a href=
"http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">http://www.chiark.greenend.org.uk/~sgtatham/bugs.html</a>
It is really informative, and it will be really useful not only
for etherape.
</ol>
<p>Please understand that I _love_ to receive bug reports,
because that means that I will be improving the program, but the
more info you provide, the faster I'll be able to solve the
problem.
<h2>How to provide a backtrace</h2>
<p>In cases in which etherape is crashing (not when it produces
bad results), it is most useful if I can see what was the program
doing when it crashed.
<p>It is actually simple, you just need to type four
instructions.
<pre>
# export GNOME_DISABLE_CRASH_DIALOG=1
# gdb etherape
(gdb) run [options your were using]
(gdb) backtrace
</pre>
<p>Here's an example of what it would look like. When you write
your report, you only need to send me from the "Program received
signal SIGSEGV" bit onwards.
<pre>
argos:~/etherape/src# gdb ./etherape
GNU gdb 19990928
Copyright 1998 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "i686-pc-linux-gnu"...
(gdb) run
Starting program: /home/toledo/etherape/src/etherape
DEBUG: pcap_fd: 6
DEBUG: Creating node: ARGOS. Number of nodes 1
DEBUG: Creating node: NEBAJ. Number of nodes 2
DEBUG: Creating node: 0.0.0.0. Number of nodes 3
DEBUG: Creating canvas_node: 0.0.0.0. Number of nodes 1
DEBUG: Creating canvas_node: NEBAJ. Number of nodes 2
DEBUG: Creating canvas_node: ARGOS. Number of nodes 3
Program received signal SIGSEGV, Segmentation fault.
0x804f566 in fill_names (node=0x80e12f8, node_id=0x80e1330 "", packet=0x0)
at capture.c:243
243 if (!strcmp (ether_to_str (node_id), get_ether_name
(node_id)) &&
(gdb) backtrace
#0 0x804f566 in fill_names (node=0x80e12f8, node_id=0x80e1330 "",
packet=0x0) at capture.c:243
#1 0x804fb8b in update_packet_list (packets=0x80e1230,
belongs_to=NODE) at capture.c:553
#2 0x804e799 in update_canvas_nodes (node_id=0x80e1330 "",
canvas_node=0x80e2ab0, canvas=0x80d0cb0) at diagram.c:333
#3 0x403f9052 in g_tree_nnodes () from /usr/lib/libglib-1.2.so.0
#4 0x403f903c in g_tree_nnodes () from /usr/lib/libglib-1.2.so.0
#5 0x403f892c in g_tree_traverse () from /usr/lib/libglib-1.2.so.0
#6 0x804ed63 in update_diagram (canvas=0x80d0cb0) at diagram.c:553
#7 0x403edfea in g_main_set_poll_func () from /usr/lib/libglib-1.2.so.0
#8 0x403ed0c9 in g_get_current_time () from /usr/lib/libglib-1.2.so.0
#9 0x403ed6d3 in g_get_current_time () from /usr/lib/libglib-1.2.so.0
#10 0x403ed86c in g_main_run () from /usr/lib/libglib-1.2.so.0
#11 0x401ced97 in gtk_main () from /usr/lib/libgtk-1.2.so.0
#12 0x804e158 in main (argc=1, argv=0xbffffd34) at main.c:184
</pre>
<hr>
<p><i>$Id: bug-reporting.html,v 1.1 2000/03/22 07:21:36 toledo
Exp $</i>
<p><a href="http://sourceforge.net"><img alt="sourceforge" src=
"http://sourceforge.net/sflogo.php?group_id=2712&type=1"
width="88" height="31" border="0"></a>
|
