readme.txt

ngrep strives to provide most of GNU grep s common features, applying them to the network layer. ngr

Program: Windows ngrep
Author: Jordan Ritter <[e-mail]>


Important:

  The Win32 port of ngrep contains a option: the '-L' option will list
  all available adapters that ngrep can listen on.

  Also, when you specify an adapter to listen on (-d), you must refer
  to it by its corresponding adapter number, which can be obtained
  from the output of the '-L' option.


Compilation:

  The win32 distribution of ngrep comes with all the necessary headers
  and libraries to compile ngrep.exe.  The following are instructions
  detailing how to replace the winpcap components of the win32 ngrep
  source tree.  

  If you trust the source distribution, proceed to step #3.

  1. Obtain win32 port of libpcap (winpcap) library and supporting
     header files from:

     http://winpcap.polito.it/
         
  2. Unpack and copy over required files:

     File:           Destination:

     gnuc.h          (include/)
     pcap.h          (include/)
     bpf.h           (include/net/)
     wpcap.lib       (lib/)

     As the winpcap distribution has changed a fair bit over the last
     year or two, there may be other files you need.  Please see the
     winpcap documentation for specific installation instructions.

  3. Load ngrep.dsw from M$ Visual C++ (6.0 was used, 5.0 might work
     too).

  4. Compile the project.  regex.c will generate approximately 118
     warnings.  Ignore them.


Installation:

  1. Obtain the NDIS driver for your particular operating system from:

     http://winpcap.polito.it/

  2. Follow the installation instructions.

     Quick Install (Windows 9x):

       1. Download and unpack the driver. 

       2. Inside "Network" in the Control Panel, click "Add", select
          "Protocol", click "Have Disk", and specify the directory you
          unpacked the driver into as the location of the software to
          be installed.

     Quick Install (Windows NT):

       1. Download and unpack the driver.
       
       2. Inside "Network" in the Control Panel, select the
          "Services" tab, click "Add", click "Have Disk", and specify
          the directory you unpacked the driver into as the location
          of the software to be installed.

     Please read WinPcap's accompanying documentation for specific 
     information on how to install on your particular platform.
   
  3. Install (copy) ngrep.exe to a directory that is in your PATH
     environment variable.  For most, "C:\Windows" (Windows 9x) or
     "C:\WinNT" will suffice. 


Note: 

  Some win32-related code is based on the WinDump code.  The authors
  of WinDump were contacted and were kind enough to allow the code to
  be derived from without any licensing implications.


Thanks to:

  Mike Davis for the original ngrep port.
  All the Windows users who have helped debug ngrep on Win32.


Questions or Comments:

  Please email the author of ngrep, "Jordan Ritter"
  <[e-mail]>.