6 releases (breaking)
0.6.0 | May 26, 2023 |
---|---|
0.5.5 | Mar 23, 2023 |
0.5.4 |
|
0.5.1 |
|
0.1.0 | Feb 13, 2021 |
#230 in #driver
278 downloads per month
Used in fumble
1MB
19K
SLoC
WinDivert 2 Rust Wrapper
Note: This is a work in process, so the crates won't follow semantic versioning until 1.0.0 release, so any version change below 1.0.0 might introduce breaking changes in the API or the crate usage in general.
This projects allows you to use WinDivert from rust. It consists of two crates:
windivert-sys
: Crate providing raw bindings to the WinDivert user mode library.windivert
: (WIP) Built on top ofwindivert-sys
and providing a friendlier Rust API and some abstractions.
Build
To be able to build windivert-sys
you require WinDivert library files:
- It's recommended to specify the path of the folder containing downloaded dll,
lib & sys files using the
WINDIVERT_PATH
environment variable. - As a fallback windivert dll & lib files can be compiled from source if the
vendored feature is enabled. To avoid multiple compilations set
WINDIVERT_DLL_OUTPUT
environment variable to save the generated build. - It's possible to compile for statically linking to the windivert library by
enabling the static feature. Static linking can also be enabled if the
WINDIVERT_STATIC
is set and it takes priority over the crate features. - Any vendoring method will only compile the library. Sys files must always be provided.
Usage
windivert-sys
shares the same API the native library uses. Read official documentation for more details.windivert
WIP
Note: WinDivert dll expects the corresponding driver sys file to be located
on the same folder. Since the dll lib & sys files come in the same folder when
downloading from official web
windivert-sys
will search for it on the path provided with WINDIVERT_PATH
.
Dependencies
~132MB
~2M SLoC