NAME

SYNOPSIS

where MODE is either one among BASIC or ADVANCED and OPTIONS lets you control each address of the ARP message (at link and logical layers - i.e. Ethernet and IP addresses), and lots of other sending parameters (interface, frequency, amount, and so on).

DESCIRPTION

It supports currently only Ethernet and IP protocols but is designed to also work with other addresses (in a far away future ;-)

BASIC MODES

-w, --who-has

Send an ARP Who-has.

-r, --reply

Send a ARP Reply.

ADVANCED MODES

None are yet implemented but they should appear very soon. They should be considered as combinations and shortcuts of what you can do by sending several basic packets.

-o, --spoof

For those used to Dug Song's arpspoof in dsniff (NOT YET IMPLEMENTED)

-p, --arping

(bad) RARP emulation. (NOT YET IMPLEMENTED)

-m, --arpmim

Man in the Middle. (NOT YET IMPLEMENTED)

LINK LAYER OPTIONS

These parameters let you control what will appear in the packet at link layer (Ethernet addresses of the ARP message). These addresses don't need to be the same as those specified in the ARP message itself. The RFC 826 (ARP's one) does not specify that there must be some consistency between ARP and Ethernet layer. That means you can provide uncorrelated addresses between these 2 layers.

This is very useful if you want reach all hosts on the network (use broadcast address as destination) or a particular host (the gateway for instance), or you can hide the source of the ARP message by providing a fake source address.

Here, you can provide either a hostname, an IP address or a MAC address. If you use a hostname or an IP address and that Ethernet address is not present in your ARP cache, a malformed DNS packet is sent to the target. But since the cache does not contain the Ethernet address, an ARP query is firstly sent on the network. The target answers with an ARP and you got the Ethernet address.

-d, --dst HOST

Set link layer destination. HOST can be a hostname, an IP address or a MAC address.

-s, --src HOST

Set link layer source. HOST can be a hostname, an IP address or a MAC address.

--rand-hwa

Set random addresses in link header

--rand-hwa-dst

Set random destination in link header.

--rand-hwa-src

Set random source in link header.

LOGICAL LAYER OPTIONS

These parameters let you control what will appear in the ARP message itself, that is mainly the pairs <IP:MAC> for both source and destination hosts.

You can specify either both IP and MAC (1.1.1.1:11:11:11:11:11:11), only IP (1.1.1.1, information provided is the link layer will be used to complete the ARP message), or only MAC (:11:11:11:11:11:11, then IP is set to broadcast).

-D, --arp-dst HOST[:MAC]

Set logical layer destination. HOST can be a hostname or an IP address. A MAC address can be specified with MAC. If not, HOST will be resolved.

-S, --arp-src HOST[:MAC]

Set logical layer source. HOST can be a hostname or an IP address. A MAC address can be specified with MAC. If not, HOST will be resolved.

--rand-arp

Set random addresses in ARP message.

--rand-arp-dst

Set random destination adsresses in ARP message.

--rand-arp-src

Set random source addresses in ARP message.

--rand-arp-hwa-dst

Set random destination MAC address in ARP message.

--rand-arp-log-dst

set random dst IP address in ARP message.

--rand-arp-hwa-src

Set random source MAC address in ARP message.

--rand-arp-log-src

Set random source IP address in ARP message.

MISCELLANEOUS OPTIONS

-i, --interface IFACE

Use IFACE as output interface (default: eth0).

-c, --count NUM

Send NUM packets

-T, --time NUM

Wait the NUM seconds between sending each packet ( NUM can be prefixed with u for microseconds)

--rand-time NUM

Randomize the sending period of the packets by adding a random salt choosen between -NUM and NUM.

--beep

Beep for each packet sent.

--use-ts

Send an icmp-timestamp to resolve MAC to IP.

-n, --network ADDRESS

Use ADDRESS as broadcast address for sending icmp-timestamp.

-N, --call-dns

Force address name resolution. This should never be used since it sends DNS messages on the LAN and slows down performances of arp-sl.

-V, --version

Print version and exit.

-h, --help

BUGS

AUTHORS