README.md

Introduction

This library is derived from https://github.com/not-matthias/kernel-driver-with-rust. You can also check https://not-matthias.github.io/kernel-driver-with-rust/.

I am not a rust expert nor I am a windows kernel expert, don't expect high quality. This is just a toy project.

Packages

• windows-kernel-common-sys library is providing kernel types (ntifs.h and its transitive dependencies).

• windows-kernel-ntoskrnl-sys is providing (a lot of) kernel functions (ntfis.h and its transitive dependencies).

• windows-kernel-cng-sys is providing BCrypt bindings.

• windows-kernel-netio-sys is providing Winsock bindings.

• windows-kernel-winsock is a high level wrapper of [Winsock], providing rust abstractions over the raw api.

• windows-kernel-winsock-example is a kernel driver that use the winsock library to call httpbin.

Building and running the winsock example

Prerequisite

Every package should be available through with the Visual Studio Installer

• Microsoft Visual Studio
• Windows Driver Kit
• LLVM (clang)
• cargo (and cargo-make)

Compiling

• cd windows-kernel-winsock-example
• cargo make sign

The command should generate a signed driver, located under target\x86_64-pc-windows-msvc\debug\windows_kernel_winsock_example.sys.

Running

Go in your win10 VM. Open Dbgview and enable kernel logging. Open a terminal as admin.

• if not already existing sc create windows_kernel_winsock_example binPath="absolute path to windows_kernel_winsock_example.sys" type=kernel
• sc start windows_kernel_winsock_example
• sc stop windows_kernel_winsock_example

The driver should produce something like: