2014-09-07 17:28:10 +02:00
|
|
|
ponymap
|
|
|
|
|
=======
|
|
|
|
|
|
2015-09-27 01:51:09 +02:00
|
|
|
'ponymap' is an experimental network scanner, of alpha quality so far.
|
2014-09-07 17:28:10 +02:00
|
|
|
|
2014-09-15 00:56:06 +02:00
|
|
|
Replacing nmap is not the goal, even though it would be rather very nice to
|
2014-09-21 00:59:31 +02:00
|
|
|
have a serious network scanner with a permissive license.
|
2014-09-15 00:56:06 +02:00
|
|
|
|
2014-09-07 17:28:10 +02:00
|
|
|
The ultimate purpose of this scanner is bruteforcing hosts and ports in search
|
2014-09-21 00:59:31 +02:00
|
|
|
of running services of a kind. It should be simple and straight-forward to
|
|
|
|
|
either write your own service detection plugins, provided that you're familiar
|
|
|
|
|
with writing asynchronous code, or to make changes to the existing ones.
|
2014-09-07 17:28:10 +02:00
|
|
|
|
2014-09-24 00:10:56 +02:00
|
|
|
So far there are some problems with reliability, and some clever algorithm to
|
|
|
|
|
avoid overloading the network is needed. Until then, you can use ulimit to cap
|
|
|
|
|
the maximum number of concurrent connections.
|
|
|
|
|
|
2016-03-11 20:34:38 +01:00
|
|
|
Packages
|
|
|
|
|
--------
|
|
|
|
|
Regular releases are sporadic. git master should be stable enough. You can get
|
2018-06-24 05:11:36 +02:00
|
|
|
a package with the latest development version from Archlinux's AUR.
|
2016-03-11 20:34:38 +01:00
|
|
|
|
|
|
|
|
Building and Usage
|
|
|
|
|
------------------
|
2015-09-27 01:51:09 +02:00
|
|
|
Build dependencies: CMake, pkg-config, help2man +
|
2015-02-26 22:58:00 +01:00
|
|
|
Runtime dependenices: curses, openssl, Jansson, lua = 5.3 (optional)
|
2014-09-07 17:28:10 +02:00
|
|
|
|
2018-06-24 05:11:36 +02:00
|
|
|
$ git clone --recursive https://git.janouch.name/p/ponymap.git
|
2015-09-27 01:51:09 +02:00
|
|
|
$ mkdir ponymap/build
|
|
|
|
|
$ cd ponymap/build
|
2015-10-01 22:52:49 +02:00
|
|
|
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
|
2014-09-07 17:28:10 +02:00
|
|
|
$ make
|
|
|
|
|
|
2015-01-17 15:54:49 +01:00
|
|
|
To install the application, you can do either the usual:
|
2015-09-27 01:51:09 +02:00
|
|
|
|
2015-02-26 22:58:00 +01:00
|
|
|
# make install
|
2014-09-07 17:28:10 +02:00
|
|
|
|
2015-01-17 15:54:49 +01:00
|
|
|
Or you can try telling CMake to make a package for you. For Debian it is:
|
2015-09-27 01:51:09 +02:00
|
|
|
|
2015-01-17 15:54:49 +01:00
|
|
|
$ cpack -G DEB
|
|
|
|
|
# dpkg -i ponymap-*.deb
|
2014-09-07 17:28:10 +02:00
|
|
|
|
2015-09-27 01:51:09 +02:00
|
|
|
Note that for versions of CMake before 2.8.9, you need to prefix `cpack` with
|
|
|
|
|
`fakeroot` or file ownership will end up wrong.
|
2015-01-17 15:54:49 +01:00
|
|
|
|
|
|
|
|
Having the program installed, simply run it with no arguments to retrieve
|
|
|
|
|
a usage text. Have fun scanning.
|
2014-09-07 17:28:10 +02:00
|
|
|
|
2014-09-24 00:10:56 +02:00
|
|
|
Author's Notes
|
|
|
|
|
--------------
|
|
|
|
|
This was quite an interesting project to write and it has taught me a lot about
|
|
|
|
|
event loops. It would be relatively simple to plug in libuv if more robustness
|
|
|
|
|
and portability is needed, though.
|
|
|
|
|
|
2015-09-27 01:51:09 +02:00
|
|
|
Contributing and Support
|
|
|
|
|
------------------------
|
2018-06-24 05:11:36 +02:00
|
|
|
Use https://git.janouch.name/p/ponymap to report any bugs, request features,
|
|
|
|
|
or submit pull requests. `git send-email` is tolerated. If you want to discuss
|
|
|
|
|
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
|
2015-09-27 01:51:09 +02:00
|
|
|
|
2018-06-24 05:11:36 +02:00
|
|
|
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
|
2017-06-07 20:28:07 +02:00
|
|
|
|
2014-09-07 17:28:10 +02:00
|
|
|
License
|
|
|
|
|
-------
|
2018-06-24 05:11:10 +02:00
|
|
|
This software is released under the terms of the 0BSD license, the text of which
|
|
|
|
|
is included within the package along with the list of authors.
|
