.\" Copyright (c) 2004-2006, Dmitry Morozovsky.
.\"  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $Id: src/arpdig/arpdig.1,v 1.3 2006/05/05 16:17:15 marck Exp $
.\"
.Dd April 28, 2006
.Dt ARPDIG 1
.Os
.Sh NAME
.Nm arpdig
.Nd "dig an interface for arp responses"
.Sh SYNOPSIS
.Nm
.Op Fl n
.Op Fl i Ar ifname
.Op Fl F Ar fromaddr
.Cm netblock/len
.Nm
.Op Fl n
.Fl p
.Op Fl F Ar fromaddr
.Op Fl f Ar file
.Cm ipaddr ...
.Sh DESCRIPTION
The
.Nm
utility is used to send a bunch of ARP whohas requests for a given address
block or list and collect and show ARP responses to them.
.Pp
The following options are available:
.Bl -tag -width indent
.It Fl n
Disable nameserver lookups for IP addresses responded.
.It Fl F Ar fromaddr
Send ARP whohas requests from given IP address.
.It Fl i Ar ifname
Send ARP whohas requests via given interface instead of auto-determined one.
.It Fl p
Probe list of IP addresses specified instead of whole netblock.
.It Fl f Ar file
Using together with
.Fl p
flag, instructs
.Nm
to read IP address list from
.Ar file
and prepend it to the list specified on the command line.
.El
.Pp
By default,
.Nm
determines the interface to send ARP requests by asking the kernel for a route
to the netblock.
A warning will be emitted if no such route can be obtained.
.Pp
If no
.Fl F
flag is given,
.Nm
uses the first IP address inside the probed block on selected interface.
If no such address exists, 0.0.0.0 will be used.
.Sh REQUIREMENTS
.Nm
uses
.Xr bpf 4
both for sending ARP requests and for listening to ARP responses.
.Sh SEE ALSO
.Xr bpf 4
.Sh BUGS
Late ARP responses may be missed.
.Pp
Probe mode should be rewritten to use
.Xr bpf 4
more effeciently.
.Pp
Using
.Fl F
with argument 0 acts as there is no
.Fl F
flag instead of asking from 0.0.0.0 address.
.Sh HISTORY
.Nm
birth was inspired by
.Ar arping
utility written by Thomas Habets <thomas@habets\&.pp\&.se>.
.Sh AUTHOR
.Nm
was written by Dmitry Morozovsky <marck@FreeBSD\&.org>.