libcryfs/README.md

1.8 KiB

libcryfs is a re-design of the original CryFS code to work as a library. Volumes are not mounted with FUSE but rather opened in memory and accessed through API calls. What the purpose ?

  • Allow the use of CryFS on platforms where FUSE is not available (such as Android)
  • Reduce attack surface by restricting volumes access to only one process rather than one user

Warning !

The only goal of this library is to be integrated in DroidFS. Thus, the current API has been designed to be accessed only via Java Native Interface, and logging has been redirected to Android logcat. You cannot use this library as is outside of Android. Moreover, libcryfs doesn't implement all features provided by CryFS such as symbolic links, editing attributes, flushing files... Use it at your own risk !

Changes:

Here is what has been modified from the original project:

  • Update checks disabled
  • FUSE, curl, range-v3 dependencies removed
  • Conan configuration removed (switched to git submodules for boost and spdlog)
  • src/cryfs-unmount and src/stats directories deleted
  • sh scripts, cpack, doc, test and vendor/googletest deleted
  • Main program cryfs-cli removed
  • boost build configured with Boost-for-Android
  • Automatic version detection removed
  • Interactive mode removed (including any writes to stdout)
  • Logging output redirected to logcat
  • JNI API created in src/jni