rpodgorny / unionfs-fuse

union filesystem using fuse
Other
288 stars 75 forks source link

Liberapay

unionfs-fuse

This is my effort to create a unionfs filesystem implementation which is way more flexible than the current in-kernel unionfs solution.

I'm open to patches, suggestions, whatever...

The preferred way is the github issue tracker with direct mail to me (radek@podgorny.cz) as a backup.

Why choose this stuff

Why NOT choose it

How to build

You can either use plain make or cmake (pick one).

  1. plain make

Just issue make - this compiles the code with some static settings (xattrs enabled, hard-coded libfuse2, ...) tuned for my linux system.

  1. cmake
mkdir build
cd build
cmake ..
make

This should allow for compilation on wider variety of systems (linux, macos, ...) and allows to enable/disable some features (xattrs, libfuse2/libfuse3, ...).

To see the list of all options, run cmake -LAH after the cmake .. step.

Example of option usage:

cmake .. -DWITH_LIBFUSE3=FALSE -DWITH_XATTR=FALSE

MacOS support

unionfs-fuse has been successfully compiled and run on MacOS (with the help of macfuse - formerly osxfuse).

Since I have no access to Apple hardware+software I'm only dependent on other people's contributions.

When building for MacOS on MacOS, the "cmake option" is the recommended one.

For the linux-based development I've managed to create a limited MacOS testing environment with Vagrant (see below) but it took me absurd amount of time and was so much pain in the ass I have no further intention to waste a single minute more on closed-source systems. Thanks Apple for reminding me of my old days with Windows and how horrible time it was. ;-)

To run the vagrant-based macos tests, just execute ./test_vagrant_macos.sh.

This depends on a custom vagrant box. You can use the one I've built or you can build your own - all the required stuff should be in macos_vagrant directory.