From 58b4b2d06da6c0c8da7a21f85f8b8ddafdc70dbd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?P=C5=99emysl=20Janouch?= Date: Sun, 27 Sep 2015 01:51:09 +0200 Subject: Convert README to AsciiDoc --- README | 58 ---------------------------------------------------------- 1 file changed, 58 deletions(-) delete mode 100644 README (limited to 'README') diff --git a/README b/README deleted file mode 100644 index ade0cce..0000000 --- a/README +++ /dev/null @@ -1,58 +0,0 @@ -ponymap -======= - -`ponymap' is an experimental network scanner, of alpha quality so far. - -Replacing nmap is not the goal, even though it would be rather very nice to -have a serious network scanner with a permissive license. - -The ultimate purpose of this scanner is bruteforcing hosts and ports in search -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. - -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. - -Building and Running --------------------- -Build dependencies: CMake, pkg-config, help2man -Runtime dependenices: curses, openssl, Jansson, lua = 5.3 (optional) - - $ git clone https://github.com/pjanouch/ponymap.git - $ git submodule init - $ git submodule update - $ mkdir build - $ cd build - $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug -DWITH_LUA=NO - $ make - -To install the application, you can do either the usual: - # make install - -Or you can try telling CMake to make a package for you. For Debian it is: - $ cpack -G DEB - # dpkg -i ponymap-*.deb - -Note that for versions of CMake before 2.8.9, you need to prefix cpack with -`fakeroot' or file ownership will end up wrong. - -Having the program installed, simply run it with no arguments to retrieve -a usage text. Have fun scanning. - -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. - -License -------- -`ponymap' is written by Přemysl Janouch . - -You may use the software under the terms of the ISC license, the text of which -is included within the package, or, at your option, you may relicense the work -under the MIT or the Modified BSD License, as listed at the following site: - -http://www.gnu.org/licenses/license-list.html -- cgit v1.2.3