NAME

hyenae - Advanced Network Packet Generator

SYNOPSIS

hyenae (Starts attack assistant...)

hyenae fe_stop (Creates a frontend stop condition file,
should only be used by the HyenaeFE frontend)

hyenae -l (Prints all available network interfaces and exits)

hyenae -L (Prints all available attacks and exits)

hyenae -V (Prints version and exits)

hyenae -a arp-reply
-i | -I [Network interface name | index]
-s [Src HW-Address]
-d [Dst HW-Address]
-S [Snd HW-Address]-[Snd IP-Address (IPv4 only)]
-D [Trg HW-Address]-[Trg IP-Address (IPv4 only)]

OPTIONAL:
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a arp-request
-i | -I [Network interface name | index]
-s [Src HW-Address]
-d [Dst HW-Address]
-S [Snd HW-Address]-[Snd IP-Address (IPv4 only)]
-D [Trg HW-Address]-[Trg IP-Address (IPv4 only)]

OPTIONAL:
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a pppoe-discover
-i | -I [Network interface name | index]
-s [Src HW-Address]
-d [Dst HW-Address]

OPTIONAL:
-o [PPPoE Discovery Code]
-q [PPPoE Session ID Offset]
-Q [PPPoE Session ID Incrementation Steps]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a icmp-echo
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 or IPv6)]
-d [Dst HW-Address]-[Dst IP-Address (IPv4 or IPv6)]

OPTIONAL:
-t [IP Time To Live (TTL)]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-A [Assumed IP-Address version on random address strips]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a icmp-unreach-tcp
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 only)]
-d [Dst HW-Address]-[Dst IP-Address (IPv4 only)]
-S [TCP Src HW-Address]-[TCP Src IP-Address (IPv4 only)]@[TCP Src Port]
-D [TCP Dst HW-Address]-[TCP Dst IP-Address (IPv4 only)]@[TCP Dst Port]

OPTIONAL:
-o [ICMP Message Code]
-t [IP Time To Live (TTL)]
-k [TCP Achnkowledgement Number]
-w [TCP Window Size]
-q [TCP Sequence Number Offset]
-Q [TCP Sequence Number Incrementation Steps]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a tcp
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 or IPv6)]@[Src Port]
-d [Dst HW-Address]-[Dst IP-Address (IPv4 or IPv6)]@[Dst Port]
-f [TCP-Flags]

OPTIONAL:
-t [IP Time To Live (TTL)]
-k [TCP Achnkowledgement Number]
-w [TCP Window Size]
-q [TCP Sequence Number Offset]
-Q [TCP Sequence Number Incrementation Steps]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-A [Assumed IP-Address version on random address strips]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a udp
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 or IPv6)]@[Src Port]
-d [Dst HW-Address]-[Dst IP-Address (IPv4 or IPv6)]@[Dst Port]

OPTIONAL:
-t [IP Time To Live (TTL)]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-A [Assumed IP-Address version on random address strips]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a dns-query
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 or IPv6)]
-d [Dst HW-Address]-[Dst IP-Address (IPv4 or IPv6)]
-y [DNS query pattern]

OPTIONAL:
-t [IP Time To Live (TTL)]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-A [Assumed IP-Address version on random address strips]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a dhcp-discover
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 only)]
-d [Dst HW-Address]-[Dst IP-Address (IPv4 only)]

OPTIONAL:
-t [IP Time To Live (TTL)]
-S [Req IP-Address (IPv4 only)]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a dhcp-request
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 only)]
-d [Dst HW-Address]-[Dst IP-Address (IPv4 only)]
-D [Srv IP-Address (IPv4 only)]

OPTIONAL:
-t [IP Time To Live (TTL)]
-S [Req IP-Address (IPv4 only)]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a dhcp-release
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 only)]
-d [Dst HW-Address]-[Dst IP-Address (IPv4 only)]
-D [Srv IP-Address (IPv4 only)]

OPTIONAL:
-t [IP Time To Live (TTL)]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a hsrp-hello
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 only)]
-d [Virtual IP-Address (IPv4 only)]
-z [HSRP Priority]

OPTIONAL:
-t [IP Time To Live (TTL)]
-o [HSRP State Code]
-h [HSRP Auth. Data]
-g [HSRP Group Number]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a hsrp-coup
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 only)]
-d [Virtual IP-Address (IPv4 only)]
-z [HSRP Priority]

OPTIONAL:
-t [IP Time To Live (TTL)]
-o [HSRP State Code]
-h [HSRP Auth. Data]
-g [HSRP Group Number]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

hyenae -a hsrp-resign
-i | -I [Network interface name | index]
-s [Src HW-Address]-[Src IP-Address (IPv4 only)]
-d [Virtual IP-Address (IPv4 only)]
-z [HSRP Priority]

OPTIONAL:
-t [IP Time To Live (TTL)]
-o [HSRP State Code]
-h [HSRP Auth. Data]
-g [HSRP Group Number]
-p | -P [Random payload length | Payload file]
-r | -R [remote daemon address (Single) | address file (Clustered)]
-c [Min packet count]
-C [Max packet count]
-e [Min send delay (ms)]
-E [Max send delay (ms)]
-u [Min attack duration (ms)]
-U [Max attack duration (ms)]
-m (Set to ignore MTU limit)
-N (Set for cold run)

DESCRIPTION

Hyenae is a highly flexible and platform independent network packet generator. It allows you to reproduce low level ethernet attack scenarios (such as MITM, DoS and DDoS) to reveal potential security vulnerabilities of your network. Besides smart wildcard-based address randomization, a highly customizable packet generation control and an interactive attack assistant, Hyenae comes with a clusterable remote daemon for setting up distributed attack networks.

Hyenae was developed with ease-of-use in mind while still remaining flexible and configurable. To realize this aim, Hyenae uses address patterns, which will minimize the number of arguments you have to provide because all necessary parameters, such as the way you want to randomize your addresses or the IP address version to use, can be derived from the pattern format you provided. See Hyenae Users Manual, "Address Patterns", for more detailed information.

This utility suite was developed only for network security testing purposes such as evaluation of firewall rules, flood detection and intrusion detection. Hyenae's developers disclaim all liability for any direct, indirect or consequential damages arising out of or connected with the use or misuse of Hyenae Utility Suite. The user alone assumes all risks and responsibility of his/her own actions associated with the use of the Hyenae Utility Suite. Every effort has been made to supply accurate information related to Hyenae. It is subject to change without prior notice.

OPTIONS

-s Source address pattern

-d Destination address pattern.
Is also used to define the virtual
IP-Address pattern on HSRP based
attacks.

-S Secondary source address
pattern. Defines the sender address
on ARP-Reply attacks, the requested
IP-Address on DHCP-Based attacks
and the TCP source address pattern
on TCP based ICMP "Destination
Unreachable" attacks.

-D Secondary destination address
pattern. Defines the target address on
ARP-Based attacks, the server
identifier (IP-Address) on DHCP-Release
attacks and the TCP destination
address pattern on TCP based ICMP
"Destination Unreachable" attacks.

-i Network interface to operate on
(specified by name). This argument is
ignored on remote attacks.

-I Network interface to operate on
(specified by index). A list of all
available network interfaces and their
indexes can be obtained by starting
Hyenae with the -l option. This
argument is ignored on remote attacks.

-r Single remote attack. If set,
Hyenae will execute the specified
attack on the Hyenae Daemon specified
by the given server address pattern. A
server address pattern has the
following pattern format:

// For plain connections
[IP-Address]@[Port]

// For password protected daemons
[IP-Address]@[Port]+[Password]

Hyenae will automatically recognize
the provided IP address version.
Wildcards are not valid within server
address patterns. The password strip
is only required when connecting to a
Hyenae Daemon which has activated
password authentication. Note: Since
Hyenae currently does not support
encrypted communication, your password
is transferred in plain text, and can
be logged by others.

-R Clustered remote attack. If set,
Hyenae will simultaneously execute the
specified attack using the Hyenae
Daemons specified in the server file
at the given path. A server list file
should have the following format:

# Comment
Server=[IP-Address]@[Port]
Server=[IP-Address]@[Port]+[Password]
...

Hyenae will automatically recognize
the provided IP address version.
Wildcards are not valid within server
address patterns. The password strip
is only required when connecting to a
Hyenae Daemon which has activated
password authentication. Note: Since
Hyenae currently does not support
encrypted communication, your password
is transferred in plain text, and can
be logged by others.

-a Attack type. A list of all
available attacks can be obtained by
starting Hyenae with the -L option.

-A IP address version to assume
when a completely random IP strip is
found within an address pattern. This
value can be either 4 or 6. By default
this is set to 4 (IPv4).

-t Defines the hop limit (TTL) on
IP based attacks. The hop limit can be
a value between 1 and 255. If not set,
a hop limit size of 128 will be used.

-o Defines the ICMP "Destination
Unreachable" message code on ICMP
"Destination Unreachable" based
attacks, the PPPoE discover code on
PPPoE-Discover based attacks or the
HSRP state code on HSRP based attacks.

Valid values on PPPoE attacks:

padi (Active Discovery Initiation)
padt (Active Discovery Termination)

If not set, the default value is 'padi'.

Valid values on ICMP attacks:

network (Network Unreachable)
host (Host Unreachable)
protocol (Protocol Unreachable)
port (Port Unreachable)

If not set, the default value is 'network'.

Valid values on HSRP attacks:

init
learn
listen
speak
standby
active

If not set, the default value is 'init'.

-f TCP flags. This option is
required on TCP attacks and defines
the TCP control flags to set for the
generated packets. Valid values are
any combination of:

F (FIN)
S (SYN)
R (RST)
P (PSH)
A (ACK)

-k TCP acknowledgement number.
Defines the TCP acknowledgement number
to use on TCP based attacks. If not
set or set to 0, an acknowledgement
number of 0 will be used.

-w TCP window size. Defines the TCP
window size to use on TCP based
attacks. If not set or set to 0, a
window size of 0 will be used.

-q TCP sequence number / PPPoE
session id. Defines the TCP sequence
number on TCP based, or the session id
on PPPoE-Discover based attacks. If not
set or set to 0 on TCP based attacks,
every generated packet (unless a step
value was given) will carry a completely
randomized sequence number. If set to 0
on PPPoE attacks, every generated packet
(unless a step value was given) will
carry the session id 0. If a sequence
number or session id incrementation step
value was given, this argument will be
used as the initial sequence number or
session id to be incremented.

-Q TCP sequence number / PPPoE
session id incrementation steps. If
set, the sequence number or session id
of every generated packet will be
incremented by the given value.

-y DNS query pattern. A DNS
query pattern is required on
DNS-Query based attacks to define
the list of domain names to query.
The list should have the following
format:

# Single DNS query
[www.domain1.com]

# Multiple DNS queries
[www.domain1.com],[www.domain2.com],...

-h Defines the HSRP authentification
data field value and is required on
HSRP based attacks. If not set, the
default auth. data will be used
instead. Auth. data values must not be
longer than 8 characters.

-z Defines the HSRP priority field
value and is required on HSRP based
attacks. This value can be any number
betwen 1 up to 255.

-g Defines the HSRP group number on
HSRP based attacks. This value can be
any number betwen 0 up to 255. If not
set, the group number will be set to 0.

-c Minimum number of packets to
generate. If not set or set to 0, an
unlimited amount of packets will be
generated, unless an attack duration
was set. If you provide a maximum
number of packets to generate, the
minimum number of packets will be
automatically set to one. If not set
or set to 0 on remote attacks, the
packet limit of the daemon will be
used instead.

-C Maximum number of packets to
generate. If not set or set to 0, the
specified minimum number of packets
(-c X) will be generated. If no
minimum number of packets to generate
is specified, an unlimited amount of
packets will be generated.

-e Minimum number of milliseconds
to wait until the next packet is sent.
On HSRP based attacks the send delay
will be used as the hello/hold time
field value and must not be greater
than 255000. The hold time on HSRP
based attacks will be hello time
multiplied by 3.

-E Maximum number of milliseconds
that may pass before the next packet
is sent. If set, Hyenae will wait a
random number of milliseconds between
the minimum (-e X or 0 if not set)
and the maximum number (-E X) before
sending the next packet. This is
useful for breaking flood detections.
On HSRP based attacks the send delay
will be used as the hello/hold time
field value and must not be greater
than 255000. The hold time on HSRP
based attacks will be hello time
multiplied by 3.

-u Minimum attack duration in
milliseconds. If not set or set to 0,
the attack duration will be endless,
unless a packet count was given. If
not set or set to 0 on remote attacks,
the attack duration limit of the
daemon will be used instead.

-U If set, Hyenae will stop the
attack when a duration of a random
number of milliseconds between the
minimum (-u X or 0 if not set) and the
maximum number (-U X) is reached.

-p Random packet payload. If set,
a random data block (payload) of the
given length will be added to the
generated packets (if supported by
the chosen attack type). By default
all packets will be generated with
an empty data block. If the total
length of the packet (including the
protocol headers) exceeds the MTU
limit and Hyenae was called without
the -m option, an error occurs. The
total length of a packet depends on
IP protocol and the attack type
used. The default MTU limit is 1500
bytes.

-P File-based packet payload. If
set, the contents of a file at the
given path will be added as the data
block (payload) of the generated
packets. If the total length of the
packet (including the protocol
headers) exceeds the MTU limit and
Hyenae was called without the -m
option, an error occurs. The total
length of a packet depends on IP
protocol and the attack type used.
The default MTU limit is 1500 bytes.

-m If set, the default MTU limit of
1500 bytes will be ignored and even
packets with a length greater than
1500 bytes will by sent. If the packet
length exceeds the supported MTU limit,
pcap will fail to write the data to the
network. You should never provide this
option unless you know what you are
doing.

-N No sending (cold run). If set,
Hyenae will start a run through its
attack routines without actually
writing any data to the network. This
can be very useful to pre-check the
generated packets or the remote daemon
behaviour before executing the actual
attack.

-l Prints a list of all available
network interfaces and exits.

-l Prints a list of all available
attacks and exits.

-V Prints the current version of
Hyenae and exits.

ADDRESS PATTERNS

Hyenae uses address patterns to define the source and destination address (and for ARP-Replies, sender and target as well) of the generated packets. Each pattern can contain wildcards to randomize certain octets or even the whole address strip or port. Hyenae uses an address adequate randomization algorithm that makes sure to produce valid addresses. As an example, if you have a pattern with an IP address strip like 25%.168.0.1, Hyenae will recognize that it can only place a random value from 0 to 5 here. It will also use the required notation (decimal or hexadecimal) and detect that the specified address is an IPv4 address and will use the IPv4 protocol for the given attack (if possible). Address patterns can have the following formats:

[HW-Address]-[IP-Address]@[Port]
[HW-Address]-[IP-Address]
[HW-Address]

Hyenae will automatically recognize the pattern and even every single address format (HW, IPv4 or IPv4), so you don't have to pass extra arguments, everything we need to know can be derived from the given pattern. If you want to randomize a complete address strip (HW-Address or IP-Address) simply put a single % in it:

%-192.1%%.%.%%@%2%

This one will use a random hardware address and a partially randomized IP address, adequate to the octet digits you specified. Notice that you can even specify the number of random octet digits to create (but make sure that the number of digits within the octet is valid for the used format), the last octet of the IP address strip will be a random 2 digit value. The same works within the port strip (separated by an '@'), the more wildcards you place, the more digits the random port number will have. In the example above, the port number will be 3 digits long and will also have a 2 within its center. Here are some examples:

// Ok
00:D2:F%:D4:DD:%%-192.168.%%.%@%%
%-192.168.%%%.%@%%
00:D2:F%:D4:DD:%%-%@%%
%-%@%
%-%

// Error: HW address octets have a fixed length of 2 digits!
00:%:00::00:00:00-192.168.0.1@21

If you are using only a single wildcard as the IP address strip, Hyenae will generate a complete random IP address. By default, Hyenae will interpret or "assume" random IP address strips as IPv4 addresses. You can change the assumed version by calling Hyenae with the -A option.

In some cases you will need to randomize a pattern equaly to another one. If you are generating ARP packets for example, the source hardware address needs equal the senders hardware address otherwise the packet will be droped by the target host. In such a case, Hyenae will use an equal randomization on both of the patterns (aas long as they match each other).

// HW-Address randomization on ARP packets

// HW-Address strip Will be equaly randomized Source Pattern: % Sender Pattern: %-192.168.0.1

// HW-Address strip Will be equaly randomized Source Pattern: %%:22:33:44:55:66 Sender Pattern: %%:22:33:44:55:66-192.168.0.1

// HW-Adress strip won't be equaly randomized Source Pattern: 11:%%:33:44:55:66 Sender Pattern: %%:22:33:44:55:66-192.168.0.1

SEE ALSO

hyenaed(1)

AUTHOR

Robin Richter (richterr@users.sourceforge.net)