.. _pktizr(1):

pktizr
======

SYNOPSIS
--------

.. program:: pktizr

**pktizr <targets> [options]**

DESCRIPTION
-----------

**pktizr** is a command-line packet generator and analyzer. It lets you generate
custom IP/ICMP/TCP/UDP packets, send them over the network and analyze replies
using Lua scripts.

OPTIONS
-------

.. option:: -S, --script=<file>

Load and run the given script.

.. option:: -p, --ports=<ranges>

Use the specified port ranges.

.. option:: -r, --rate=<packets_per_second>

Send packets no faster than the specified rate [default: 100].

.. option:: -s, --seed=<seed>

Use the given number as seed value.

.. option:: -w, --wait=<seconds>

Wait the given amount of seconds after the scan is complete [default: 5].

.. option:: -c, --count=<count>

Send the given amount of duplicate packets [default: 1].

.. option:: -R, --shuffle

Shuffle the target IP addresses and ports, instead of processing them in order.

.. option:: -l, --local-addr=<addr>

Specify the source IP address. This value can be accessed by scripts using the
:func:`get_addr` function. By default the configured address of the network
interface will be used.

.. option:: -g, --gateway-addr=<addr>

Specify the gateway IP address. By default the configured address of the network
interface's default route will be used.

.. option:: -n, --netdev=<dev>

Specify the netdev driver to use, instead of the default one.

Available netdev drivers are:

``pfring`` (Linux only)
    PF_RING netdev driver.

``pcap``
    libpcap netdev driver.

``sock`` (Linux only)
    AF_PACKET netdev driver.

.. option:: -q, --quiet

Don't show the status line.

AUTHOR
------

Alessandro Ghedini <alessandro@ghedini.me>

COPYRIGHT
---------

Copyright (C) 2015 Alessandro Ghedini <alessandro@ghedini.me>

This program is released under the 2 clause BSD license.