NAME Net-Pcap - Interface to pcap(3) LBL packet capture library DESCRIPTION The Net::Pcap module is a Perl binding to the LBL pcap(3) packet capture library. The source code for the LBL pcap library can be found at http://www/tcpdump.org/ INSTALLATION If your pcap header files are installed somewhere strange, create the Makefile using the INC and/or LIBS option. $ perl Makefile.PL INC=-I/usr/local/include/pcap \ LIBS='-L/usr/lib/pcap -lpcap' Compile the extension as per usual: $ make $ make test $ make install To install the extension in a private directory, you can use the PREFIX option when creating Makefile.PL. A ANSI-compliant compiler is required to compile the extension. For most of the tests, an administrative account is required since opening a network interface in promiscuous mode is a privileged operation. Some tests also require a working network interface with traffic on it otherwise the tests will appear to hang. You can generate traffic by pinging a non existing IP address on your network segment. Consult the source for individual tests for more information. Net::Pcap has been tested by the author on the following systems, but is likely to run on many more: - Linux 2.6, gcc 3.4.1 - FreeBSD 4.7, gcc 2.95.4 Net::Pcap is compatible with all the versions of the Pcap library, including the old BSD ones and the Windows port WinPcap. Net::Pcap should work on any Perl since 5.004_05. The is tested by the author that it works with the following versions: - Perl 5.4.5 i686-linux (custom build) - Perl 5.5.3 i686-linux (custom build) - Perl 5.6.2 i686-linux (custom build) - Perl 5.8.5 i386-linux-thread-multi (vendor build) - Perl blead@25763 i686-linux (custom build) For Perl 5.004, you may need to install ExtUtils::Constant with this patch: http://public.activestate.com/cgi-bin/perlbrowse?patch=25927 See also the corresponding CPAN Testers page: http://testers.cpan.org/show/Net-Pcap.html HISTORY The original version of Net::Pcap, version 0.01, was written by Peter Lister