Re-design of the original gocryptfs code to work as a library.
Go to file
Jakob Unterwurzacher c74772bc8d Run go fmt 2016-02-06 20:23:36 +01:00
Documentation Add new "-wpanic" option and enable it for the automated tests 2016-01-31 18:09:39 +01:00
integration_tests Major refactoring: Split up "cryptfs" into several internal packages 2016-02-06 19:22:35 +01:00
internal Run go fmt 2016-02-06 20:23:36 +01:00
openssl_benchmark Fix tests - were broken by the refactoring 2016-02-06 20:22:45 +01:00
.drone.yml Add drone.io CI config 2015-11-22 21:07:38 +01:00
.gitignore package.bash: Encode host distribution into tar filename 2016-01-09 15:47:29 +01:00
.travis.yml travis: also build using build.bash 2015-12-20 17:15:29 +01:00
LICENSE Add MIT LICENSE 2015-10-11 23:15:03 +02:00
README.md Show new benchmark.bash in README 2016-01-23 20:18:13 +01:00
TODO.md Handle all operations except mounting without forking a child 2015-11-29 19:09:12 +01:00
benchmark-builtin.bash Show new benchmark.bash in README 2016-01-23 20:18:13 +01:00
benchmark.bash Show new benchmark.bash in README 2016-01-23 20:18:13 +01:00
build.bash build.bash: copy binary to $GOPATH/bin 2016-01-09 15:31:34 +01:00
checkdir.go Refactor cli argument handling 2015-11-14 21:25:10 +01:00
daemonize.go Wrap Logger to make disabling output more efficient 2016-01-21 22:59:11 +01:00
main.go Run go fmt 2016-02-06 20:23:36 +01:00
masterkey.go Major refactoring: Split up "cryptfs" into several internal packages 2016-02-06 19:22:35 +01:00
package.bash package.bash: Encode host distribution into tar filename 2016-01-09 15:47:29 +01:00
password.go Suppress password prompt when using -extpass 2016-01-23 20:18:39 +01:00
sendusr1.go Use new arg "-notifypid" for more robust daemonization 2015-11-09 23:33:35 +01:00
test.bash Fix tests - were broken by the refactoring 2016-02-06 20:22:45 +01:00

README.md

gocryptfs Build Status MIT License

An encrypted overlay filesystem written in Go. Official website: https://nuetzlich.net/gocryptfs

gocryptfs is built on top the excellent go-fuse FUSE library and its LoopbackFileSystem API.

This project was inspired by EncFS and strives to fix its security issues while providing good performance. For details on the security of gocryptfs see the Security design document.

All tags from v0.4 onward are signed by the gocryptfs signing key. Please check Signed Releases for details.

Current Status

gocryptfs is a young project. While bugs in any software can cause issues, bugs in encryption software can cause catastrophic data loss. Keep a backup of your gocryptfs filesystem and store a copy of your master key (printed on mount) in a safe place.

Only Linux is supported at the moment. Help wanted for a Mac OS X port.

Testing

gocryptfs comes with is own test suite that is constantly expanded as features are added. Run it using ./test.bash. It takes about 1 minute and requires FUSE as it mounts several test filesystems.

In addition, I have ported xfstests to FUSE, the result is the fuse-xfstests project. gocryptfs passes the "generic" tests with one exception, results: XFSTESTS.md

A lot of work has gone into this. The testing has found bugs in gocryptfs as well as in go-fuse.

The one exception is generic/035, see go-fuse issue 55 for details. While this is a POSIX violation, I do not see any real-world impact.

Compile

$ go get github.com/rfjakob/gocryptfs

Use

$ mkdir cipher plain
$ $GOPATH/bin/gocryptfs -init cipher
$ $GOPATH/bin/gocryptfs cipher plain

See the Quickstart page for more info.

The MANPAGE.md containes a description of available command-line options. If you already have gocryptfs installed, run ./MANPAGE-render.bash to bring up the rendered manpage in your man pager (requires pandoc).

Storage Overhead

  • Empty files take 0 bytes on disk
  • 18 byte file header for non-empty files (2 bytes version, 16 bytes random file id)
  • 28 bytes of storage overhead per 4kB block (12 byte nonce, 16 bytes auth tag)

file-format.md contains a more detailed description.

Performance

gocryptfs uses openssl through spacemonkeygo/openssl for a 3x speedup compared to Go's builtin AES-GCM implementation (see go-vs-openssl.md for details).

Run ./benchmark.bash to run the benchmarks.

The output should look like this:

$ ./benchmark.bash
linux-3.0.tar.gz       100%[===========================>]  92,20M  2,96MB/s    in 35s
2016-01-23 20:08:11 URL:https://www.kernel.org/pub/linux/kernel/v3.0/linux-3.0.tar.gz [...]
WRITE: 131072000 bytes (131 MB) copied, 1,36225 s, 96,2 MB/s
UNTAR: 23.16
LS:    1.71
RM:    4.36

Changelog

v0.8

  • Redirect output to syslog when running in the background
  • New command-line option:
  • -memprofile: Write a memory allocation debugging profile the specified file

v0.7.2

  • Fix performance issue in small file creation
  • This brings performance on-par with EncFS paranoia mode, with streaming writes significantly faster
  • The actual fix is in the go-fuse library. There are no code changes in gocryptfs.

v0.7.1

  • Make the build.bash script compatible with Go 1.3
  • Disable fallocate on OSX (system call not availabe)
  • Introduce pre-built binaries for Fedora 23 and Debian 8

v0.7

  • Extend GCM IV size to 128 bit from Go's default of 96 bit
  • This pushes back the birthday bound to make IV collisions virtually impossible
  • This is a forwards-compatible change. gocryptfs v0.7 can mount filesystems created by earlier versions but not the other way round.
  • New command-line option:
  • -gcmiv128: Use 128-bit GCM IVs (default true)

v0.6

  • Wide-block filename encryption using EME + DirIV
  • EME (ECB-Mix-ECB) provides even better security than CBC as it fixes the prefix leak. The used Go EME implementation is https://github.com/rfjakob/eme which is, as far as I know, the first implementation of EME in Go.
  • This is a forwards-compatible change. gocryptfs v0.6 can mount filesystems created by earlier versions but not the other way round.
  • New command-line option:
  • -emenames: Enable EME filename encryption (default true)

v0.5.1

  • Fix a rename regression caused by DirIV and add test case
  • Use fallocate to guard against out-of-space errors

v0.5

  • Stronger filename encryption: DirIV
  • Each directory gets a random 128 bit file name IV on creation, stored in gocryptfs.diriv
  • This makes it impossible to identify identically-named files across directories
  • A single-entry IV cache brings the performance cost of DirIV close to zero for common operations (see performance.txt)
  • This is a forwards-compatible change. gocryptfs v0.5 can mount filesystems created by earlier versions but not the other way round.
  • New command-line option:
  • -diriv: Use the new per-directory IV file name encryption (default true)
  • -scryptn: allows to set the scrypt cost parameter N. This option can be used for faster mounting at the cost of lower brute-force resistance. It was mainly added to speed up the automated tests.

v0.4

  • New command-line options:
  • -plaintextnames: disables filename encryption, added on user request
  • -extpass: calls an external program for prompting for the password
  • -config: allows to specify a custom gocryptfs.conf path
  • Add FeatureFlags gocryptfs.conf paramter
  • This is a config format change, hence the on-disk format is incremented
  • Used for ext4-style filesystem feature flags. This should help avoid future format changes. The first user is -plaintextnames.
  • On-disk format 2

v0.3

  • Add a random 128 bit file header to authenticate file->block ownership
  • This is an on-disk-format change
  • On-disk format 1

v0.2

  • Replace bash daemonization wrapper with native Go implementation
  • Better user feedback on mount failures

v0.1

  • First release
  • On-disk format 0

See https://github.com/rfjakob/gocryptfs/tags for the release dates and associated git tags.