BFSYNCFS

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
THE .BFSYNC DIRECTORY
CONFIGURATION
SEE ALSO

NAME

bfsyncfs - FuSE filesystem to be used with bfsync big file synchronization tool

SYNOPSIS

bfsyncfs [<options>] <repo> <mount-point>

DESCRIPTION

bfsyncfs is a FuSE filesystem which can be used to modify the contents of a bfsync repsitory. To use it, you need a local bfsync checkout (created with bfsync clone) and a mount point, which must be empty before running bfsyncfs. Upon successful mount, the mount point directory will be used to display the contents of the repository and modifications can be made with any program that can operate on files/directories, like a filemanager, rsync or regular shell commands like cp or mv.

Note that changes only become permanent after using bfsync commit. Other bfsync commands can be used to synchronize the repository history/contents with other bfsync repos.

OPTIONS

<repo>

The repository argument should point to a local bfsync checkout (created with bfsync clone).

<mount-point>

The mount point should be an empty directory.

-a

Allows other users to access the mounted filesystem (this sets the -oallow_other option). Without this option, the contents of the filesystem will only be readable/writeable by the user that mounted it.

-f

Run the filesystem as foreground process. Without this option, bfsyncfs will be started as background process.

-d

Enables debugging output, this option is mainly useful during development/debugging.

THE .BFSYNC DIRECTORY

Once a repository is mounted, all data contained in the current version of the repository will be available through the mount point. However, one additional directory will show up in the file system, the ".bfsync" directory. Within the .bfsync directory, all previous versions of the file system are available inside the commits directory. So if you access the contents of .bfsync/commits/8, this directory will contain the contents of the repository version 8. It is not possible to modify old commits, the .bfsync directory is only for reading.

CONFIGURATION

There are configuration options from the repository config file that affect bfsyncfs, they are documented in the bfsync manual page.

SEE ALSO

bfsync.1 <http://testbit.eu/Bfsync.1>