Skip to content
Eric Zhang edited this page Oct 17, 2015 · 27 revisions

Dokan FUSE

Dokan Fuse is a wrapper library that makes Dokan compatible with FUSE API. Now available by default in main source repository and installers, Dokan Fuse comes from an original work of Alex Besogonov, fuse4win project.

To use it, you only have to link with the dynamic library dokanfuse.dll.

TODO

  • Currently special entries '.' and '..' in walk_directory/walk_directory_getdir are not processed correctly. Particularly, they have incorrect timestamps. Fix this.
  • Try to emulate Unix permissions using Windows ACLs.
  • Fix symlink handling.

FUSE / Dokan map

The table bellow describes the approximate mapping required if you attempt to port your FUSE application manually without Dokan Fuse.

FUSE Dokan
fuse_operations::mknod
fuse_operations::create
fuse_operations::open
fuse_operations::mkdir
fuse_operations::opendir
DOKAN_OPERATIONS::CreateFile
DOKAN_OPERATIONS::OpenDirectory
fuse_operations::release
fuse_operations::releasedir
DOKAN_OPERATIONS::Cleanup
fuse_operations::read DOKAN_OPERATIONS::ReadFile
fuse_operations::write DOKAN_OPERATIONS::WriteFile
fuse_operations::flush DOKAN_OPERATIONS::FlushFileBuffers
fuse_operations::readdir DOKAN_OPERATIONS::FindFiles
fuse_operations::utimens DOKAN_OPERATIONS::SetFileAttributes
fuse_operations::getattr DOKAN_OPERATIONS::GetFileInformation
fuse_operations::access DOKAN_OPERATIONS::GetFileSecurity
fuse_operations::unlink DOKAN_OPERATIONS::DeleteFile
fuse_operations::rmdir DOKAN_OPERATIONS::DeleteDirectory
fuse_operations::rename DOKAN_OPERATIONS::MoveFile
fuse_operations::truncate
fuse_operations::ftruncate
DOKAN_OPERATIONS::SetEndOfFile
fuse_operations::lock DOKAN_OPERATIONS::LockFile
DOKAN_OPERATIONS::UnlockFile
fuse_operations::chmod
fuse_operations::chown
DOKAN_OPERATIONS::SetFileSecurity
fuse_operations::statfs DOKAN_OPERATIONS::GetDiskFreeSpace
DOKAN_OPERATIONS::GetVolumeInformation

Important Note

  • If you use MSVC to compile your FUSE program you have to use struct FUSE_STAT instead of struct stat in the source code. The dokanfuse.dll distributed is compiled by MSVC, which means it's not compatible with other compilers for types used in other compilers are not all the same. If you use other compilers like cygwin gcc, you need to use the same toolchain to compile your own dokanfuse.dll and your FUSE program to make it compatible. Neglect of doing so will result in mysterious problems like stack overflows and BSOD.

Using FUSE in other languages

Language Project
Python fusepy
Javascript fuse-bindings, fuse4js
Java fuse-jna, jnr-fuse
Ruby rfusefs
.NET (C#, VB.NET ...) mono-fuse