zmap-freebsd/examples/banner-grab-go
2013-08-29 15:11:18 -04:00
..
banner.go Added experimental banner grabber implemented in Go. 2013-08-29 15:00:34 -04:00
http-req Added experimental banner grabber implemented in Go. 2013-08-29 15:00:34 -04:00
README Correct README 2013-08-29 15:11:18 -04:00

TCP banner grabber implemented in Go  (experimental)
======

This program will make TCP connections to IP addresses provide on
stdin, optionally send them a short message, and wait for their
responses. Each response is printed to stdout, along with the
responding host's IP address. Status messages appear on stderr.

USING:
-----
go build banner.go
zmap -p 80 -N 1000 -o - | ./banner -port 80 -concurrent 100 -data http-req > banners.out


OPTIONS:
-----
-concurrent        Number of connections that can be going on at once.
                   This, combined with timeouts, will decide the maximum
                   rate at which banners are grabbed. If this value
                   is set higher than 1000, you should use 
                   `ulimit -SHn 1000000` and `ulimit -SSn 1000000` to
                   avoid running out of file descriptors (typically capped
                   at 1024). Default: 100.

-port              The port which to connect to hosts on. Default: 80.

-timeout           Connection timeout (seconds). Give up on a host if grabber
                   has not completed by this time. Default: 4 seconds.

-format            Format to output banner responses. One of 'hex', 'ascii',
                   or 'base64'. Default: ascii.

--data             Optional data file. This data will be sent to each host
                   upon successful connection. Occurrences of the
                   string '%s' will be replaced with the current
                   target host's address.