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.  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.

      - Solaris 2.6, gcc 2.8.1
      - Linux 2.2, gcc 2.8.1

    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 <p.lister@cranfield.ac.uk> using SWIG.

    Version 0.02 was created by Bo Adler <thumper@alumni.caltech.edu> 
    with a few bugfixes but not uploaded to CPAN.  It can be found at:
        http://www.buttsoft.com/~thumper/software/perl/Net-Pcap/

    Versions 0.03 and 0.04 were created by Tim Potter (TIMPOTTER) who 
    entirely rewrote Net::Pcap using XS and wrote the documentation, 
    with the help of David N. Blank-Edelman <dnb@ccs.neu.edu> for 
    testing and general polishing.

    Version 0.05 was released by Marco Carnut (KCARNUT) with fixes 
    to make it work with Cygwin and WinPcap. 


COPYRIGHT AND LICENCE

    Copyright (C) 2005 Sbastien Aperghis-Tramoni
    Copyright (c) 2003 Marco Carnut. All rights reserved. 
    Copyright (c) 1999-2000 Tim Potter. All rights reserved. 
    Copyright (c) 1998 Bo Adler. All rights reserved. 
    Copyright (c) 1997 Peter Lister. All rights reserved. 

    This library is free software; you can redistribute it and/or modify
    it under the same terms as Perl itself.
