README for ipflood

Download area
==================
README for ipflood
==================


LICENSE

        The ipflood software is in public domain. 

        THERE IS ABSOLUTELY NO WARRANTY. USE AT YOUR OWN RISK.


DESCRIPTION

        ipflood sends UDP segments to port 5001 on a selected
        host. It's intended to congest IP network links for testing
        purposes.


FEATURES

        - Every UDP message is 8192 bytes long and contains garbage
        (random bytes).

        - By default, it sends unlimited UDP messages (infinite loop)
        as fast as possible.

        - One can limit the number of UDP messages by using the
        "count" argument. A negative value specifies an unlimited
        number of messages.

        - One can introduce delay between the UDP messages by
        specifying the "udelay" factor in microseconds.

        - One must specify a local address as source address for the
        messages.


BUILD

        Just type:
        
                make

        Once the compilation is finished, you may want to run 'strip'
        on your 'ipflood' executable:
        
                strip ipflood


INSTALL

        Copy the 'ipflood' program to a suitable location
        (e.g. /usr/local/bin).


USAGE

        Syntax: ipflood [count] [udelay]

        The program reads addresses from the standard input. It
        expects one pair per line, as follows:

                source-address-1 destination-address-1
                ...
                source-address-N destination-address-N

        The source addresse(s) must be previously assigned to local
        interface(s).


EXAMPLES

        #
        # Send unlimited messages as fast as possible
        #
        ipflood
        192.168.0.1 10.0.0.1
        ^D

        #
        # One can use hostnames instead of addresses
        #
        ipflood 
        localhost target.localhost
        ^D

        #
        # Send only 1000 messages, as fast as possible
        #
        ipflood 1000
        10.0.0.1 10.0.0.2
        ^D

        #
        # Send unlimited messages, but only one per second 
        #
        ipflood -1 1000000
        10.0.0.1 10.0.0.2
        ^D

        #
        # Send unlimited messages, but only one per second 
        #
        ipflood -1 1000000
        10.0.0.1 10.0.0.2
        ^D

        #
        # Send 100 messages as fast as possible
        # * 1/3 of the messages are sent from 10.0.0.1 to 11.0.0.1
        # * 1/3 of the messages are sent from 10.0.0.2 to 11.0.0.2
        # * 1/3 of the messages are sent from 10.0.0.3 to 11.0.0.3
        #
        ipflood 100
        10.0.0.1 11.0.0.1
        10.0.0.2 11.0.0.2
        10.0.0.3 11.0.0.3
        ^D


FINAL NOTE

        The source code is pretty simple. Users are encouraged to make
        improvements as they need. Enjoy!


AUTHOR

        Everton da Silva Marques
        evertonsm at yahoo dot com dot br


-x-