sharppcap

sharppcap

完全管理的跨平台（Windows，Mac，Linux）.NET库，用于从实时和文件的设备捕获数据包

官方的SharppCap存储库。

目录

1. 特征
2. 例子
   • 清单设备
   • 捕获数据包
   • 从捕获文件中读取
   • 写入捕获文件
3. CI支持
4. 发行
5. 平台特定说明
6. 从5.x迁移到6.0

特征

有关数据包解剖和创建，请参见Packet.net。

• 在Linux上，支持LIBPCAP

• 在Windows上，支持：

  • NPCAP（以前为WinPCAP）扩展，请参见NPCAP API指南
  • Windivert（https://www.reqrypt.org/windivert.html）

• 在所有平台上：

  • 实时设备列表
  • 统计数据
  • 从实时设备（实际网络设备）和离线设备（捕获文件）读取数据包
  • 支持伯克利数据包过滤器
  • 将数据包倾倒到PCAP文件。
  • PCAP和PCAP-NG格式（使用libpcap> = 1.1.0或NPCAP时）
  • ReadOnlySpan <>用于避免内存分配和在SharppCap内部复制并提供最佳性能。
    • 如果需要在内存中持续捕获的数据包，则提供辅助方法将其转换为对象实例。

• 纳塔维尔元素支持

  • 捕获库分辨率在Linux，OSX和Windows上平稳运行
  • 干净地在Linux上加载libpcap，无论是否具有libpcap的符号链接。

• .NET Core 3和.NET框架支持

例子

请参阅示例文件夹，以获取使用SharppCap的一系列完整示例项目

清单设备

 var devices = CaptureDeviceList . Instance ;
foreach ( var dev in devices )
    Console . WriteLine ( "{0} n " , dev . ToString ( ) ) ; 

捕获数据包

 void Device_OnPacketArrival ( object s , PacketCapture e )
{
    Console . WriteLine ( e . GetPacket ( ) ) ;
}

using var device = LibPcapLiveDeviceList . Instance [ 0 ] ;
device . Open ( ) ;
device . OnPacketArrival += Device_OnPacketArrival ;
device . StartCapture ( ) ; 

从捕获文件中读取

 void Device_OnPacketArrival ( object s , PacketCapture e )
{
    Console . WriteLine ( e . GetPacket ( ) ) ;
}

using var device = new CaptureFileReaderDevice ( "filename.pcap" ) ;
device . Open ( ) ;
device . OnPacketArrival += Device_OnPacketArrival ;
device . Capture ( ) ; 

写入捕获文件

 using var device = new CaptureFileWriterDevice ( "somefilename.pcap" , System . IO . FileMode . Open ) ;
var bytes = new byte [ ] { 1 , 2 , 3 , 4 } ;
device . Write ( bytes ) ;

CI支持

由于几个原因，我们支持许多CI系统：

• CI系统的多样性，以防其中之一关闭
• 示例如果您想自定义SharppCap并使用这些CI系统之一进行内部构建。请注意，我们假设您正在遵循图书馆的许可证。

发行

SharppCap通过Nuget发布

平台特定说明

• OSX（至少截至11.1）缺乏PCAP_OPEN的LIBPCAP

谢谢

SharppCap是今天的位置，因为许多开发人员提供了通过问题和功能请求提供有用的反馈的改进，修复和用户。

我们特别感谢我们构建的许多项目（因为SharppCap是C＃包装器）：

• libpcap-非常感谢您发布1.10
• NPCAP-用于继续在Windows上进行数据包捕获支持

从5.x迁移到6.0

我们希望您会发现6.x API更清洁且易于使用。

6.0带来了许多清理，这些清理为5.x用户带来了API破裂。

为了帮助从5.x到6.0的迁移，这是您必须对SharppCap使用的一些更改的列表。

这些示例也是一个很好的资源，因为它们使用最新的API显示了工作示例。

• 数据包数据是通过PacketCapture返回的，该数据包使用ReadOnlySpan <>。
  • 从packetcapture.getpacket（）执行从ReadOnlySpan <>转换为RAWCAPTURE。
  • 这避免了分组捕获期间内存的分配。
  • 通过避免内存分配和内存复制，原始捕获性能可能会快30％。
  • SPAN非常适合将数据包倾倒到磁盘以供以后处理的用例。
• NativeLibrary用于改进捕获库分辨率
  • 改善Linux发行库的图书馆分辨率的情况。
  • 随着单声道支持NativeLibrary，对Mono dllmap的支持已被删除。请参阅https://www.mono-project.com/news/2020/08/24/native-loader-net5/
• 设备可识别
  • 删除呼叫以关闭（）
  • 开关'var device = xxx;'到'使用设备= xxx;'
• 重命名OpenFlags-> DeviceModes
• Open（）方法已折叠成具有默认变量的较少方法。
• DeviceMode已被DeviceModes取代，因为DeviceMode无法涵盖您打开设备的所有组合。
• npcapdevice-> libpcaplivedevice
  • 如果您使用的是npcapdevice，则应考虑使用libpcaplivedevice。 NPCAP的最新版本带有较新版本的LibPCAP，几乎提供了NPCAP本机API的所有功能。
  • 当前的差距是统计模式，目前仅由NPCAP支持。
  • 已经谈到了统计模式包装器，该包装器将提供类似的功能，尽管没有效率水平，就像在内核或驱动程序中与Windows上的效率相同，用于LIBPCAP系统。
• winpcap已弃用
  • 我们建议切换到libpcaplivedevice
• 远程身份验证
  • 如果您使用的是remoteAuthentication，则将某些功能折叠到此类中，并且API更改以删除iCredentials和NetworkCredentials的使用情况。