Re-design of the original CryFS code to work as a library.
Go to file
Matéo Duparc 35a2198ac9
libcyfs REAMDE
2022-06-26 12:58:01 +02:00
cmake-utils Genesis 2022-06-18 21:11:24 +02:00
src Clean JNI library 2022-06-25 21:32:28 +02:00
vendor Switch to boost 1.77.0 2022-06-24 19:52:59 +02:00
.clang-tidy Tiny cleanup (#397) 2021-09-01 18:44:21 -07:00
.gitignore Add vscode folder to gitignore 2020-07-10 16:54:07 -07:00
.gitmodules CMake libs build 2022-06-21 19:30:00 +02:00
CMakeLists.txt Cleaning 2022-06-25 16:57:50 +02:00
CMakeSettings.json Update to DokanY 1.3.0.1000 2021-12-23 00:50:51 +01:00
ChangeLog.txt Mention OpenMP fix 2022-02-21 21:20:44 -08:00
LICENSE.txt Tiny cleanup (#397) 2021-09-01 18:44:21 -07:00
README.md libcyfs REAMDE 2022-06-26 12:58:01 +02:00

README.md

libcryfs is a re-desing 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
  • Interactive mode removed (including any writes to stdout)
  • Logging output redirected to logcat
  • JNI API created in src/jni