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的使用情況。