ziterate - Man Page

ZMap IP permutation generation file


ziterate [ -b <blocklist> ] [ -w <allowlist> ] [ Options... ]


ZIterate is a network tool that will produce IPv4 addresses in a psuedorandom order similar to how ZMap generates random addresses to be scanned.


Basic Options

-b, --blocklist-file=path

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 blacklist.conf for this purpose.

-w, --allowlist-file=name

File of subnets to include, in CIDR notation, one-per line. All other subnets will be excluded.

-l, --log-file=name

File to log to.


Disable logging messages to syslog.

-v,  --verbosity

Level of log detail (0-5, default=3)


Ignore invalid entries in the blocklist. Default is false.


Seed used to select address permutation.

-n, --max-targets=n

Cap number of IPs to generate (as a number or a percentage of the address space)



Total number of shards.


Shard this scan is targeting. Zero indexed.

Additional Options

-h,  --help

Print help text and exit.

-V,  --version

Print version and exit.


June 2017 ZMap