doscan
======

This is doscan, a tool for auditing your network.

Prerequisites
-------------

In order to compile doscan, you need:

   * a GNU/Linux system, or Sun Solaris 8/9

     doscan requires poll(2), but should be quite portable otherwise.

     However, Linux 2.6 (or another kernel with the syscall-based
     epoll patch) is strongly recommended.

   * The GNU C and C++ compilers, version 3.2 or later
     (version 3.3 is preferred)

     Other C and C++ compilers might work, but have not been tested.

   * GNU make

   * the PCRE library (version 4.3 works)

Installation
------------

Invoke './configure' (see './configure --help' for further
instructions), run 'make', then 'make install'.  Default installation
directory is /usr/local.

Usage
-----

The program is documented in its manual page, doscan(1).  For a quick
start, invoke doscan this way:

  doscan --port 80 192.168.0.0/16

Only single ports and prefixes are accepted, neither port ranges, nor
individual hosts (use a /32 prefix for single hosts).

doscan uses connect(2) and does not directly require root privileges,
but if you want to raise the file descriptor limits, you have to be root
(see the CAVEATS section in the manual page).

Future Development
------------------

Development of doscan has been suspend.  I will incorporate bug fixes,
but no new scanning modules will be added.  See doc/design.txt for
some background information.

Reporting Bugs
--------------

Please report bugs to <doscan-bugs@lists.enyo.de>.

Florian Weimer <fw@deneb.enyo.de>
