============================================================================
                                    ettercap
============================================================================

    Even if blessed with a feeble intelligence they are cruel and smart...


       @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@
       @@        @@@     @@@   @@      @@   @@ @@      @@   @@ @@   @@
       @@@@@@    @@@     @@@   @@@@@@  @@@@@@  @@      @@@@@@@ @@@@@@
       @@        @@@     @@@   @@      @@  @@  @@      @@   @@ @@
       @@@@@@@   @@@     @@@   @@@@@@@ @@  @@@ @@@@@@@ @@   @@ @@


                                     FOR

            @@ @@ @@ @@@@  @@@@@  @@@@@@   @@@@@  @@ @@ @@  @@@@@
            @@ @@ @@  @@  @@   @@ @@   @@ @@   @@ @@ @@ @@ @@
            @@ @@ @@  @@  @@   @@ @@   @@ @@   @@ @@ @@ @@  @@@@@
            @@ @@ @@  @@  @@   @@ @@   @@ @@   @@ @@ @@ @@      @@
             @@@@@@  @@@@ @@   @@ @@@@@@   @@@@@   @@@@@@   @@@@@


                     Multi purpose sniffer/interceptor


         Required Libraries:              winpcap  (the driver)
                                          Wpdpack  (packet.a packet32.h)

         Optional Libraries:              openssl  (if you want ssh support)
                                          PDCurses (curses.h pdcurses.a panel.a)

         Installation:                    configure
                                          make
                                          make install


============================================================================
                                 REQUIREMENTS
============================================================================


Ettercap for windows requires Windows NT/2000/XP.
The packet driver for windows (winpcap) version 2.3 or greater.


============================================================================
                               LINENCE AGREEMENT
============================================================================


This product includes software developed by the Politecnico di Torino, and 
its contributors.


============================================================================
                      CONFIGURING AND COMPILING FROM SOURCE
============================================================================


In order to compile ettercap under Windows 9x/NT/2000/XP you need to install
the cygwin suite.

Follow these steps:

1) dowload the latest cygwin from http://cygwin.com/setup.exe

2) run the setup and install all the packet necessary to build executable
   files (all the packets in the 'base', 'devel' and 'libs' section) and
   make sure to install the w32api package

3) download the winpcap driver for your OS

   http://winpcap.polito.it/install/default.htm

   NOTE: Windows XP user must use the winpcap version >= 2.3

4) dowload the development pack for the winpcap

5) dowload the PDcurses source code

   http://pdcurses.sourceforge.net

6) launch the cygwin shell (by clicking the icon on your desktop)

7) extract the WPdpack_2_3.zip in you home directory

8) extract the PDCureses-x.x.tar.gz in you home directory and rename the
   directory "mv ./PDCurses-x.x ./PDCurses"

8a) compile the pdcurses library in the ./PDCurses/lib directory

9) extract the ettercap source code from the tarball in you home directory

10) now your home should be like this:

Administrator@MELTEMI ~
$ ls -la
total 1404
drwxr-xr-x    7 Administ Administ        0 Feb  7 10:24 .
drwxr-xr-x    3 Administ Administ        0 Feb  7 10:10 ..
-rw-r--r--    1 Administ Administ     4620 Feb  7 11:16 .bash_history
-rw-r--r--    1 Administ Administ      878 Apr 11  2001 .viminfo
drwxr-xr-x   15 Administ Administ        0 Apr  5 12:40 PDCurses
-rw-r--r--    1 Administ Administ   362831 Apr  5 02:26 PDCurses-2.5.tar.gz
drwxr-xr-x    6 Administ Administ        0 Mar 30 15:27 WPdpack
-rw-r--r--    1 Administ Administ   501121 Mar 27 12:54 WPdpack_2_3.zip
-rw-r--r--    1 Administ Administ   544448 Mar 27 11:10 ettercap-0.6.5.tar.gz
drwxr-xr-x    7 Administ Administ        0 Apr  5 12:49 ettercap-0.6.5


11) enter the ettercap directory and run

      ./configure

    or if you have changed the path to WPdpack or PDCurses

      ./configure --with-wpdpack=DIR --with-pdcurses=DIR

12) follow the instruction on the screen


============================================================================
                       USING IT FROM THE BINARY PACKAGE
============================================================================


If you have compiled it by your hand or if you use it within the cygwin shell
it is ok. But if you downloaded the precompiled version or you use it outside
the cygwin environment, remember to launch ettercap.exe in the same dir as
its configuration file.
So for the binary package, dowload it, extract it in a folder and lauch it
inside this folder.

NOTE: download the winpcap driver for your OS before launching ettercap

      http://winpcap.polito.it/install/default.htm

      NOTE: Windows XP user must use the winpcap version >= 2.3
