scanner

A port scanner written in Scala/Java, multi threaded of course.

Because I couldn't find a decent tool to scan networks looking for open ports, in Java, I decided to write one. Just a few lines of code, no exception handling, i.e. if it fails it fails, tant pis. No retry either as it turns out, who wants to retry 65535 * n address/port combinations, where n is the number of addresses to scan?

Having said that, it is multi threaded, which helps a lot. Note that there are at least 100 threads created, so probably not a good idea to run it on Android ;)

Please be responsible, i.e. no hacking. Remember, if you aren't getting paid for it what is the point, right?

Download the jar from Artifactory in the libs-release-local repository.

So, to run the scanner from the command line:

=> java -jar scanner.jar ip-range [port-range (eg. 0-1024, optional)] timeout(in milliseconds) [verbose] [force]

For example:

=> java -jar scanner-1.6.jar 192.168.1.1/24 0-1024 100 false true

Will scan the network from 0 - 255, ports 0 to 1024 with a timeout of 100 millis, not verbose and force all ip addresses, even if they seem not to be reachable using a ping echo(Java doesn't support real ICMP, some kind of ICMP echo they say, and iptables will return false incidentally, but not ufw, hmmm...).

There must be a lib folder in the execution folder, with the dependencies:

commons-net-2.0.jar
commons-lang-2.6.jar
scala-library-2.11.0-M3.jar
scala-reflect-2.11.0-M3.jar

The classpath in the manifest is lib/* in other words, so create a folder called 'lib' in the same directory as the scanner.jar, and put the above libraries in it.

To use from a Java/Scala app just instantiate the class new Scanner() and call whatever methods you want to. Three methods, one that takes an ip range and scans the entire network range, every port. One that takes the ip range and a port range, also the entire network range but only the ports specified, and one that takes the ip range, a list of specified ports and a timeout, which scans only the ports defined on the range defined.

=> List addressesAndPorts = Scanner.scan("192.168.1.1/24", 60000, Boolean.FALSE, Boolean.TRUE);

JavaDoc all done of course, with live examples in the unit test.

=> https://github.com/michaelcouck/scanner/blob/master/src/test/java/ikube/scanner/ScannerTest.scala

Feel free to contact me if you have issues/feature requests, or want to contribute/fix something - michael dot couck at gmail dot com.