summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorJake Mannens <jakem_5@hotmail.com>2016-04-05 13:52:34 +1000
committerJake Mannens <jakem_5@hotmail.com>2016-04-05 13:52:34 +1000
commit65ce53bab412623b6b7b39f2fba3536619175537 (patch)
treeb038ee9203db4e922289e3b683c83e044edb1c1e /man
new file: Makefile
new file: build.sh new file: man/flood.1.pod new file: package/DEBIAN/control new file: package/usr/share/doc/flood/README.gz new file: package/usr/share/doc/flood/changelog.gz new file: package/usr/share/doc/flood/copyright new file: package/usr/share/man/man1/flood.1.gz new file: source/Makefile new file: source/flood.c new file: version
Diffstat (limited to 'man')
-rw-r--r--man/flood.1.pod83
1 files changed, 83 insertions, 0 deletions
diff --git a/man/flood.1.pod b/man/flood.1.pod
new file mode 100644
index 0000000..4790741
--- /dev/null
+++ b/man/flood.1.pod
@@ -0,0 +1,83 @@
+=head1 NAME
+
+flood - perform a DoS attack
+
+=head1 SYNOPSIS
+
+Flood the target computer with packets.
+
+B<flood> [ B<-d> I<seconds> ] [ B<-s> I<bytes> ] [ B<-t> I<threads> ] I<address>
+
+=head1 DESCRIPTION
+
+B<flood> is a program designed to perform a DoS (denial-of-service) attack
+against a target computer. The target can either be a host on a local
+network, a host on the Internet or any other reachable IPv4 destination.
+
+=head2 Types of Attack
+
+B<flood> can currently execute two different types of DoS attacks; a UDP
+flood and a SYN flood.
+
+=head3 UDP Flood
+
+A UDP flood involves sending UDP packets of a fixed length carrying
+arbitrary data. The packets are given random source addresses as well as
+random source and destination ports. This attack primarily relies on the
+volume of packets being transmitted to overwhelm a target. A UDP flood
+can also strain a target of other resources such as memory and processor
+time. When an most operating systems receive a UDP packet on a closed port,
+they respond with an ICMP packet to indicate the failure. Transmitting
+these ICMP packets also costs the target valueable resources.
+
+=head3 SYN Flood
+
+A SYN flood involves sending TCP SYN (synchronize) packets to the target.
+The goal of this attack is to starve the targets possible clients by
+creating dozens of 'half-open' connections.
+
+=head1 OPTIONS
+
+The following options are accepted:
+
+=over 8
+
+=item B<-d> I<seconds>
+
+Specify the duration of the attack in seconds.
+
+=item B<-s> I<bytes>
+
+Overrides the default packet size.
+
+=item B<-t> I<threads>
+
+Set the number of threads to attack with.
+
+=item I<address>
+
+Target host to attack. I<address> can either be an IPv4
+address or a DNS hostname. DNS names will automatically
+be resolved.
+
+=back
+
+=head1 RETURN VALUE
+
+Exit status is 0 if B<flood> is able to begin the attack without
+any errors. If errors occur (such as the result of a bad address),
+the exit status is -1.
+
+=head1 EXAMPLES
+
+B<flood> -d 60 example.com
+
+Floods I<example.com> for 1 minute.
+
+=head1 AUTHOR
+
+Jake Mannens <jakem_5@hotmail.com>
+
+=head1 SEE ALSO
+
+B<tcp>(7), B<udp>(7).