contrib/html/index.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3
   4 <head>
   5 <title>netsniff-ng - the packet sniffing beast</title>
   6
   7 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   8 <meta name="Robots" content="noarchive">
   9
  10 <link rel="Shortcut Icon" href="http://netsniff-ng.org/img/tiny-logo.png" type="image/png">
  11 <link type="text/css" rel="stylesheet" media="screen" href="style.css" />
  12
  13 <script type="text/javascript">
  14   function InsertMail(mailnam,mailsvr,maildom)
  15   {
  16     document.write('&lt;<a href="mailto:' + mailnam + '@' + mailsvr + '.'
  17       + maildom + '">' + mailnam + '@' + mailsvr + '.' + maildom +
  18       '<\/a>&gt;');
  19   }
  20 </script>
  21 </head>
  22
  23 <body>
  24 <a href="https://github.com/gnumaniacs/netsniff-ng/"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://a248.e.akamai.net/assets.github.com/img/7afbc8b248c68eb468279e8c17986ad46549fb71/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f6461726b626c75655f3132313632312e706e67" alt="Fork me on GitHub"></a>
  25 <blockquote>
  26
  27 <p>
  28 <table border="0">
  29 <tr>
  30 <td>
  31 <a href="http://netsniff-ng.org"><img src="http://netsniff-ng.org/img/logo.png" border="0" alt="netsniff-ng"></a>
  32 </td>
  33 <td>
  34 <br><br><br>
  35 <img src="http://netsniff-ng.org/img/logo2.png" border="0" alt="the packet sniffing beast">
  36 </td>
  37 </tr>
  38 </table>
  39 </blockquote>
  40
  41 <table border="1" width="100%" class="header"<tr><td>
  42 <table border="0" width="90%">
  43 <tr>
  44   <td valign="top" width="200" align="right">
  45     <b>Latest version:</b>
  46   </td>
  47   <td valign="top">
  48     <a href="https://github.com/gnumaniacs/netsniff-ng/tree/master">netsniff-ng 0.5.6-next</a> (<a href="http://git.cryptoism.org/cgit.cgi/netsniff-ng.git/">M</a>, <a href="http://repo.or.cz/w/netsniff-ng.git/">M</a>, <a href="https://github.com/gnumaniacs/netsniff-ng/tarball/master">T</a>)<br>
  49     <a href="http://www.netsniff-ng.org/pub/netsniff-ng/netsniff-ng-0.5.5.0.tar.gz">netsniff-ng 0.5.5-curr</a>
  50     (<a href="http://dl.packetstormsecurity.net/sniffers/netsniff-ng-0.5.5.0.tar.gz">M</a>)
  51   </td>
  52 </tr>
  53 </table>
  54 </td></tr></table>
  55 <br>
  56 <table border="1" width="100%" class="header"><tr><td>
  57 <table border="0" width="90%">
  58 <tr>
  59   <td valign="top" width="200" align="right">
  60     <b>Git repository:</b>
  61   </td>
  62   <td valign="top">
  63     git clone git://github.com/gnumaniacs/netsniff-ng.git
  64   </td>
  65 </tr>
  66 <tr>
  67   <td valign="top" width="200" align="right">
  68     <b>Git web:</b>
  69   </td>
  70   <td valign="top">
  71     <a href="http://src.netsniff-ng.org/">http://src.netsniff-ng.org/</a><br>
  72   </td>
  73 </tr>
  74 </table>
  75 </td></tr></table>
  76 <br>
  77 <table border="1" width="100%" class="header"><tr><td>
  78 <table border="0" width="90%">
  79 <tr>
  80   <td valign="top" width="200" align="right">
  81     <b>Bug tracker:</b>
  82   </td>
  83   <td valign="top">
  84     <a href="http://bugs.netsniff-ng.org/">http://bugs.netsniff-ng.org/</a>
  85   </td>
  86 </tr>
  87 <tr>
  88   <td valign="top" width="200" align="right">
  89     <b>Mailing list:</b>
  90   </td>
  91   <td valign="top">
  92     via <a href="http://groups.google.com/group/netsniff-ng">Google</a>, <a href="http://news.gmane.org/gmane.linux.network.netsniff-ng">Gmane</a>, <a href="http://www.mail-archive.com/netsniff-ng%40googlegroups.com/">Archive</a>
  93   </td>
  94 </tr>
  95 <tr>
  96   <td valign="top" width="200" align="right">
  97     <b>Blog:</b>
  98   </td>
  99   <td valign="top">
 100     <a href="http://blog.netsniff-ng.org/">http://blog.netsniff-ng.org/</a>
 101   </td>
 102 </tr>
 103 <tr>
 104   <td valign="top" width="200" align="right">
 105     <b>Support us:</b>
 106   </td>
 107   <td valign="top">
 108     via <a href="http://flattr.com/thing/421382/gnumaniacs-devs" target="_blank">Flattr</a><br>
 109   </td>
 110 </tr>
 111 </table>
 112 </td></tr></table>
 113
 114 <h2>Abstract</h2>
 115 <p>
 116 netsniff-ng is a free, performant Linux networking toolkit.
 117 <br><br>
 118 The gain of performance is reached by zero-copy mechanisms, so that on packet reception <i>and</i> transmission the kernel does not need to copy packets from kernel space to user space and vice versa.
 119 <br><br>
 120 For this purpose, the netsniff-ng toolkit is libpcap independent (note: libpcap starting from 1.0.0 also supports zero-copy for capturing), but nevertheless supports the pcap file format for capturing, replaying and performing offline-analysis of pcap dumps. Furthermore, we are focussing on building a robust and clean analyzer and utilities that complete netsniff-ng as a support for network development, debugging or network reconnaissance.
 121 <br><br>
 122 The netsniff-ng toolkit consists of the following utilities:
 123 <ul>
 124   <li><b>netsniff-ng</b>, a zero-copy analyzer, pcap capturer and replayer</li>
 125   <li><b>trafgen</b>, a high-performance zero-copy network traffic generator</li>
 126   <li><b>bpfc</b>, a Berkeley Packet Filter compiler supporting Linux extensions</li>
 127   <li><b>ifpps</b>, a top-like kernel networking and system statistics tool</li>
 128   <li><b>flowtop</b>, a top-like netfilter connection tracking tool</li>
 129   <li><b>curvetun</b>, a lightweight multiuser IP tunnel based on elliptic curve cryptography</li>
 130   <li><b>ashunt</b>, an Autonomous System (AS) trace route and ISP testing utility</li>
 131 </ul>
 132
 133 <h2>Development</h2>
 134 <p>
 135 <b>Source control</b>
 136 <p>
 137 There's a public Git repository at <a href="https://github.com/gnumaniacs/netsniff-ng">https://github.com/gnumaniacs/netsniff-ng</a> (<a href="http://repo.or.cz/w/netsniff-ng.git">mirror</a>, <a href="http://git.cryptoism.org/cgit.cgi/netsniff-ng.git/">mirror</a>) where you can check out the entire code base. If you are curious about the latest development happenings, you really might prefer our Git master's branch instead of the tarballs within our <a href="http://pub.netsniff-ng.org/">public archive</a>. However, in case of the tarballs, you might want to check the downloaded archives for inconsistencies with <code>md5sum -c MD5SUMS</code> or <code>sha256sum -c SHA256SUMS</code>.
 138 <p>
 139 <b>Documents</b>
 140 <p>
 141 There is a netsniff-ng <a href="faq.html">frequently asked question</a> site and for participating in development have a look at the documentation files within the source code, especially the CODING and HACKING files. <a href="http://www.gnu.org/licenses/old-licenses/gpl-2.0-faq.html">Here</a> is also a FAQ about the GNU GPL version 2, under which netsniff-ng is licensed.
 142 <p>
 143 For reporting bugs please use our <a href="http://bugs.netsniff-ng.org/">bug tracking system</a> or
 144 write an e-mail to <script type="text/javascript">InsertMail("bugs", "netsniff-ng", "org");</script>.
 145 <p>
 146 <b>Contribute</b>
 147 <p>
 148 If you think this software is great, then please consider <a href="http://flattr.com/thing/421382/gnumaniacs-devs" target="_blank">donating</a> (Flattr) some money to help us to keep up development, server fees, or travelling costs for conferences.
 149 If you would like to help otherwise, we would like to see more people to:
 150 <ul>
 151   <li>Review and contribute to the <a href="https://github.com/gnumaniacs/netsniff-ng">source code</a> (see TODO file)</li>
 152   <li>Adding or updating documentation, Manpages, write interesting howtos</li>
 153   <li>Donate hardware, networking equipment, especially for 10-Gbit/s-Ethernet</li>
 154   <li>Maintain distribution specific packages</li>
 155   <li>Test netsniff-ng on your specific platform, especially on non-x86</li>
 156   <li>Mirror our site and public archive, <a href="https://github.com/gnumaniacs/netsniff-ng">fork/hack</a> on the source</li>
 157 </ul>
 158 <p>
 159 Currently, netsniff-ng is only available for Linux platforms. If you have a port for *BSD, let us know for merging your port into the main source tree. However, please do NOT PORT netsniff-ng to Windows! (Here is a nice explanation why; we really share <a href="http://www.fefe.de/nowindows/">Felix von Leitner's point of view</a>.)
 160
 161 <h2>Documentation</h2>
 162 <p>
 163 The <a href="doc/netsniff-ng.html">manpage</a> (<a href="doc/netsniff-ng.pdf">PDF</a>) of each stable release of netsniff-ng will cover all of the usage details. We also have a <a href="faq.html">frequently asked question</a> page. Furthermore, the documents within the source will give you some useful information.
 164 <p>
 165 To dig into the inner workings of the Berkeley Packet Filter architecture have a look at <a href="bpf.pdf">this</a>.
 166 <p>
 167 Documentation about the packet_mmap architecture with pf_packet sockets for the Linux kernel can be downloaded from <a href="http://www.kernel.org/">http://www.kernel.org/</a> under <a href="http://lingrok.org/source/xref/linux-2.6-linus/Documentation/networking/packet_mmap.txt">packet_mmap.txt</a>.
 168
 169 <h2>Support</h2>
 170 <p>
 171 A mailing list for netsniff-ng moderated (spam free) user discussions is open to the <a href="http://groups.google.com/group/netsniff-ng">public</a>. Subscribe and mail to <script type="text/javascript">InsertMail("netsniff-ng", "googlegroups", "com");</script>. There's also an archive at <a href="http://dir.gmane.org/gmane.linux.network.netsniff-ng">Gmane</a> and a <a href="http://www.mail-archive.com/netsniff-ng%40googlegroups.com/">searchable archive</a>.
 172 <p>
 173 Before posting questions, have a look at our <a href="faq.html">FAQ</a>.
 174
 175 <h2>netsniff-ng around the world</h2>
 176 <p>
 177 Distribution specific packages -- a huge thanks to our awesome maintainers -- may be found here:
 178 <ul>
 179   <li><a href="http://packages.debian.org/search?keywords=netsniff-ng">Debian</a> - by <a href="http://people.debian.org/~kartik/">Kartik Mistry</a></li>
 180   <li><a href="https://admin.fedoraproject.org/pkgdb/acls/name/netsniff-ng">Fedora/RHEL</a> - by <a href="http://fedoraproject.org/wiki/User:Jskala">Jiří Skála </a></li>
 181   <li><a href="https://launchpad.net/ubuntu/+source/netsniff-ng/">Ubuntu</a> - pulled from Debian</li>
 182   <li><a href="http://aur.archlinux.org/packages.php?K=netsniff-ng">Arch Linux</a> - by <a href="mailto:dcelasun@nospam.gmail.com">Dcelasun</a></li>
 183   <li><a href="http://packages.gentoo.org/package/net-analyzer/netsniff-ng">Gentoo</a> - by <a href="mailto:xmw@nospam.gentoo.org">Michael Weber</a></li>
 184   <li><a href="http://gpo.zugaina.org/net-misc/netsniff-ng">Sabayon</a> - by <a href="mailto:epinephrineaddict@nospam.gmail.com">Epinephrine</a></li>
 185   <li><a href="http://www.slackers.it/repository/netsniff-ng/">Slackware</a> - by <a href="mailto:conraid@nospam.gmail.com">Corrado Franco</a></li>
 186   <li><a href="http://software.opensuse.org/search?baseproject=ALL&amp;p=1&amp;q=netsniff-ng">openSUSE/SLE</a> - by <a href="mailto:pascal.bleser@nospam.skynet.be">Pascal Bleser</a></li>
 187   <li><a href="http://sophie.zarb.org/srpm/Mandriva,cooker,/netsniff-ng">Mandriva</a> - by <a href="mailto:guillomovitch@nospam.mandriva.org">Guillaume Rousse</a></li>
 188   <li><a href="http://packages.trisquel.info/slaine/net/netsniff-ng">Trisquel</a> - pulled from Debian</li>
 189   <li><a href="http://grml.org/">GRML</a> - pulled from Debian</li>
 190   <li><a href="http://git.alpinelinux.org/cgit/aports.git/commit/?id=43f91b3d133e6937a3de8372f60733d02f3fa065">Alpine Linux</a> - by <a href="mailto:fabian@nospam.affolter-engineering.ch">Fabian Affolter</a></li>
 191 </ul>
 192 <p>
 193 Some documents and other resources may be found here:
 194 <ul>
 195   <li><a href="http://www.cs.columbia.edu/~hgs/internet/traffic-generator.html">Columbia University</a></li>
 196   <li><a href="http://www.grid.unina.it/software/ITG/link.php">University of Napoli Federico II</a></li>
 197   <li><a href="http://portal.imn.htwk-leipzig.de/fakultaet/forschung/studentische-projekte">Leipzig University of Applied Sciences</a></li>
 198   <li><a href="http://packetstormsecurity.org/files/author/7838/">Packetstormsecurity</a></li>
 199   <li><a href="http://pastebin.com/1aHHYbGC">Fedora's Security Spin</a></li>
 200   <li><a href="http://www.xplico.org/archives/944">netsniff-ng for Xplico</a></li>
 201   <li><a href="http://networksecuritytoolkit.org/">Network Security Toolkit (NST)</a></li>
 202   <li><a href="http://wiki.networksecuritytoolkit.org/nstwiki/index.php/LAN_Ethernet_Maximum_Rates,_Generation,_Capturing_%26_Monitoring">NST Wiki article, including netsniff-ng</a></li>
 203   <li><a href="http://carnivore.it/2011/12/27/linux_3.0_bpf_jit_x86_64_exploit">Linux 3.0 BPF JIT x86_64 exploit (utilized bpfc)</a></li>
 204   <li><a href="http://wiki.alpinelinux.org/wiki/Alpine_security">Alpine Linux Security Toolset</a></li>
 205 </ul>
 206 <p>
 207 Note: If your netsniff-ng related project / article / paper / ... should be added here, simply drop us a mail.
 208
 209 <p>
 210 <a href="http://www.debian.org/"><img src="http://netsniff-ng.org/img/debian.png" border="0" alt="powered by Debian"></a>&nbsp;
 211 <a href="http://www.vim.org/"><img src="http://netsniff-ng.org/img/vim.png" border="0" alt="powered by vim"></a>&nbsp;
 212 <a href="http://www.anybrowser.org/campaign/"><img src="http://netsniff-ng.org/img/vt100.gif" border="0" alt="best viewed with vt100"></a>&nbsp;
 213 <a href="http://eupat.ffii.org/"><img src="http://netsniff-ng.org/img/no_epatent.png" border="0" alt="no epatents"></a>&nbsp;
 214 <a href="http://www.laquadrature.net/"><img src="http://netsniff-ng.org/img/qdn.png" border="0" alt="qdn"></a>
 215
 216 <table border="0" width="90%">
 217 <tr>
 218   <td>
 219     <address>Copyright (C) 2009-2011 <a href="http://gnumaniacs.org">Daniel Borkmann</a>
 220     <script type="text/javascript">InsertMail("daniel", "netsniff-ng", "org");</script>
 221     and
 222     <a href="http://emmanuel.netsniff-ng.org">Emmanuel Roullit</a>
 223     <script type="text/javascript">InsertMail("emmanuel", "netsniff-ng", "org");</script>
 224     </address>
 225   </td>
 226 </tr>
 227 </table>
 228
 229 </body>
 230 </html>
 231