BðP

Win32::NetPacket

• Introduction
• Download
• Example scripts

Introduction

packet.dll offers a set of low level functions to sniff the network traffic, send packets to the network, obtain the list of the available network adapters, retrieve various information about an adapter, ...etc

For more information, see WinPcap.org.

Caution: As explained in the WinPcap documentation, packet.dll should be considered an internal API and, as a consequence, there is no guarantee that this API will not be changed in future releases of WinPcap.
Therefore the module is subject to change for every version of WinPcap and every version of the module corresponds to a particular version of WinPcap. Nevertheless, I try to maintain the same interface from version to version.
All the packet.dll functions are not implemented yet (under development...).

See the POD of Win32::NetPacket.

Download

Current version is 0.03 for WinPcap 3.1

Download the 3.1 version WinPcap auto-installer (driver +DLLs) and run the executable.
You can also download WinDump (tcpdump for Windows).

The module is in my ppm repository.
If you are using ActiveState's Perl distribution (Perl 5.6 or Perl 5.8), the easiest way to install this module is to use ppm. Enter (or cut & paste) this command in a DOS console:

    ppm install http://www.bribes.org/perl/ppm/Win32-NetPacket.ppd

The documentation, in html format, is at its usual location.

If you want, you can download the source file here: Win32-NetPacket-0.03.tar.gz
or from the CPAN
To install the module, read the README file.

You can download the WinPcap documentation (with full Packet.dll doc) in .chm format here:
winpcap31doc.zip (1.59 Mb).

Example scripts

• TestApp
  This script shows a list of available adapters and gives the possibility to choose one of them. Once the capture is started, the program prints the raw content of the packets in hexa and ascii. Press the [enter] to stop the capture.

  

  See the code of TestApp.pl.

• Netmeter
  This very rustic script displays the network's load, using the default adapter.

  

  See the code of NetMeter.pl.

• Traffic Generator
  This script sends a set of packets to the network. The generated packets will have 1:1:1:1:1:1 as source MAC address, and 2:2:2:2:2:2 as destination address. For example:
      perl tg.pl -i 1 -n 100 -s 256
  sends 100 packets of 256 bytes long on the adapter #1.
  If the -i option is not specified, the script shows a list of available adapters and gives the possibility to choose one of them.

  See the code of tg.pl.

Back to Top