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/
