Skip to content

Commit

Permalink
README, LICENSE & .gitignore
Browse files Browse the repository at this point in the history
  • Loading branch information
Gregwar committed Feb 28, 2014
1 parent 490031c commit 674086f
Show file tree
Hide file tree
Showing 4 changed files with 66 additions and 13 deletions.
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
**.o
**.a
**.os.*
mitm
19 changes: 19 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
Copyright (c) <2010-2014> Grégoire Passault

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is furnished
to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
13 changes: 0 additions & 13 deletions README

This file was deleted.

43 changes: 43 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Mtm - Man in the middle tool

## Presentation

This tool can be use to perform a man in the middle using ARP
poisoning on two given hosts.

Using osdep, a tunnel creation library which is part of the
aircrack project, it can set up an interface (`mitm0`) in which
the replayed packets will be written (to sniff easily).

This tool is useful for network debugging and monitoring, and
was NOT designed for malicious usage.

## Building & using

You'll need the lib pcap:

```
apt-get install libcap0.8-dev
```

To build it, symply run:

```
make
```

The usage is:

```
MitM v0.23 by GregWar
Usage: mitm -i interface [-t] ip1 ip2
-i interface: specify network interface to use
ip1: The IP adress of the first victim
ip2: The IP adress of the second victim
-t: Create a TAP interface containing the
replayed packets (in order to sniff)
```

## License

This is under the MIT license

0 comments on commit 674086f

Please sign in to comment.