
Program: ngrep [win32]
Author: Jordan Ritter <jpr5@darkridge.com>
Version: 1.39 [win32] (2.25.2001)


Important:

  The Win32 port of ngrep contains the '-L' option, which will list
  all available adapters that ngrep is capable of listening 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.

  Finally, if you're curious as to what ngrep actually does, please
  consult the included file named README.unix.  It is the README that
  accompanies the Unix version of ngrep.


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://netgroup-serv.polito.it/winpcap/install/Default.htm
    
  2. Unpack and copy over required files:

     File:           Destination:

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

  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 116
     warnings.  Ignore them.


Installation:

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

     http://netgroup-serv.polito.it/winpcap/install/Default.htm

  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.
   
  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 <mike@datanerds.com> 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"
  <jpr5@darkridge.com>.

