@(#) $Header: /cvsroot/pkgsrc/net/arpwatch/DESCR,v 1.1 2001/10/31 22:54:50 zuntum Exp $ (LBL)

ARPWATCH 2.0
Lawrence Berkeley National Laboratory
Network Research Group
arpwatch@ee.lbl.gov
ftp://ftp.ee.lbl.gov/arpwatch.tar.Z

This directory contains source code for arpwatch and arpsnmp, tools
that monitors ethernet activity and maintain a database of ethernet/ip
address pairings. It also reports certain changes via email.

Arpwatch uses libpcap, a system-independent interface for user-level
packet capture.  Before building arpwatch, you must first retrieve and
build libpcap, also from LBL, in:

	ftp://ftp.ee.lbl.gov/libpcap.tar.Z.

Once libpcap is built (either install it or make sure arpwatch and
libpcap share the same parent directory), you can build arpwatch using
the procedure in the INSTALL file.

Arpsnmp has the same database features of arpwatch but relies on an
external agent to collect the arp data. This distribution contains a
script, arpfetch, that uses snmpwalk from the CMU SNMP package. This
package is available from:

	ftp://ftp.net.cmu.edu/pub/snmp-dist/cmu-snmp*.tar.Z

It should be trivial to adaptive the output of any snmp query program
for use with arpsnmp.

The ethernet vendor codes come from:

    http://www.cavebear.com/CaveBear/Ethernet/vendor.html

Another source of ethernet vendor code data is:

    http://standards.ieee.org/db/oui/

However that version is copyrighted.

Please send bugs and comments to arpwatch@ee.lbl.gov.


 Copyright (c) 1990, 1992, 1993, 1994, 1995, 1996, 1997
      The Regents of the University of California.  All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that: (1) source code distributions
 retain the above copyright notice and this paragraph in its entirety, (2)
 distributions including binary code include the above copyright notice and
 this paragraph in its entirety in the documentation or other materials
 provided with the distribution, and (3) all advertising materials mentioning
 features or use of this software display the following acknowledgement:
 ``This product includes software developed by the University of California,
 Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
 the University nor the names of its contributors may be used to endorse
 or promote products derived from this software without specific prior
 written permission.
 THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
 WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.