README
1NAME
2
3 Net::Pcap - Interface to pcap(3) LBL packet capture library
4
5
6DESCRIPTION
7
8 The Net::Pcap module is a Perl binding to the LBL pcap(3) packet
9 capture library.
10
11 The latest source code for the Pcap library can be found at
12 <http://www.tcpdump.org/>. The source code and binary for the
13 Win32 port can be found at <http://www.winpcap.org/>.
14
15
16INSTALLATION
17
18 This module needs an ANSI-compliant compiler, the libpcap and
19 its C headers to be installed on the target system. On many
20 operating systems, simply install the "libpcap" and "libpcap-dev"
21 packages.
22
23 If the library and C headers are not installed in a standard
24 location, please provide the appropriate paths to Makefile.PL
25 using the INC and/or LIBS options:
26
27 $ perl Makefile.PL INC=-I/opt/pcap/include \
28 LIBS='-L/opt/pcap/lib -lpcap'
29
30 Then compile the extension as per usual:
31
32 $ make all test
33 $ make install
34
35 To install the extension in a private directory, you can use the
36 PREFIX option when creating Makefile.PL.
37
38 For most of the tests, an administrative account is required
39 since opening a network interface in promiscuous mode is a
40 privileged operation. Some tests also require a working network
41 interface with traffic on it otherwise the tests will appear to
42 hang. You can generate traffic by pinging a non existing IP
43 address on your network segment. Consult the source for individual
44 tests for more information.
45
46 You can select the interface Net::Pcap will use for its tests by
47 creating a file device.txt in the distribution root directory and
48 putting the device name inside.
49
50 Net::Pcap is compatible with all the versions of the Pcap library,
51 including the old BSD ones and the Windows port WinPcap.
52
53 Net::Pcap should work on any Perl since 5.004_05. This module has
54 been tested by the author on the following Perl and system versions
55 but is likely to run on many more:
56
57 Perl Architecture GCC Pcap
58 -------------------------------------------------------------
59 5.4.5 i686-linux 3.4.1 0.8.3
60 5.5.3 i686-linux 3.4.1 0.8.3
61 5.6.2 i686-linux 3.4.1 0.8.3
62 5.8.5 i386-linux-thread-multi 3.4.1 0.8.3
63 5.8.8 i486-linux-gnu-thread-multi 4.0.4 0.9.4
64 5.8.7 x86_64-linux 4.0.1 0.9.1
65 5.8.8 i386-freebsd-64int 3.4.4 0.9.1
66 5.8.6 darwin-thread-multi-2level (PowerPC) 4.0.1
67
68 For Perl 5.004, you may need to install ExtUtils::Constant with
69 this patch:
70 http://public.activestate.com/cgi-bin/perlbrowse?patch=25927
71
72 See also the corresponding CPAN Testers page:
73 http://testers.cpan.org/show/Net-Pcap.html
74
75 and the CPAN Testers Matrix:
76 http://bbbike.radzeit.de/~slaven/cpantestersmatrix.cgi?dist=Net-Pcap
77
78
79SUPPORT AND DOCUMENTATION
80
81 After installing, you can find documentation for this module with
82 the perldoc command.
83
84 perldoc Net::Pcap
85
86 You can also look for information at:
87
88 Search CPAN
89 http://search.cpan.org/dist/Net-Pcap
90
91 CPAN Request Tracker:
92 http://rt.cpan.org/Dist/Display.html?Name=Net-Pcap
93
94 AnnoCPAN, annotated CPAN documentation:
95 http://annocpan.org/dist/Net-Pcap
96
97 CPAN Ratings:
98 http://cpanratings.perl.org/d/Net-Pcap
99
100 See also the examples scripts provided in the distribution, in the
101 examples/ subdirectory.
102
103
104COPYRIGHT AND LICENCE
105
106 Copyright (C) 2005-2016 Sebastien Aperghis-Tramoni and contributors.
107 All rights reserved.
108 Copyright (C) 2003 Marco Carnut. All rights reserved.
109 Copyright (C) 1999-2000 Tim Potter. All rights reserved.
110 Copyright (C) 1998 Bo Adler. All rights reserved.
111 Copyright (C) 1997 Peter Lister. All rights reserved.
112
113 This library is free software; you can redistribute it and/or modify
114 it under the same terms as Perl itself.
115