zmap-mark-ii/src/ziterate.1

75 lines
1.9 KiB
Groff

.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "ZITERATE" "1" "September 2023" "ZMap" "ziterate"
.
.SH "NAME"
\fBziterate\fR \- ZMap IP permutation generation file
.
.SH "SYNOPSIS"
ziterate [ \-b <blocklist> ] [ \-w <allowlist> ] [ OPTIONS\.\.\. ]
.
.SH "DESCRIPTION"
\fIZIterate\fR is a network tool that will produce IPv4 addresses in a psuedorandom order similar to how ZMap generates random addresses to be scanned\.
.
.SH "OPTIONS"
.
.SS "BASIC OPTIONS"
.
.TP
\fB\-p\fR, \fB\-\-target\-ports=port(s)\fR
List of TCP/UDP ports and/or port ranges to scan\. (e\.g\., 80,443,100\-105)\. Use \'*\' to scan all ports, including port 0\. If no port is specified, ziterate will output only IPs\.
.
.TP
\fB\-b\fR, \fB\-\-blocklist\-file=path\fR
File of subnets to exclude, in CIDR notation, one\-per line\. It is recommended you use this to exclude RFC 1918 addresses, multicast, IANA reserved space, and other IANA special\-purpose addresses\. An example blocklist file \fBblocklist\.conf\fR for this purpose\.
.
.TP
\fB\-w\fR, \fB\-\-allowlist\-file=name\fR
File of subnets to include, in CIDR notation, one\-per line\. All other subnets will be excluded\.
.
.TP
\fB\-l\fR, \fB\-\-log\-file=name\fR
File to log to\.
.
.TP
\fB\-\-disable\-syslog\fR
Disable logging messages to syslog\.
.
.TP
\fB\-v\fR, \fB\-\-verbosity\fR
Level of log detail (0\-5, default=3)
.
.TP
\fB\-\-ignore\-blocklist\-errors\fR
Ignore invalid entries in the blocklist\. Default is false\.
.
.TP
\fB\-\-seed=n\fR
Seed used to select address permutation\.
.
.TP
\fB\-n\fR, \fB\-\-max\-targets=n\fR
Cap number of IPs to generate (as a number or a percentage of the address space)
.
.SS "SHARDING"
.
.TP
\fB\-\-shards=n\fR
Total number of shards\.
.
.TP
\fB\-\-shard=n\fR
Shard this scan is targeting\. Zero indexed\.
.
.SS "ADDITIONAL OPTIONS"
.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help text and exit\.
.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version and exit\.