README
1README for Net::PcapUtils 0.01
2==============================
3
4This module provides some code to abstract away some of the messier
5parts of using the Net::Pcap library. The idea is to be able to write
6"one-liner" type scripts for packet capture without getting bogged
7down in the initialisation code. This makes it possible to write very
8compact Perl scripts involving packet capture.
9
10To use Net::PcapUtils, the latest version of the Net::Pcap module is
11required (at the time of writing, this was version 0.03).
12
13Net::PcapUtils provides three functions that are described below:
14
15 - Net::PcapUtils::loop(\&callback_fn, [optional args]);
16
17 Capture packets and execute callback function for evey
18 packet received.
19
20 - Net::PcapUtils::next($pcap_t);
21
22 Return the next packet and packet header from an open
23 network interface.
24
25 - Net::PcapUtils::open([optional args]);
26
27 Open a network interface for packet capture and return
28 a packet capture descriptor.
29
30If none of the optional arguments are declared, then a reasonable set
31of defaults are assumed. See the Net::PcapUtils manpage for more
32details.
33
34I hope you enjoy Net::PcapUtils.
35
36
378/4/99
38Tim Potter
39tpot@acsys.anu.edu.au
40