Documentation

Developing file systems is a challenging proposition. Developing file systems for Windows is an order of magnitude more difficult. WinFsp eases the task of writing a new file system for Windows. WinFsp file systems are user mode programs and they can be written in a variety of languages and frameworks.

The documentation available here discusses various aspects of WinFsp.

Programming

• The Tutorial describes how to create a simple, but complete file system in C/C++.
• The API Reference describes the native WinFsp API.
• There is also a FUSE compatibility layer for native Windows and Cygwin. See fuse.h in the source repository.
• This document discusses the need for both a native API and FUSE and gives some pointers on which one to choose.
• Since release 2019.3 WinFsp supports development of file systems in kernel mode. This document discusses how to write such file systems.

Design

• The Design document describes the high-level design of WinFsp.
• The IPC document offers insights into the WinFsp Inter-Process Communication mechanism.
• The Queued Events document discusses a low-level synchronization primitive that is largely responsible for the excellent performance of the WinFsp IPC mechanism.
• The Service Architecture document discusses how to intergrate a file system into Windows as a service and the reasons to do so.
• The SSHFS Port Case Study document chronicles the creation of the WinFsp-FUSE compatibility layer and the decisions that led to its design.

Testing

• The Testing document discusses the WinFsp testing strategy and how WinFsp achieves correctness and stability.
• The Performance document compares WinFsp performance against other file systems.

Compatibility

• The Compatibility document discusses current WinFsp compatibility with NTFS.