Known bugs
For a list of known issues and bugs, point your browser to
[1]http://sourceforge.net/bugs/?group_id=2712
How to report a bug
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.
If you do encounter a problem with this program, plase write a bug
report at [2]http://sourceforge.net/bugs/?group_id=2712
When you write your report, I'd be thankful if you could follow these
guidelines, in order of importance.
1. 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
2. Things to include:
+ Operating system and distribution
+ EtherApe version (etherape --version, or check the about box)
+ pcap version (and package version as well)
+ gtk and gnome libs version (package version as well)
+ If possible, a backtrace (See below)
+ Please leave an email address or log in before posting your
bug, so that I can later get in contact with you.
3. Read this link first
[3]http://www.chiark.greenend.org.uk/~sgtatham/bugs.html It is
really informative, and it will be really useful not only for
etherape.
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.
How to provide a backtrace
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.
It is actually simple, you just need to type four instructions.
# export GNOME_DISABLE_CRASH_DIALOG=1
# gdb etherape
(gdb) run [options your were using]
(gdb) backtrace
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.
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
_________________________________________________________________
$Id: README.bugs,v 1.9 2006/01/14 20:16:13 bchiara Exp $
[4]sourceforge
References
1. http://sourceforge.net/bugs/?group_id=2712
2. http://sourceforge.net/bugs/?group_id=2712
3. http://www.chiark.greenend.org.uk/~sgtatham/bugs.html
4. http://sourceforge.net/
