9e394a46c0
We had the situation that "make test" runs the test suite but does not show useful error messages (see https://github.com/vgough/encfs/issues/358 for an example). "make check" did the right thing by using the "--output-on-failure" feature, but depended on "make test" being available as well. This means users will continue to run "make test". This commits drops the cmake test logic and adds a dumb "make test" target that simply runs test.sh.
1.9 KiB
This document provides generic information for compiling EncFS.
If you are looking for specific instructions for your distribution, take a look at the page Installing EncFS in the wiki.
Compiling EncFS
EncFS uses the CMake toolchain to create makefiles.
Steps to build EncFS:
mkdir build
cd build
cmake ..
make
Optional, but strongly recommended, is running the test suite to verify that the generated binaries work as expected (runtime: 20 seconds)
make test
The compilation process creates two executables, encfs and encfsctl in the encfs directory. You can install to in a system directory via
make install
. If the default path (/usr/local) is not where you want things
installed, then set the CMAKE_INSTALL_PREFIX option when running cmake. Eg:
cmake .. -DCMAKE_INSTALL_PREFIX=/opt/local
Encfs and encfsctl can also be installed by hand. They need no special permissions. You may also want the man pages encfs.1 and encfsctl.1.
Dependencies
EncFS depends on a number of libraries:
* fuse : the userspace filesystem layer
* openssl : used for cryptographic primitives
* tinyxml2 : for reading and writing XML configuration files
* gettext : internationalization support
* libintl : internationalization support
* cmake : version 3.0.2 (Debian jessie version) or newer
* GNU make or ninja-build : to run the build for cmake
Compiling on Debian and Ubuntu
See the automated build static in README.md for current build status on Ubuntu systems.
The build configuration files (circle.yml) always contains up-to-date instructions to build EncFS on Ubuntu distributions.
On Debian Stable, additional installations from Backports branch might be required (cmake 3.x for example, see https://backports.debian.org/ for instructions).