Oakrey.Network.PacketCapture.Wrapper 1.0.0

Oakrey.Network.PacketCapture.Wrapper

Overview

The "WindowsCaptureWrapper" project is a .NET 8 library that provides a managed wrapper around native packet capture functionalities, specifically targeting Windows environments. It facilitates low-level network packet capture, filtering, and transmission by abstracting complex native API calls into a user-friendly .NET interface.

Features

Packet Capture and Transmission:

Provides methods for capturing packets (GetNextPacketPointers, ReadPackets) and sending packets (SendPacket, SendQueue). Supports queue-based packet transmission with integrity checks.

Filter Management:

Enables the compilation and application of Berkeley Packet Filters (BPF) for efficient packet filtering (CompileFilter, SetFilter).

Device Configuration:

Allows configuration of device settings such as kernel buffer size, capture mode, and blocking mode (SetKernelBufferSize, SetMode, SetBlocking).

Statistics and Error Handling:

Retrieves detailed capture statistics (GetCaptureStatistics) and provides robust error handling with descriptive exceptions (PacketCaptureException, StatisticsException).

Native Interoperability:

Leverages P/Invoke to interact with native libraries, ensuring high performance and access to low-level features.

Extensibility:

Includes utility methods for managing native pointers and memory, making it easier to extend or integrate with other native libraries.

Installation

You can install the package via NuGet Package Manager, Package Manager Console or the .NET CLI.

NuGet Package Manager

1. Open your project in Visual Studio.
2. Navigate to Tools > NuGet Package Manager > Manage NuGet Packages for Solution....
3. Search for Oakrey.Network.PacketCapture.Wrapper and click Install.

.NET CLI

Run the following command in your terminal:

dotnet add package Oakrey.Network.PacketCapture.Wrapper

Package Manager Console

Run the following command in your Package Manager Console:

Install-Package Oakrey.Network.PacketCapture.Wrapper

Requirements

• .NET 8 or higher

Project Information

• Author: Oakrey
• Company: Oakrey
• License: MIT
• Repository: Git Repository
• Project URL: Project Website

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve the package.

License

This project is licensed under the MIT License. See the LICENSE file for details.