arpsnmp - Man Page
keep track of ethernet/ip address pairings
Synopsis
arpsnmp | [-dqs ] [-D arpdir] [-f datafile] [-w watcher@email] [-W watchee@email] file ... |
Description
arpsnmp keeps track of ethernet/ip address pairings. It syslogs activity and reports certain changes via email. arpsnmp reads information from a file (usually generated by snmpwalk(1)).
The format of the input file is the same as arp.dat; the mac address, ip address, optional timestamp and optional simple hostname. If the timestamp is missing, the current date is used.
arpsnmp can also be used to merge files. If the same ethernet/ip address pair occurs in more than one file, the timestamp from the last seen is saved.
The -C
flag uses compact padded ethernet addresses in arp.dat, e.g. 0:8:e1:1:2:d6.
The -d
flag is used enable debugging. This also inhibits mailing the reports. Instead, they are sent to stderr.
The -D
flag is used to specify the working directory. This defaults to /var/lib/arpwatch.
The -f
flag is used to set the ethernet/ip address database filename. The default is arp.dat.
Note that an empty file must be created before the first time you run
The -q
flag suppresses reports being logged or printed to stderr.
The -s
flag suppresses reports sent by email.
The -w
flag is used to specify the target address for email reports. The default is root.
The -W
flag is used specifies the from address for email reports. The default is root.
The -Z
flag uses zero padded ethernet addresses in arp.dat, e.g. 00:08:e1:01:02:d6.
Report Messages
See the arpwatch(8) man page for details on the report messages generated by arpsnmp(8).
Files
- /var/lib/arpwatch
default directory
- arp.dat
default ethernet/ip address database
- ethercodes.dat
vendor ethernet block list
See Also
Authors
Craig Leres of the Lawrence Berkeley National Laboratory Network Research Group, University of California, Berkeley, CA.
The current version is available via anonymous ftp:
ftp://ftp.ee.lbl.gov/arpwatch.tar.gz
Bugs
Please send bug reports to ⟨arpwatch@ee.lbl.gov⟩.
It doesn't make any sense to feed arpsnmp the arp.dat file.
Attempts are made to suppress DECnet flip flops but they aren't always successful.
Referenced By
arpwatch(8), massagevendor(8).