Provided by: ettercap_0.7.3-2.1ubuntu2_i386 bug

NAME

       ettercap  NG-0.7.3  -  A multipurpose sniffer/content filter for man in
       the middle attacks

***** IMPORTANT NOTE ******

       Since ettercap NG (formerly 0.7.0), all the options have been  changed.
       Even  the  target specification has been changed. Please read carefully
       this man page.

SYNOPSIS

       ettercap [OPTIONS] [TARGET1] [TARGET2]

       TARGET is in the form MAC/IPs/PORTs
       where IPs and PORTs can be ranges (e.g. /192.168.0.1-30,40,50/20,22,25)

DESCRIPTION

       Ettercap was born as a sniffer for switched  LAN  (and  obviously  even
       "hubbed"  ones),  but during the development process it has gained more
       and more features that have changed it to a powerful and flexible  tool
       for   man-in-the-middle   attacks.   It  supports  active  and  passive
       dissection of many protocols (even ciphered  ones)  and  includes  many
       features for network and host analysis (such as OS fingerprint).

       It has two main sniffing options:

       UNIFIED, this method sniffs all the packets that pass on the cable. You
       can choose to put or not the interface in promisc mode (-p option). The
       packet  not  directed  to  the  host running ettercap will be forwarded
       automatically using layer 3 routing. So  you  can  use  a  mitm  attack
       launched  from a different tool and let ettercap modify the packets and
       forward them for you.
       The kernel ip_forwarding is always disabled by ettercap. This  is  done
       to  prevent  to  forward a packet twice (one by ettercap and one by the
       kernel).  This is an invasive behaviour on gateways.  So  we  recommend
       you  to  use  ettercap  on  the gateways ONLY with the UNOFFENSIVE MODE
       ENABLED.  Since  ettercap  listens  only  on  one  network   interface,
       launching it on the gateway in offensive mode will not allow packets to
       be rerouted back from the second interface.

       BRIDGED, it uses two network interfaces and forward  the  traffic  from
       one  to the other while performing sniffing and content filtering. This
       sniffing method is totally stealthy since there is no way to find  that
       someone  is in the middle on the cable.  You can look at this method as
       a mitm attack at layer 1. You will  be  in  the  middle  of  the  cable
       between  two  entities.  Don't  use it on gateways or it will transform
       your gateway into a bridge. HINT: you can  use  the  content  filtering
       engine  to  drop  packets  that should not pass. This way ettercap will
       work as an inline IPS ;)

       You can also perform man in the middle attacks while using the  unified
       sniffing.  You  can  choose  the  mitm attack that you prefer. The mitm
       attack module is independent from the sniffing and  filtering  process,
       so you can launch several attacks at the same time or use your own tool
       for the attack. The crucial point is that the packets have to arrive to
       ettercap  with the correct mac address and a different ip address (only
       these packets will be forwarded).

       The most relevant ettercap features are:

       SSH1 support : you can sniff User and Pass, and even  the  data  of  an
       SSH1 connection. ettercap is the first software capable to sniff an SSH
       connection in FULL-DUPLEX

       SSL support : you can sniff SSL secured data... a fake  certificate  is
       presented to the client and the session is decrypted.

       Characters  injection  in  an  established  connection : you can inject
       characters  to  the  server  (emulating  commands)  or  to  the  client
       (emulating replies) maintaining the connection alive !!

       Packet filtering/dropping: You can set up a filter script that searches
       for a particular string (even hex)  in  the  TCP  or  UDP  payload  and
       replace  it  with yours or drop the entire packet. The filtering engine
       can match any field of the network protocols and  modify  whatever  you
       want (see etterfilter(8)).

       Remote  traffic  sniffing  through  tunnels and route mangling: You can
       play with linux cooked interfaces or use the integrated plugin to sniff
       tunneled  or  route-mangled remote connections and perform mitm attacks
       on them.

       Plug-ins support : You can create your own plugin using the  ettercap's
       API.

       Password  collector  for  :  TELNET,  FTP, POP, RLOGIN, SSH1, ICQ, SMB,
       MySQL, HTTP, NNTP, X11, NAPSTER, IRC, RIP, BGP, SOCKS 5, IMAP  4,  VNC,
       LDAP,  NFS, SNMP, HALF LIFE, QUAKE 3, MSN, YMSG (other protocols coming
       soon...)

       Passive OS fingerprint: you scan passively the lan (without sending any
       packet)  and gather detailed info about the hosts in the LAN: Operating
       System, running services, open  ports,  IP,  mac  address  and  network
       adapter vendor.

       Kill  a  connection:  from  the  connections  list you can kill all the
       connections you want

TARGET SPECIFICATION

       There is no concept of SOURCE nor DEST. The two targets are intended to
       filter  traffic  coming from one to the other and vice-versa (since the
       connection is bidirectional).

       TARGET is in the form MAC/IPs/PORTs. If you want you can  omit  any  of
       its parts and this will represent an ANY in that part.
       e.g.
       "//80" means ANY mac address, ANY ip and ONLY port 80
       "/10.0.0.1/" means ANY mac address, ONLY ip 10.0.0.1 and ANY port

       MAC must be unique and in the form 00:11:22:33:44:55

       IPs is a range of IP in dotted notation. You can specify range with the
       - (hyphen) and single ip with , (comma). You can also use ; (semicolon)
       to indicate different ip addresses.
       e.g.
       "10.0.0.1-5;10.0.1.33"  expands  into  ip  10.0.0.1,  2,  3,  4,  5 and
       10.0.1.33

       PORTs is a range of PORTS. You can specify range with  the  -  (hyphen)
       and single port with , (comma).
       e.g.
       "20-25,80,110" expands into ports 20, 21, 22, 23, 24, 25, 80 and 110

       NOTE:
       you  can  reverse the matching of the TARGET by adding the -R option to
       the command line. So if you want to sniff ALL the traffic BUT  the  one
       coming or going to 10.0.0.1 you can specify "./ettercap -R /10.0.0.1/"

       NOTE:
       TARGETs  are  also  responsible of the initial scan of the lan. You can
       use them to restrict the scan to only a subset  of  the  hosts  in  the
       netmask.  The  result  of  the  merging between the two targets will be
       scanned. remember that not specifying a target means "no  target",  but
       specifying "//" means "all the hosts in the subnet.

PRIVILEGES DROPPING

       ettercap  needs  root  privileges to open the Link Layer sockets. After
       the initialization phase, the root privs are  not  needed  anymore,  so
       ettercap  drops  them  to  UID  = 65535 (nobody). Since ettercap has to
       write (create) log files, it must be executed in a directory  with  the
       right  permissions  (e.g.  /tmp/).  If  you  want  to  drop  privs to a
       different uid, you can export the environment variable EC_UID with  the
       value  of  the  uid  you  want  to  drop  the  privs  to  (e.g.  export
       EC_UID=500) or set the correct parameter in the etter.conf file.

SSL MITM ATTACK

       While performing the SSL mitm attack, ettercap substitutes the real ssl
       certificate  with  its  own. The fake certificate is created on the fly
       and all the fields are filled according to the real cert  presented  by
       the server. Only the issuer is modified and signed with the private key
       contained in the 'etter.sll.crt' file. If you want to use  a  different
       private  key  you  have to regenerate this file. To regenerate the cert
       file use the following commands:

       openssl genrsa -out etter.ssl.crt 1024
       openssl req -new -key etter.ssl.crt -out tmp.csr
       openssl x509 -req -days 1825 -in tmp.csr  -signkey  etter.ssl.crt  -out
       tmp.new
       cat tmp.new >> etter.ssl.crt
       rm  -f  tmp.new  tmp.csr  NOTE:  SSL mitm is not available (for now) in
       bridged mode.

OPTIONS

       Options that make sense together can generally  be  combined.  ettercap
       will warn the user about unsupported option combinations.

       SNIFFING AND ATTACK OPTIONS

       ettercap  NG  has  a  new  unified  sniffing  method. This implies that
       ip_forwarding in the kernel is always disabled and  the  forwarding  is
       done  by  ettercap.  Every packet with destination mac address equal to
       the host's mac address and destination ip address different for the one
       bound  to  the  iface  will be forwarded by ettercap. Before forwarding
       them, ettercap can content filter, sniff, log or drop them. It does not
       matter  how these packets are hijacked, ettercap will process them. You
       can even use external programs to hijack packet.
       You have full control of what ettercap should receive. You can use  the
       internal  mitm  attacks, set the interface in promisc mode, use plugins
       or use every method you want.

       IMPORTANT NOTE: if you run ettercap on a gateway, remember to re-enable
       the  ip_forwarding after you have killed ettercap. Since ettercap drops
       its privileges, it cannot restore the ip_forwarding for you.

       -M, --mitm <METHOD:ARGS>
              MITM attack
              This option will activate the man in the middle attack. The mimt
              attack  is totally independent from the sniffing. The aim of the
              attack is to hijack packets and redirect them to  ettercap.  The
              sniffing engine will forward them if necessary.
              You  can choose the mitm attack that you prefer and also combine
              some of them to perform different attacks at the same time.
              If a mitm method requires some parameters you can  specify  them
              after the colon.  (e.g.  -M dhcp:ip_pool,netmask,etc )

              The following mitm attacks are available:

              arp ([remote],[oneway])
                     This method implements the ARP poisoning mitm attack. ARP
                     requests/replies are sent to the victims to poison  their
                     ARP  cache.  Once the cache has been poisoned the victims
                     will send all packets to the attacker which, in turn, can
                     modify and forward them to the real destination.

                     In  silent  mode  (-z  option)  only  the first target is
                     selected, if you want to poison multiple target in silent
                     mode use the -j option to load a list from a file.

                     You can select empty targets and they will be expanded as
                     'ANY' (all the hosts in the  LAN).  The  target  list  is
                     joined  with the hosts list (created by the arp scan) and
                     the result is  used  to  determine  the  victims  of  the
                     attack.

                     The  parameter  "remote"  is  optional  and  you  have to
                     specify it  if  you  want  to  sniff  remote  ip  address
                     poisoning  a  gateway. Indeed if you specify a victim and
                     the  gw  in  the  TARGETS,  ettercap  will   sniff   only
                     connection  between them, but to enable ettercap to sniff
                     connections that pass thru the gw, you have to  use  this
                     parameter.

                     The parameter "oneway" will force ettercap to poison only
                     from TARGET1 to TARGET2. Useful if  you  want  to  poison
                     only  the client and not the router (where an arp watcher
                     can be in place).

                     Example:

                     the targets are: /10.0.0.1-5/ /10.0.0.15-20/
                     and  the  host  list  is:  10.0.0.1  10.0.0.3   10.0.0.16
                     10.0.0.18

                     the associations between the victims will be:
                     1 and 16, 1 and 18, 3 and 16, 3 and 18

                     if  the  targets overlap each other, the association with
                     identical ip address will be skipped.

                     NOTE: if you manage to poison a client, you have  to  set
                     correct routing table in the kernel specifying the GW. If
                     your routing table is  incorrect,  the  poisoned  clients
                     will not be able to navigate the Internet.

              icmp (MAC/IP)
                     This  attack  implements  ICMP  redirection.  It  sends a
                     spoofed icmp redirect message to the  hosts  in  the  lan
                     pretending  to  be  a  better  route  for  internet.  All
                     connections  to  internet  will  be  redirected  to   the
                     attacker  which,  in  turn, will forward them to the real
                     gateway. The resulting attack is a HALF-DUPLEX mitm. Only
                     the  client  is  redirected,  since  the gateway will not
                     accept  redirect  messages  for  a   directly   connected
                     network.  BE  SURE  TO  NOT  USE  FILTERS THAT MODIFY THE
                     PAYLOAD LENGTH. you can use a filter to  modify  packets,
                     but  the  length must be the same since the tcp sequences
                     cannot be updated in both ways.
                     You have to pass as argument the MAC and the  IP  address
                     of the real gateway for the lan.
                     Obviously  you  have to be able to sniff all the traffic.
                     If you are on a switch you have to use a  different  mitm
                     attack such as arp poisoning.

                     NOTE:  to  restrict  the  redirection  to a given target,
                     specify it as a TARGET

                     Example:

                     -M icmp:00:11:22:33:44:55/10.0.0.1

                     will redirect all the connections  that  pass  thru  that
                     gateway.

              dhcp (ip_pool/netmask/dns)
                     This attack implements DHCP spoofing. It pretends to be a
                     DHCP server and tries to win the race condition with  the
                     real  one  to  force  the client to accept the attacker's
                     reply. This way ettercap is able  to  manipulate  the  GW
                     parameter  and  hijack all the outgoing traffic generated
                     by the clients.
                     The resulting attack is a HALF-DUPLEX mitm. So be sure to
                     use appropriate filters (see above in the ICMP section).

                     You  have to pass the ip pool to be used, the netmask and
                     the ip of the dns server.  Since ettercap  tries  to  win
                     the  race  with the real server, it DOES NOT CHECK if the
                     ip is already assigned. You have to specify an ip pool of
                     FREE  addresses to be used. The ip pool has the same form
                     of the target specification.

                     If the client sends a  dhcp  request  (suggesting  an  ip
                     address) ettercap will ack on that ip and modify only the
                     gw option. If the client makes a dhcp discovery, ettercap
                     will use the first unused ip address of the list you have
                     specified on command line. Every discovery consumes an ip
                     address.  When  the list is over, ettercap stops offering
                     new ip addresses and will reply only to dhcp requests.
                     If you don't want to  offer  any  ip  address,  but  only
                     change  the  router  information of dhcp request/ack, you
                     can specify an empty ip_pool.

                     BIG WARNING: if you specify a list of ip that are in use,
                     you  will  mess your network! In general, use this attack
                     carefully. It can really mess things up!  When  you  stop
                     the  attack, all the victims will be still convinced that
                     ettercap is the gateway until the lease expires...

                     Example:

                     -M dhcp:192.168.0.30,35,50-60/255.255.255.0/192.168.0.1
                     reply to DHCP offer and request.

                     -M dhcp:/255.255.255.0/192.168.0.1
                     reply only to DHCP request.

              port ([remote],[tree])
                     This attack implements Port Stealing. This  technique  is
                     useful  to  sniff  in  a  switched  environment  when ARP
                     poisoning is not  effective  (for  example  where  static
                     mapped ARPs are used).

                     It  floods  the  LAN (based on port_steal_delay option in
                     etter.conf) with ARP packets. If you  don't  specify  the
                     "tree"  option,  the  destination  MAC  address  of  each
                     "stealing" packet is  the  same  as  the  attacker's  one
                     (other  NICs  won't  see  these  packets), the source MAC
                     address will be one of the MACs in the  host  list.  This
                     process  "steals"  the switch port of each victim host in
                     the host list.  Using low  delays,  packets  destined  to
                     "stolen"  MAC addresses will be received by the attacker,
                     winning the race condition  with  the  real  port  owner.
                     When the attacker receives packets for "stolen" hosts, it
                     stops the flooding process and performs  an  ARP  request
                     for the real destination of the packet.  When it receives
                     the ARP reply it's sure that the victim has "taken  back"
                     his  port,  so  ettercap  can  re-send  the packet to the
                     destination as is.  Now  we  can  re-start  the  flooding
                     process waiting for new packets.

                     If you use the "tree" option, the destination MAC address
                     of each stealing packet will be a  bogus  one,  so  these
                     packets  will  be  propagated to other switches (not only
                     the directly connected one). This way you will be able to
                     steal  ports  on other switches in the tree (if any), but
                     you will generate a huge amount of traffic (according  to
                     port_steal_delay).   The  "remote"  option  has  the same
                     meaning as in "arp" mitm method.

                     When you stop the  attack,  ettercap  will  send  an  ARP
                     request  to  each  stolen  host  giving back their switch
                     ports.
                     You can perform either HALF or FULL DUPLEX mitm according
                     to target selection.

                     NOTE: Use this mitm method only on ethernet switches. Use
                     it carefully,  it  could  produce  performances  loss  or
                     general havoc.

                     NOTE:  You  can NOT use this method in only-mitm mode (-o
                     flag), because it hooks  the  sniffing  engine,  and  you
                     can't use interactive data injection.

                     NOTE: It could be dangerous to use it in conjunction with
                     other mitm methods.

                     NOTE: This  mitm  method  doesn't  work  on  Solaris  and
                     Windows  because  of the lipcap and libnet design and the
                     lack of certain ioctl().  (We will feature this method on
                     these OSes if someone will request it...)

                     Example:

                     The targets are: /10.0.0.1/ /10.0.0.15/
                     You will intercept and visualize traffic between 10.0.0.1
                     and 10.0.0.15, but you will receive all the  traffic  for
                     10.0.0.1 and 10.0.0.15 too.

                     The target is: /10.0.0.1/
                     You  will  intercept  and  visualize  all the traffic for
                     10.0.0.1.

       -o, --only-mitm
              This options disables the sniffing thread and enables  only  the
              mitm attack.  Useful if you want to use ettercap to perform mitm
              attacks and another sniffer (such  as  ethereal)  to  sniff  the
              traffic.  Keep  in  mind  that  the packets are not forwarded by
              ettercap. The kernel will be  responsible  for  the  forwarding.
              Remember to activate the "ip forwarding" feature in your kernel.

       -f, --pcapfilter <FILTER>
              Set  a  capturing  filter in the pcap library. The format is the
              same as tcpdump(1). Remember that this kind of filter  will  not
              sniff  packets out of the wire, so if you want to perform a mitm
              attack, ettercap will not be able to forward hijacked packets.
              These filters are useful to decrease  the  network  load  impact
              into ettercap decoding module.

       -B, --bridge <IFACE>
              BRIDGED sniffing
              You  need two network interfaces. ettercap will forward form one
              to the other all the traffic it sees. It is useful  for  man  in
              the  middle  at the physical layer. It is totally stealthy since
              it is passive and there is  no  way  for  an  user  to  see  the
              attacker.
              You can content filter all the traffic as you were a transparent
              proxy for the "cable".

       OFF LINE SNIFFING

       -r, --read <FILE>
              OFF LINE sniffing
              With this option enabled, ettercap will  sniff  packets  from  a
              pcap compatible file instead of capturing from the wire.
              This  is  useful  if  you  have  a  file  dumped from tcpdump or
              ethereal and you want to make an analysis (search for  passwords
              or passive fingerprint) on it.
              Obviously  you  cannot  use  "active" sniffing (arp poisoning or
              bridging) while sniffing from a file.

       -w, --write <FILE>
              WRITE packet to a pcap file
              This is useful if you have to use "active" sniffing (arp poison)
              on  a  switched  LAN  but  you  want to analyze the packets with
              tcpdump or ethereal. You can use this option to dump the packets
              to a file and then load it into your favourite application.

              NOTE: dump file collect ALL the packets disregarding the TARGET.
              This is done because you may want  to  log  even  protocols  not
              supported by ettercap, so you can analyze them with other tools.

              TIP:  you  can use the -w option in conjunction with the -r one.
              This way you will be able to filter the payload  of  the  dumped
              packets  or  decrypt WEP-encrypted WiFi traffic and dump them to
              another file.

       USER INTERFACES OPTIONS

       -T, --text
              The text only interface, only printf ;)
              It is quite interactive, press 'h' in every moment to  get  help
              on what you can do.

       -q, --quiet
              Quiet  mode. It can be used only in conjunction with the console
              interface. It does not print packet content. It is useful if you
              want to convert pcap file to ettercap log files.

              example:

              ettercap -Tq -L dumpfile -r pcapfile

       -s, --script <COMMANDS>
              With this option you can feed ettercap with command as they were
              typed on the keyboard by the user. This way you can use ettercap
              within  your  favourite  scripts. There is a special command you
              can issue thru this command: s(x). this command will sleep for x
              seconds.

              example:

              ettercap -T -s 'lq'  will print the list of the hosts and exit
              ettercap  -T  -s  's(300)olqq'   will  collect  the  infos for 5
              minutes, print the list of the local profiles and exit

       -C, --curses
              Ncurses  based  GUI.   See   ettercap_curses(8)   for   a   full
              description.

       -G, --gtk
              The nice GTK2 interface (thanks Daten...).

       -D, --daemonize
              Daemonize  ettercap.  This  option will detach ettercap from the
              current controlling terminal and set it as  a  daemon.  You  can
              combine  this  feature  with  the  "log"  option  to log all the
              traffic in the background. If the daemon fails for  any  reason,
              it will create the file "./ettercap_daemonized.log" in which the
              error caught by ettercap will be reported. Furthermore,  if  you
              want  to  have  a  complete debug of the daemon process, you are
              encouraged to recompile ettercap in debug mode.

       GENERAL OPTIONS

       -i, --iface <IFACE>
              Use this <IFACE> instead of the default one. The  interface  can
              be unconfigured (requires libnet >= 1.1.2), but in this case you
              cannot use MITM attacks and you should set the unoffensive flag.

       -I, --iflist
              This option  will  print  the  list  of  all  available  network
              interfaces  that  can  be  used  within  ettercap. The option is
              particulary  usefull  under  windows  where  the  name  of   the
              interface is not so obvious as under *nix.

       -n, --netmask <NETMASK>
              Use  this  <NETMASK>  instead  of  the  one  associated with the
              current iface. This option is useful if you have the NIC with an
              associated netmask of class B and you want to scan (with the arp
              scan) only a class C.

       -R, --reversed
              Reverse  the  matching  in  the  TARGET  selection.   It   means
              not(TARGET). All but the selected TARGET.

       -t, --proto <PROTO>
              Sniff only PROTO packets (default is TCP + UDP).
              This  is  useful  if  you  want  to select a port via the TARGET
              specification but you want to differentiate between tcp or udp.
              PROTO can be "tcp", "udp" or "all" for both.

       -z, --silent
              Do not perform the initial ARP scan of the LAN.

              NOTE: you will not have the hosts list, so  you  can't  use  the
              multipoison  feature.   you can only select two hosts for an ARP
              poisoning attack, specifying them through the TARGETs

       -p, --nopromisc
              Usually, ettercap will put the  interface  in  promisc  mode  to
              sniff  all  the  traffic  on the wire. If you want to sniff only
              your connections, use this flag to NOT enable the promisc mode.

       -u, --unoffensive
              Every time ettercap starts, it disables  ip  forwarding  in  the
              kernel and begins to forward packets itself. This option prevent
              to do that, so the responsibility of ip forwarding  is  left  to
              the kernel.
              This  options  is  useful  if  you want to run multiple ettercap
              instances. You will have one instance (the one  without  the  -u
              option)  forwarding  the  packets,  and  all the other instances
              doing their work without forwarding them. Otherwise you will get
              packet duplicates.
              It  also disables the internal creation of the sessions for each
              connection. It increases performances, but you will not be  able
              to modify packets on the fly.
              If  you  want  to  use  a mitm attack you have to use a separate
              instance.
              You have to use this option if  the  interface  is  unconfigured
              (without an ip address.)
              This  is also useful if you want to run ettercap on the gateway.
              It  will  not  disable  the  forwarding  and  the  gateway  will
              correctly route the packets.

       -j, --load-hosts <FILENAME>
              It  can  be used to load a hosts list from a file created by the
              -k option. (see below)

       -k, --save-hosts <FILENAME>
              Saves the hosts list to a file. Useful when you have many  hosts
              and  you  don't  want to do an ARP storm at startup any time you
              use ettercap. Simply use this options and dump  the  list  to  a
              file, then to load the information from it use the -j <filename>
              option.

       -P, --plugin <PLUGIN>
              Run the selected PLUGIN. Many plugins need target specification,
              use TARGET as always.
              In console mode (-C option), standalone plugins are executed and
              then the application exits. Hook plugins are activated  and  the
              normal sniffing is performed.
              To  have  a  list  of  the available external plugins use "list"
              (without quotes) as plugin name (e.g. ./ettercap -P list).

              NOTE: you can also activate plugins directly from the interfaces
              (always press "h" to get the inline help)

              More detailed info about plugins and about how to write your own
              are found in the man page ettercap_plugin(8)

       -F, --filter <FILE>
              Load the filter  from  the  file  <FILE>.  The  filter  must  be
              compiled  with  etterfilter(8).  The  utility  will  compile the
              filter script and produce an  ettercap-compliant  binary  filter
              file. Read the etterfilter(8) man page for the list of functions
              you can use inside a filter script.
              NOTE:  these  filters  are  different  from   those   set   with
              --pcapfilter.  An  ettercap  filter  is a content filter and can
              modify the payload of a packet before forwarding it. Pcap filter
              are used to capture only certain packets.
              NOTE: you can use filters on pcapfile to modify them and save to
              another file, but in this case you have to pay attention on what
              you  are  doing,  since ettercap will not recalculate checksums,
              nor split packets exceeding the mtu (snaplen) nor anything  like
              that.

       -W, --wep-key <KEY>
              You  can  specify  a  WEP  key to decrypt WiFi packets. Only the
              packets decrypted successfully will be passed  to  the  decoders
              stack, the others will be skipped with a message.
              The  parameter has the following syntax: N:T:KEY. Where N is the
              bit length of the wep key (64, 128 or 256), T is the type of the
              string  ('s'  for  string  and 'p' for passphrase). KEY can be a
              string or an escaped hex sequences.

              example:
              --wep-key 128:p:secret
              --wep-key 128:s:ettercapwep0
              --wep-key '64:s:\x01\x02\x03\x04\x05'

       -a, --config <CONFIG>
              Loads an alternative config  file  instead  of  the  default  in
              /etc/etter.conf.   This is useful if you have many preconfigured
              files for different situations.

       VISUALIZATION OPTIONS

       -e, --regex <REGEX>
              Handle only packets that match the regex.
              This option is useful in  conjunction  with  -L.  It  logs  only
              packets that match the posix regex REGEX.
              It  impacts even the visualization of the sniffed packets. If it
              is set only packets matching the regex will be displayed.

       -V, --visual <FORMAT>
              Use this option to set the visualization method for the  packets
              to be displayed.

              FORMAT may be one of the following:

              hex    Print the packets in hex format.

                     example:

                     the string  "HTTP/1.1 304 Not Modified"  becomes:

                     0000:  4854  5450 2f31 2e31 2033 3034 204e 6f74  HTTP/1.1
                     304 Not
                     0010: 204d 6f64 6966 6965 64                    Modified

              ascii  Print  only  "printable"  characters,  the   others   are
                     displayed as dots '.'

              text   Print  only  the  "printable"  characters  and  skip  the
                     others.

              ebcdic Convert an EBCDIC text to ASCII.

              html   Strip all the html tags from the text.  A  tag  is  every
                     string between < and >.

                     example:

                     <title>This  is  the  title</title>,  but  the  following
                     <string> will not be displayed.

                     This  is  the  title,  but  the  following  will  not  be
                     displayed.

              utf8   Print  the  packets  in  UTF-8  format. The encoding used
                     while  performing  the  conversion  is  declared  in  the
                     etter.conf(5) file.

       -d, --dns
              Resolve ip addresses into hostnames.

              NOTE:  this  may  seriously  slow  down  ettercap  while logging
              passive information.  Every time a new host is found, a query to
              the  dns  is  performed.  Ettercap  keeps  a  cache  for already
              resolved host to increase the speed, but new hosts  need  a  new
              query  and  the dns may take up to 2 or 3 seconds to respond for
              an unknown host.

              HINT: ettercap  collects  the  dns  replies  it  sniffs  in  the
              resolution  table,  so  even  if  you specify to not resolve the
              hostnames, some of them will be resolved because the  reply  was
              previously  sniffed.  think about it as a passive dns resolution
              for free... ;)

       -E, --ext-headers
              Print extended headers for every  displayed  packet.  (e.g.  mac
              addresses)

       -Q, --superquiet
              Super  quiet  mode. Do not print users and passwords as they are
              collected. Only store them in the profiles. It can be useful  to
              run  ettercap in text only mode but you don't want to be flooded
              with dissectors messages. Useful when using plugins because  the
              sniffing  process  is  always  active,  it  will  print  all the
              collected  infos,  with  this  option  you  can  suppress  these
              messages.
              NOTE: this options automatically sets the -q option.

              example:

              ettercap -TzQP finger /192.168.0.1/22

       LOGGING OPTIONS

       -L, --log <LOGFILE>
              Log  all  the packets to binary files. These files can be parsed
              by etterlog(8) to extract human readable data. With this option,
              all  packets  sniffed  by ettercap will be logged, together with
              all the passive info (host info + user & pass) it  can  collect.
              Given  a LOGFILE, ettercap will create LOGFILE.ecp (for packets)
              and LOGFILE.eci (for the infos).

              NOTE: if you specify this option on command line you don't  have
              to  take  care of privileges since the log file is opened in the
              startup phase (with high privs).  But  if  you  enable  the  log
              option  while  ettercap  is already started, you have to be in a
              directory where uid = 65535 or uid = EC_UID can write.

              NOTE: the logfiles can be compressed with the deflate  algorithm
              using the -c option.

       -l, --log-info <LOGFILE>
              Very  similar to -L but it logs only passive information + users
              and passwords for each host. The file will be named LOGFILE.eci

       -m, --log-msg <LOGFILE>
              It  stores  in  <LOGFILE>  all  the  user  messages  printed  by
              ettercap.  This  can  be  useful  when you are using ettercap in
              daemon mode or if you want  to  track  down  all  the  messages.
              Indeed,  some dissectors print messages but their information is
              not stored anywhere, so this is the only way to  keep  track  of
              them.

       -c, --compress
              Compress the logfile with the gzip algorithm while it is dumped.
              etterlog(8)  is  capable  of  handling   both   compressed   and
              uncompressed log files.

       -o, --only-local
              Stores profiles information belonging only to the LAN hosts.

              NOTE:  this  option  is  effective  only  against  the  profiles
              collected in memory.  While logging to a file ALL the hosts  are
              logged.  If  you want to split them, use the related etterlog(8)
              option.

       -O, --only-remote
              Stores profiles information belonging only to remote hosts.

       STANDARD OPTIONS

       -U, --update
              Connects to the ettercap website (ettercap.sf.net) and  retrieve
              the latest databases used by ettercap.
              If you want only to check if an update is available, prepend the
              -z option.  The order does matter: ettercap -zU

              SECURITY NOTE: The updates are not signed  so  an  attacker  may
              poison  your  DNS  server  and  force  the  updateNG.php to feed
              ettercap with fake databases.  This  can  harm  to  your  system
              since it can overwrite any file containing the string "Revision:
              ".

       -v, --version
              Print the version and exit.

       -h, --help
              prints the help screen with a short  summary  of  the  available
              options.

EXAMPLES

       Here are some examples of using ettercap.

       ettercap -Tp

              Use  the  console  interface  and  do  not  put the interface in
              promisc mode. You will see only your traffic.

       ettercap -Tzq

              Use the console interface, do not ARP scan the net and be quiet.
              The   packet  content  will  not  be  displayed,  but  user  and
              passwords, as well as other messages, will be displayed.

       ettercap -T -j /tmp/victims -M arp /10.0.0.1-7/ /10.0.0.10-20/

              Will load the hosts list from /tmp/victims and  perform  an  ARP
              poisoning attack against the two target. The list will be joined
              with  the  target  and  the  resulting  list  is  used  for  ARP
              poisoning.

       ettercap -T -M arp // //

              Perform  the  ARP  poisoning attack against all the hosts in the
              LAN. BE CAREFUL !!

       ettercap -T -M arp:remote /192.168.1.1/ /192.168.1.2-10/

              Perform the ARP poisoning against the gateway and  the  host  in
              the  lan  between  2 and 10. The 'remote' option is needed to be
              able to sniff the remote traffic  the  hosts  make  through  the
              gateway.

       ettercap -Tzq //110
              Sniff only the pop3 protocol from every hosts.

       ettercap -Tzq /10.0.0.1/21,22,23

              Sniff telnet, ftp and ssh connections to 10.0.0.1.

       ettercap -P list

              Prints the list of all available plugins

AUTHORS

       Alberto Ornaghi (ALoR) <alor@users.sf.net>
       Marco Valleri (NaGA) <naga@antifork.org>

SEE ALSO

       etter.conf(5)    ettercap_curses(8)   ettercap_plugins(8)   etterlog(8)
       etterfilter(8)

AVAILABILITY

       http://ettercap.sourceforge.net/download/

CVS

       cvs -d:pserver:anonymous@cvs.ettercap.sf.net:/cvsroot/ettercap login
       cvs    -d:pserver:anonymous@cvs.ettercap.sf.net:/cvsroot/ettercap    co
       ettercap_ng

BUGS

       Our software never has bugs.
       It just develops random features.   ;)

       KNOWN-BUGS

       -  ettercap doesn't handle fragmented packets... only the first segment
       will be displayed  by  the  sniffer.  However  all  the  fragments  are
       correctly forwarded.

       +    please    send    bug-report,    patches    or    suggestions   to
       <alor@users.sourceforge.net>                  or                  visit
       http://ettercap.sourceforge.net/forum/    and   post  it  in  the  BUGS
       section.

       + to report a bug, follow the instructions in the README.BUGS file

PHILOLOGICAL HISTORY

       "Even if blessed  with  a  feeble  intelligence,  they  are  cruel  and
       smart..."   this  is  the description of Ettercap, a monster of the RPG
       Advanced Dungeons & Dragon.

       The name "ettercap"  was  chosen  because  it  has  an  assonance  with
       "ethercap" which means "ethernet capture" (what ettercap actually does)
       and also because such monsters have a powerful poison... and you  know,
       arp poisoning... ;)

The Lord Of The (Token)Ring

       (the fellowship of the packet)

       "One Ring to link them all, One Ring to ping them,
        one Ring to bring them all and in the darkness sniff them."

Last words

       "Programming  today  is  a  race between software engineers striving to
       build bigger and better idiot-proof programs, and the  Universe  trying
       to  produce bigger and better idiots. So far, the Universe is winning."
       - Rich Cook