From d92914a5f97fe418767f851cc1605bde511cdb62 Mon Sep 17 00:00:00 2001 From: alexej996 Date: Tue, 6 Nov 2018 03:12:13 +0100 Subject: help change, default timeout set to 3, README rework --- README.md | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 647f5a0..9bffbea 100644 --- a/README.md +++ b/README.md @@ -2,19 +2,24 @@ This port scanner was orginally made by [Stevan Nestorovic](https://github.com/stevannestorovic) to work over clearnet. -It was modifed to work over Tor for anonymous scanning. +It was modifed to work over **Tor** for anonymous and hidden service scanning. ### Dependencies -Tmap is a python script that requries a socks module and a running Tor deamon on localhost. +Tmap is a python script that requries the **socks** module and a running Tor deamon on localhost. +Both **python2** and **pyhton3** are supported. ### Usage: `./tmap [-h] -H HOSTS [-p PORTS] [-t TIMEOUT] [--clearnet] [--torport TORPORT]` -Multiple hosts can be specified using a comma (-H 1.1.1.1,2.2.2.2). +`-H` option can be used to specify hosts, but it is assumed by default. +Multiple hosts can be specified using a comma (ex. `./tmap -H 1.1.1.1,google.com,facebookcorewwwi.onion -p 80`). +Tmap supports IP address ranges as well (ex. `./tmap 192.168.1.0/24 -p 22`). -Ports can be either specified as a range (-p 20-100) or separated with a comma (-p 25,53,80). +**For private addresses, Tor is _not_ used, but a _direct_ connection is established instead.** +Ports can be specified as a range (ex. `./tmap google.com -p 20-30`),separated with a comma (ex. `./tmap 1.1.1.1 -p 25,53,80`) or both. +Ports in a range are scanned including the ends of an interval (ex. in a range "20-30" both port 20 and 30 are scanned). ### Examples @@ -30,5 +35,15 @@ Scan port 80 on facebookcorewwwi.onion Scan ports from 0 to 1024 on 192.168.0.1 without routing traffic through Tor. +`./tmap 192.168.1.0/24 -p 80` + +Scan the whole 192.168.1.0/24 range for an open port 80 without tor. + +`./tmap 8.8.8.8/31 -p 53` + +Scan the 8.8.8.8/31 range for an open port 53 with tor. + ### License -**GPL3** +**GPLv3+**: GNU GPL version 3 or later +This is *free* software: you are free to change and redistribute it. +There is **NO WARRANTY**, to the extent permitted by law. -- cgit v1.2.3