https://github.com/mpartel/bindfs

Mount a directory elsewhere with changed permissions.
https://github.com/mpartel/bindfs

Last synced: 17 days ago
JSON representation

Mount a directory elsewhere with changed permissions.

• Host: GitHub
• URL: https://github.com/mpartel/bindfs
• Owner: mpartel
• License: gpl-2.0
• Created: 2011-07-08T16:11:47.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2024-10-17T17:37:35.000Z (27 days ago)
• Last Synced: 2024-10-20T02:16:47.327Z (25 days ago)
• Language: C
• Homepage: https://bindfs.org/
• Size: 632 KB
• Stars: 441
• Watchers: 21
• Forks: 64
• Open Issues: 42
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog
  • License: COPYING

Awesome Lists containing this project

README

        

## Overview ##

bindfs  -  https://bindfs.org/

bindfs is a FUSE filesystem for mirroring a directory to another

directory, similarly to `mount --bind`. The permissions of the mirrored

directory can be altered in various ways.

Some things bindfs can be used for:

- Making a directory read-only.

- Making all executables non-executable.

- Sharing a directory with a list of users (or groups).

- Modifying permission bits using rules with chmod-like syntax.

- Changing the permissions with which files are created.

Non-root users can use almost all features, but most interesting

use-cases need `user_allow_other` to be defined in `/etc/fuse.conf`.

## Installation ##

[FUSE](https://github.com/libfuse/libfuse) 2.8.0 or above is required.

FUSE 3 is supported. When using FUSE 3, libfuse 3.10.2 or newer is

recommended to avoid a [bug with readdir](https://github.com/libfuse/libfuse/issues/583),

though it only seems to affect a few applications.

To compile from source on Linux, first `apt install build-essential pkg-config libfuse3-dev` (or `libfuse-dev` on older systems). On MacOS, install XCode (and let it install Developer Tools), [pkg-config](https://formulae.brew.sh/formula/pkg-config#default) and either [MacFuse](https://osxfuse.github.io/) or [fuse-t](https://www.fuse-t.org/).

Download a [release](https://bindfs.org/downloads/) or clone this repository.

Then compile and install as usual:

    ./autogen.sh  # Only needed if you cloned the repo.

    ./configure

    make

    make install

If you want the mounts made by non-root users to be visible to other users,

you may have to add the line `user_allow_other` to `/etc/fuse.conf`.

On some systems, you may have to add your user to the `fuse` group.

## Usage ##

See the `bindfs --help` or the man-page for instructions and examples.

## MacOS note ##

The following extra options may be useful under osxfuse:

    -o local,allow_other,extended_security,noappledouble

See https://github.com/osxfuse/osxfuse/wiki/Mount-options for details.

## Test suite ##

[![Build Status](https://github.com/mpartel/bindfs/actions/workflows/tests.yml/badge.svg)](https://github.com/mpartel/bindfs/actions/workflows/tests.yml)

Bindfs comes with a (somewhat brittle and messy) test suite.

Some tests must be run as root, and some tests only work as non-root.

You can run run the tests with `./test-all.sh`.

It requires Ruby and `sudo`, and it uses `valgrind` if installed.

### Vagrant test runner ###

There is also a set of Vagrant configs for running the test suite on a variety

of systems. Run them with `vagrant/test.rb` (add `--help` for extra options).

You can destroy all bindfs Vagrant machines (but not the downloaded images)

with `make vagrant-clean`.

## License ##

GNU General Public License version 2 or any later version.

See the file COPYING.