zmap-freebsd/examples/banner-grab-go/README

37 lines
1.5 KiB
Plaintext
Raw Normal View History

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.
-d, --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.