docs: add notes
[netsniff-ng-old.git] / Documentation / RelNotes / Notes-0.5.7
blob5c3a62e8285c64da786b7428c1234deb642ddc6a
1 netsniff-ng, release 0.5.7:
2 ///////////////////////////
4 Date: 29.06.2012
5 Obsoletes: 0.5.6 and previous
7 We are pleased to announce the immediate and free availability of netsniff-ng
8 in version 0.5.7! This is a major release with lots of bug fixes and new
9 features. If you are using netsniff-ng 0.5.6, we highly recommend upgrading!
11 This time, only three months passed since the release of 0.5.6. We've ruled out
12 a number of bugs and added new features such as raw 802.11 support for capturing
13 and traffic generation! We've added new protocol dissectors and improved current
14 ones, trafgen now has a better configuration language, and many more things.
16 The to-do list for future releases is still long and full of features and
17 improvements for our current set of tools, so, again, note that the version
18 number 0.5.7 indicates that this is not a mature product yet. If you like to
19 join us in hacking on netsniff-ng, we'd be very happy! On the mid-term future,
20 we're planning to add full IPv6 support, an additional high-level filtering
21 language to bpfc, further protocol dissectors, protocol-specific functions to
22 trafgen's configuration language and Cisco-like CLIs for netsniff-ng and
23 trafgen for use as a hw/sw applicance.
25 Please find documentation about the individual tools in the Documentation/
26 folder. The netsniff-ng toolkit is purely non-profit and provided in the hope,
27 that it is found useful.
29 Obtaining the sources:
31 - Via Git:
32   - git clone git://github.com/gnumaniacs/netsniff-ng.git
33   - git checkout 0.5.7
34 - Via HTTP:
35   - wget http://pub.netsniff-ng.org/netsniff-ng/netsniff-ng-0.5.7.tar.gz
37 Highlights:
39 - Raw 802.11 support in netsniff-ng for capturing and replaying, and in trafgen
40   for packet creation. Both tools support the zero-copy interfaces for 802.11,
41   too.
43 - New netsniff-ng dissectors for ICMPv6, IGMP, VLAN Q-in-Q, MPLS.
45 - Major improvmenets in trafgen's packet configuration language, thanks to flex
46   and bison.
48 - Timing statistics in netsniff-ng and trafgen.
50 - Hardware-timestamp support for netsniff-ng's RX_RING.
52 - Many bug fixes such as in pcap I/O methods, packet dissectors and so on.
54 - Many internal refactorings and code cleanups.
56 Summary:
58 - 3 months timespan
59 - Git commits excluding merges since 0.5.6:
61    261  Daniel Borkmann
62     96  Markus Amend
63     34  Christoph Jaeger
64      5  Emmanuel Roullit
65      1  Stefan Seering
67   Plus distribution maintenance by:
69        Kartik Mistry
70        Jiří Skála
71        Can Celasun
72        Michael Weber
73        Corrado Franco
74        Pascal Bleser
75        Guillaume Rousse
76        Michael Prokop
77        Ronald W. Henderson
78        Fabian Affolter
80 Reporting bugs:
82 - E-mail to <bugs@netsniff-ng.org>
83 - Online bug tracker: http://bugs.netsniff-ng.org/
85 Detailed file changes:
87  .gitignore                                         |    3 +-
88  .mailmap                                           |    6 +-
89  AUTHORS                                            |    2 +
90  Documentation/Curvetun                             |   25 +-
91  Documentation/Maintainer                           |  103 +
92  Documentation/Mirrors                              |   12 +
93  Documentation/Notes-0.5.6                          |  451 ---
94  Documentation/RelNotes/Notes-0.5.6                 |  448 +++
95  INSTALL                                            |    6 +-
96  MAINTAINER                                         |  100 -
97  MIRRORS                                            |    9 -
98  PROJECTS                                           |  204 --
99  README                                             |    5 +-
100  THANKS                                             |   55 -
101  VERSION                                            |    2 +-
102  contrib/html/faq.html                              |    5 +-
103  contrib/html/index.html                            |   75 +-
104  .../Sending_and_receiving_zero-copy_networking.png |  Bin 6787 -> 0 bytes
105  .../Sending_and_receiving_zero-copy_networking.txt | 3527 --------------------
106  contrib/html/pub/netsniff-ng/MD5SUMS               |    5 -
107  contrib/html/pub/netsniff-ng/SHA256SUMS            |    5 -
108  .../pub/netsniff-ng/netsniff-ng-0.5.3.0.tar.gz     |  Bin 21469 -> 0 bytes
109  .../pub/netsniff-ng/netsniff-ng-0.5.4.0.tar.gz     |  Bin 137012 -> 0 bytes
110  .../pub/netsniff-ng/netsniff-ng-0.5.4.1.tar.gz     |  Bin 137477 -> 0 bytes
111  .../pub/netsniff-ng/netsniff-ng-0.5.4.2.tar.gz     |  Bin 141979 -> 0 bytes
112  .../pub/netsniff-ng/netsniff-ng-0.5.5.0.tar.gz     |  Bin 265313 -> 0 bytes
113  src/CMakeLists.txt                                 |    5 +-
114  src/ashunt.c                                       |  106 +-
115  src/ashunt/.gitignore                              |    1 -
116  src/ashunt/CMakeLists.txt                          |    4 +-
117  src/aslookup.c                                     |  115 +-
118  src/aslookup.h                                     |    9 +-
119  src/bpf.c                                          |   53 +-
120  src/bpf.h                                          |   25 +-
121  src/bpf_parser.y                                   |   16 +-
122  src/bpfc.c                                         |   14 +-
123  src/bpfc/.gitignore                                |    1 -
124  src/bpfc/CMakeLists.txt                            |    4 +-
125  src/built_in.h                                     |  281 ++-
126  src/cmake/modules/FindBISON.cmake                  |  173 +
127  src/cmake/modules/FindFLEX.cmake                   |  156 +
128  src/cmake/modules/FindLibCLI.cmake                 |   44 +
129  src/cmake/modules/FindLibnl.cmake                  |   27 +
130  src/cpusched.c                                     |  160 -
131  src/cpusched.h                                     |   18 -
132  src/csum.h                                         |    1 -
133  src/ct_client.c                                    |  216 +-
134  src/ct_cpusched.c                                  |  183 +
135  src/ct_cpusched.h                                  |   17 +
136  src/ct_server.c                                    |  468 ++--
137  src/ct_servmgmt.c                                  |  274 ++
138  src/ct_servmgmt.h                                  |   22 +
139  src/ct_usermgmt.c                                  |  773 +++++
140  src/ct_usermgmt.h                                  |   50 +
141  src/curve.c                                        |   63 +-
142  src/curve.h                                        |   12 +
143  src/curvetun.c                                     |  142 +-
144  src/curvetun.h                                     |    1 -
145  src/curvetun/.gitignore                            |    1 -
146  src/curvetun/CMakeLists.txt                        |    9 +-
147  src/die.h                                          |   35 +-
148  src/dissector.c                                    |  109 +-
149  src/dissector.h                                    |   80 +-
150  src/dissector_80211.c                              |   55 +
151  src/dissector_80211.h                              |   44 +
152  src/dissector_eth.c                                |  110 +-
153  src/dissector_eth.h                                |   24 +-
154  src/examples/bpfc/all_traffic.bpf                  |    1 -
155  src/examples/bpfc/arp.bpf                          |    8 +-
156  src/examples/bpfc/atalk.bpf                        |    9 -
157  src/examples/bpfc/broadcast.bpf                    |    6 -
158  src/examples/bpfc/ftp.bpf                          |   15 -
159  src/examples/bpfc/high-level/examples              |    6 +
160  src/examples/bpfc/http.bpf                         |   15 -
161  src/examples/bpfc/icmp.bpf                         |    6 -
162  src/examples/bpfc/icq.bpf                          |   15 -
163  src/examples/bpfc/imap.bpf                         |   17 -
164  src/examples/bpfc/ip_broadcast.bpf                 |    8 -
165  src/examples/bpfc/ip_multicast.bpf                 |    6 -
166  src/examples/bpfc/ipv4.bpf                         |    4 +
167  src/examples/bpfc/ipv4_or_ipv6.bpf                 |    5 +
168  src/examples/bpfc/ipv4_tcp.bpf                     |    6 +
169  src/examples/bpfc/ipv4_tcp_http.bpf                |   13 +
170  src/examples/bpfc/ipv4_tcp_ssh.bpf                 |   13 +
171  src/examples/bpfc/ipv4_udp.bpf                     |    6 +
172  src/examples/bpfc/ipv6.bpf                         |    4 +
173  src/examples/bpfc/multicast.bpf                    |    4 -
174  src/examples/bpfc/not_ip.bpf                       |    5 -
175  src/examples/bpfc/not_ssh.bpf                      |   24 -
176  src/examples/bpfc/opcodes/README                   |   15 +
177  src/examples/bpfc/opcodes/icmpv6.bpf               |   80 +
178  src/examples/bpfc/opcodes/igmp_and_icmpv6.bpf      |   92 +
179  src/examples/bpfc/opcodes/igmp_and_mld.bpf         |   97 +
180  src/examples/bpfc/pop3.bpf                         |   15 -
181  src/examples/bpfc/rarp.bpf                         |    4 -
182  src/examples/bpfc/rsync.bpf                        |   15 -
183  src/examples/bpfc/skype_pre.bpf                    |   13 -
184  src/examples/bpfc/smtp.bpf                         |   15 -
185  src/examples/bpfc/ssh.bpf                          |   15 -
186  src/examples/bpfc/vlan1000.bpf                     |    7 -
187  .../pcap/802.11/Network_Join_Nokia_Mobile.pcap     |  Bin 0 -> 164976 bytes
188  ...Station_Part_and_Join_00004_20100411222129.pcap |  Bin 0 -> 67694 bytes
189  ...Station_Part_and_Join_00005_20100411222137.pcap |  Bin 0 -> 38565 bytes
190  src/examples/pcap/802.1ad/QinQ.pcap                |  Bin 0 -> 184 bytes
191  src/examples/pcap/802.1ad/QinQpacket.pcap          |  Bin 0 -> 78264 bytes
192  src/examples/pcap/icmpv6/icmpv6-mldv2.pcap         |  Bin 0 -> 516 bytes
193  .../pcap/icmpv6/icmpv6-router-discovery.pcap       |  Bin 0 -> 244 bytes
194  src/examples/pcap/icmpv6/icmpv6_diff_msg.pcap      |  Bin 0 -> 5356 bytes
195  src/examples/pcap/icmpv6/icmpv6_type1.pcap         |  Bin 0 -> 754 bytes
196  .../pcap/ipv6_hdr_ext/ipv6_diff_ext_hdr.pcap       |  Bin 0 -> 1850 bytes
197  .../pcap/ipv6_hdr_ext/proto_ipv6_dest_opts.pcap    |  Bin 0 -> 264 bytes
198  .../pcap/ipv6_hdr_ext/proto_ipv6_fragm.pcap        |  Bin 0 -> 112 bytes
199  .../pcap/ipv6_hdr_ext/proto_ipv6_hop_by_hop.pcap   |  Bin 0 -> 236 bytes
200  .../pcap/ipv6_hdr_ext/proto_ipv6_no_nxt_hdr.pcap   |  Bin 0 -> 111 bytes
201  .../pcap/ipv6_hdr_ext/proto_ipv6_routing.pcap      |  Bin 0 -> 159 bytes
202  src/examples/pcap/mpls-basic.pcap                  |  Bin 0 -> 5644 bytes
203  src/examples/pcap/proto_igmp.pcap                  |  Bin 0 -> 168 bytes
204  src/examples/pcap/proto_ip_authentication_hdr.pcap |  Bin 0 -> 2124 bytes
205  src/examples/pcap/proto_ipv6_in_ipv4.pcap          |  Bin 0 -> 2228 bytes
206  src/examples/trafgen/nst_udp_pkt_1472.txf          |   95 +
207  src/examples/trafgen/nst_udp_pkt_18.txf            |   50 +
208  src/examples/trafgen/trafgen.txf                   |  104 +-
209  src/examples/trafgen/trafgen2.txf                  |    6 +-
210  src/flowtop.c                                      |    3 +-
211  src/flowtop/.gitignore                             |    1 -
212  src/flowtop/CMakeLists.txt                         |    6 +-
213  src/ifpps.c                                        |  123 +-
214  src/ifpps/.gitignore                               |    1 -
215  src/ifpps/CMakeLists.txt                           |    3 +-
216  src/mac80211.c                                     |  257 ++
217  src/mac80211.h                                     |   14 +
218  src/netsniff-ng.c                                  |  301 ++-
219  src/netsniff-ng/.gitignore                         |    1 -
220  src/netsniff-ng/CMakeLists.txt                     |   47 +-
221  src/opt_memcpy.c                                   |  302 --
222  src/opt_memcpy.h                                   |   81 -
223  src/oui.c                                          |  102 +
224  src/oui.h                                          |   15 +
225  src/pcap.c                                         |    1 -
226  src/pcap.h                                         |   16 +-
227  src/pcap_mmap.c                                    |  109 +-
228  src/pcap_rw.c                                      |   54 +-
229  src/pcap_sg.c                                      |  175 +-
230  src/pkt_buff.h                                     |  112 +
231  src/proto.h                                        |   35 +
232  src/proto_80211_mac_hdr.c                          |  228 ++
233  src/proto_arp.c                                    |  126 +
234  src/proto_arp.h                                    |  132 -
235  src/proto_esp.h                                    |   67 -
236  src/proto_ethernet.c                               |   83 +
237  src/proto_ethernet.h                               |  100 -
238  src/proto_hex.h                                    |   76 -
239  src/proto_icmp.h                                   |   71 -
240  src/proto_icmpv4.c                                 |   65 +
241  src/proto_icmpv6.c                                 | 1643 +++++++++
242  src/proto_igmp.c                                   |  562 ++++
243  src/proto_ip_authentication_hdr.c                  |   88 +
244  src/proto_ip_authentication_hdr.h                  |   87 -
245  src/proto_ip_esp.c                                 |   55 +
246  src/proto_ipv4.c                                   |  190 ++
247  src/proto_ipv4.h                                   |  128 -
248  src/proto_ipv6.c                                   |  105 +
249  src/proto_ipv6.h                                   |  118 -
250  src/proto_ipv6_dest_opts.c                         |  103 +
251  src/proto_ipv6_dest_opts.h                         |   83 -
252  src/proto_ipv6_fragm.c                             |   72 +
253  src/proto_ipv6_fragm.h                             |   82 -
254  src/proto_ipv6_hop_by_hop.c                        |  102 +
255  src/proto_ipv6_hop_by_hop.h                        |   83 -
256  src/proto_ipv6_in_ipv4.c                           |   27 +
257  src/proto_ipv6_in_ipv4.h                           |   30 -
258  src/proto_ipv6_mobility_hdr.c                      |  312 ++
259  src/proto_ipv6_mobility_hdr.h                      |   87 -
260  src/proto_ipv6_no_nxt_hdr.c                        |   43 +
261  src/proto_ipv6_no_nxt_hdr.h                        |   39 -
262  src/proto_ipv6_routing.c                           |  165 +
263  src/proto_ipv6_routing.h                           |   97 -
264  src/proto_mpls_unicast.c                           |  111 +
265  src/proto_none.c                                   |   86 +
266  src/proto_struct.h                                 |   43 -
267  src/proto_tcp.c                                    |  158 +
268  src/proto_tcp.h                                    |  180 -
269  src/proto_udp.c                                    |   92 +
270  src/proto_udp.h                                    |  110 -
271  src/proto_vlan.c                                   |   64 +
272  src/proto_vlan.h                                   |   81 -
273  src/proto_vlan_q_in_q.c                            |   65 +
274  src/protos.h                                       |   43 +-
275  src/ring.h                                         |  174 +-
276  src/ring_rx.c                                      |   42 +-
277  src/ring_tx.c                                      |   45 +-
278  src/ring_tx.h                                      |    6 +-
279  src/servmgmt.c                                     |  285 --
280  src/servmgmt.h                                     |   24 -
281  src/stun.c                                         |   75 +-
282  src/stun.h                                         |   15 -
283  src/test/dissector_fuzz                            |   68 +
284  src/tprintf.c                                      |  141 +-
285  src/tprintf.h                                      |   30 +-
286  src/trafgen.c                                      |  681 ++---
287  src/trafgen/.gitignore                             |    1 -
288  src/trafgen/CMakeLists.txt                         |   39 +-
289  src/trafgen_cli.c                                  |   16 +
290  src/trafgen_conf.h                                 |   51 +
291  src/trafgen_lexer.l                                |   91 +
292  src/trafgen_parser.y                               |  421 +++
293  src/trie.c                                         |    8 +-
294  src/usermgmt.c                                     |  689 ----
295  src/usermgmt.h                                     |   50 -
296  src/xio.c                                          |   43 +-
297  src/xio.h                                          |    2 +
298  src/xmalloc.c                                      |   38 +-
299  src/xmalloc.h                                      |    1 +
300  src/xstring.c                                      |   97 -
301  src/xstring.h                                      |   51 -
302  src/xsys.c                                         |  634 ----
303  src/xsys.h                                         |  143 -
304  src/xutils.c                                       |  986 ++++++
305  src/xutils.h                                       |  151 +
306  219 files changed, 12373 insertions(+), 10534 deletions(-)
309                 ,---------------------,
310                 < Y U NO LUV PACKETZ? >
311                 '---------------------'
312                          O
313                           o
314                             ^__^ 
315                     _______/(oo)
316                 /\/(       /(_o)
317                    | W----||  _
318                    ||     || |~|  ~~
319                              |~|  ~
320                              |_| o
321                              |#|/
322                             _+#+_