
                      N   E   T   D   U   D   E


	     The NETwork DUmp data Displayer and Editor
                             0.4 series

                    http://netdude.sourceforge.net
       Christian Kreibich <christian.kreibich -AT- cl.cam.ac.uk>

------------------------------------------------------------------------

Netdude is an extendable GUI tool to visually inspect, display, filter
and modify tcpdump trace files of arbitrary size, as produced using
tcpdump's -w option.

Requirements:
=============

	* libnetdude, available from http://netdude.sf.net
          (it's the packet mangling backend)

        * libpcapnav, providing support to navigate around
          in tcpdump traces, and required by libnetdude.
          Also available at http://netdude.sf.net

        * The Gimp Toolkit, at http://www.gtk.org (1.2.x)
          (the GUI widget library we're using)


Build:
======

To build netdude, check your available build options using

   > ./configure --help

and then build it using

   > ./configure [options]; make; make install

------------------------------------------------------------------------
CVS users, you have to create the configure script first. Use the
included autogen.sh script, which will usually work fine. We try to
support various autoconf/automake combinations, we also support both a
configure.ac and a configure.in template. Be warned that configure.in
is not as well-maintained as configure.ac.

You'll probably need higher privileges for the make install part, unless
you've changed the installation directiories using --prefix or similars.
By default, netdude will live in /usr/local/bin, the plugins are in
/usr/local/share/netdude/VERSION/plugins, but you can always find out
the directories a Netdude binary uses to look up plugins in using
command line arguments, see netdude --help.

Look at plugins/nd_dummyplugin.c for commented versions of the filter
callbacks if you want to find out more about coding filters.

If you want to build plugins for Netdude, there are code templates
available to make life easier for you. To obtain them, please visit
http://netdude.sf.net/plugins.html .

I've included a spiffy little icon for use with your favourite file
manager in the pixmaps directory, netdude-icon.png.

There is pretty solid documentation in the doc/ directory. HTML +
DocBook are shipped with the tarball; if you have gtk-doc installed
you can update and rebuild documentation using 'make docs' in the
appropriate subdirectory. More doco is always nice, so if you want
to write some, feel free to!

In the meantime, have fun using Netdude!
  
                                             Cheers,
                                             -- Christian.

------------------------------------------------------------------------
  Yet another SRG production -- http://www.cl.cam.ac.uk/Research/SRG/
------------------------------------------------------------------------
