English
- ============================================================================
- ettercap 0.4.0
- ============================================================================
- @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@@@@
- @@ @@@ @@@ @@ @@ @@ @@ @@ @@ @@ @@
- @@@@@@ @@@ @@@ @@@@@@ @@@@@@ @@ @@@@@@@ @@@@@@
- @@ @@@ @@@ @@ @@ @@ @@ @@ @@ @@
- @@@@@@@ @@@ @@@ @@@@@@@ @@ @@@ @@@@@@@ @@ @@ @@
- @@@@@@@ @@ @@ @@ @@@@@@@ @@@@ @@@@@@@ @@@@@@@
- @@ @@ @@ @@ @@ @@ @@ @@ @@ @@
- @@@@@@@ @@ @@ @@ @@ @@@ @@ @@ @@ @@@@@@@
- @@ @@ @@ @@ @@ @@ @@ @@ @@ @@
- @@ @@@@@@@ @@@@@@@ @@@@@@@ @@@@ @@ @@ @@@@@@@
- Required Libraries: ettercap ;)
- Installation: configure --enable-plugins
- make plug-ins
- make plug-ins_install
- ============================================================================
- TABLE OF CONTENTS
- ============================================================================
- 1. INSTALLATION..........................................sez. 1
- 2. HOW TO USE THEM.......................................sez. 2
- 2.1 ncurses interface
- 2.2 command line
- 3. HOW TO CREATE A PLUGIN................................sez 3
- ============================================================================
- 1> INSTALLATION
- ============================================================================
- To install plugins you have to run:
- configure --enable-plugins (enabled by default)
- make plug-ins
- make plug-ins_install
- this will make all the plugins in the plugins directory and install them in
- the same dir as the one specified in configure.
- If you code a new plugin, simply create a new dir in the plugins directory
- with the name of your plugin and put the source code and a little Makefile
- in it. Plugins must have a name in this form: ec_`name`.so
- Installation process will then be automatic.
- NOTE:
- The plugins are searched in the installation dir and in ./ so as default
- you have to put your plugin in /usr/local/bin/ or in the current directory.
- ============================================================================
- 2> HOW TO USE THEM
- ============================================================================
- 2.1 NCURSES INTERFACE
- Within the main interface press 'p' and you'll get the list of the available
- plugins. Select one and have fun... ;)
- 2.2 COMMAND LINE
- Use:
- ettercap -N -p list
- to get the list of the available plug-ins. Then use:
- ettercap -N -p "plugin name"
- to execute the specified plugin.
- Example:
- ettercap -Np ooze ghibli
- will launch "ooze" on host "ghibli". ( ooze plugin pings the dest host...)
- that's all !!
- ============================================================================
- 3> HOW TO CREATE A PLUGIN
- ============================================================================
- I believe that an example tells much more than thousand words. So I write a
- "dummy" plugin to demostrate how to write a simple plugin.
- However here there are some directive you have to respect.
- 1) THE INCLUDES
- #include "../../src/include/ec_main.h" // for global variables
- #include "../../src/include/ec_plugins.h" // for input/output
- theese are required, but you can include as many includes as you want.
- in order to have a list of API that you can use, look in ./src/include
- the only APIs you CAN'T use from a plugin are the ec_interface_* ones.
- 2) VERSION & INFOS
- char Ettercap_Version[] = VERSION; // for API's compatibility
- // VERSION is defined in
- // ec_main.h
- char PlugIn_Info[] = "little description"; // the plugin description
- short PlugIn_Version = 10; // the plugin version
- // 10 will be displayed
- // as 1.0
- 3) THE ENTRY POINT
- void PlugIn_Start(char**argv) // the Entry point
- {
- // DO SOME JOBS
- return;
- }
- This function is the entry point of the plugin.
- VERY IMPORTANT: The plugin must NOT end with exit() !!
- 4) ETTERCAP API
- + Plugin_Output() same as printf(), but required in order to output
- to ncurses interface.
- + Plugin_Input() to aquire data from user.
- + All the other functions in ec_inet_forge.c, ec_inet.c and ec_decodedata.c
- provides you a simple access to the link layer interface.
- feel free to write an email to alor@users.sourceforge.net
- or to crwm@freemail.it
