Skip to content

Kukkimonsuta/libpcap-net

Repository files navigation

libpcap-net Build Publish NuGet Badge

Libpcap/Npcap wrapper for .NET.

Dependencies

For linux/mac libpcap ( https://www.tcpdump.org/ ), for windows npcap ( https://npcap.com/ ). These libraries are not shipped within the package, they are expected to be present on the system.

Special thank you to Npcap for providing OEM installer for CI testing ❤️

Usage - listen to network

// get all available devices
var devices = Pcap.ListDevices();

// select desired device
var device = devices.First();

// open and activate
using var pcap = Pcap.OpenDevice(device);
pcap.Activate();

Usage - read from file

using var pcap = Pcap.OpenFileRead("Resources/DHCPv6.cap");

Usage - process packets

pcap.Dispatch(100, (Pcap pcap, ref Packet packet) =>
{
    // read packet.Timestamp
    // read packet.Data
});

Usage - process packets from multiple devices

Note that this way is preferred even with single source device, as every call to Pcap.Dispatch allocates GCHandle whereas PcapDispatcher.Dispatch doesn't.

using var dispatcher = new PcapDispatcher(
    (Pcap pcap, ref Packet packet) =>
    {
        // read packet.Timestamp
        // read packet.Data
    }
);

dispatcher.OpenDevice(device1);
dispatcher.OpenDevice(device2);
dispatcher.OpenFile("Resources/DHCPv6.cap");
dispatcher.OpenFile("Resources/dhcp-auth.cap");

dispatcher.Dispatch(100);

Usage - recoding to file

using var dump = Pcap.OpenFileWrite("Resources/DHCPv6-copy.pcap", PcapDataLink.DLT_EN10MB, 65535);

pcap.Dispatch(100, (Pcap pcap, ref Packet packet) =>
{
    dump.Write(ref packet);
});

About

Libpcap/Npcap .NET wrapper

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published