-
Notifications
You must be signed in to change notification settings - Fork 493
/
README.BUGS
128 lines (73 loc) · 3.87 KB
/
README.BUGS
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
==============================================================================
==============================================================================
@@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@
@@ @@@ @@@ @@ @@ @@ @@ @@ @@ @@ @@
@@@@@@ @@@ @@@ @@@@@@ @@@@@@ @@ @@@@@@@ @@@@@@
@@ @@@ @@@ @@ @@ @@ @@ @@ @@ @@
@@@@@@@ @@@ @@@ @@@@@@@ @@ @@@ @@@@@@@ @@ @@ @@ NG
Copyright 2001-2013 The Ettercap Dev Team
==============================================================================
==============================================================================
"Debugging is twice as hard as writing the code in the first place.
Therefore, if you write the code as cleverly as possible, you are,
by definition, not smart enough to debug it." - Brian W. Kernighan
If you found a new bug please report it to
https://github.com/Ettercap/ettercap/issues or by sending an email to
<ettercap-users@lists.ettercap-project.org>
==============================================================================
C O M P I L E T I M E B U G S
==============================================================================
If you are not able to compile ettercap on your system, please make a bug
report. In order to help you fix the problem we need the following
information:
1) a description of your operating system (including any patch level)
# uname -a > os.log
2) the cmake cache file
# cat CMakeCache.txt
3) the entire output from 'make'
# make 1> make_output 2> make_error
4) make a tarball with all the needed infos
# tar pczf compile_error.tar.gz os.log \
CMakeCache.txt \
make_output \
make_error
==============================================================================
R U N T I M E B U G S
==============================================================================
If the bug is critical and results in a segmentation fault follow these steps
to make a detailed bug report in order to help us to find the bug and fix it.
1) recompile the program in debug mode:
(follow the instructions on README.GIT file in order to pull the repository and build the program in debug mode)
2) force ettercap to not drop privileges to make sure the core is dumped:
# export EC_UID=0
# export EC_GID=0
3) override any limit for coredumps:
# ulimit -c unlimited
4) enable memory checks (if your system supports them), so the program will
abort if some heap corruption is in place:
# export MALLOC_CHECK_=2
5) dump to a file the traffic that causes the crash (we need it to reproduce
the situation)
# ./src/ettercap -w offending_packets.pcap ... --your-options-here ...
6) analyze the core with gdb and send us the backtrace:
# gdb ettercap core
(gdb) bt
(gdb) quit
copy and paste the output of the gdb command 'bt' in a file (backtrace.log)
6a) if you don't get a core (for any reason), you can run ettercap within gdb:
# gdb ettercap
(gdb) r your_parameters_here
when it catches the segfault, you can get the backtrace with the 'bt'
command
7) collect useful information about your network:
# ifconfig -a > network.txt
# arp -an >> network.txt
# netstat -rn >> network.txt
8) tar all the information together with the log generated by ettercap:
# tar zcvf bugreport.tar.gz ettercap-*-debug.log \
offending_packets.pcap \
network.txt \
backtrace.log
9) mail the tarball to us with a brief description of the bug.
=============================================================================
vim:ts=3:expandtab