Permalink
Find file
Fetching contributors…
Cannot retrieve contributors at this time
101 lines (77 sloc) 3.76 KB
_______________ ____ __ ______________
/ ___/_ __/ __ \/ __ \/ |/ / ____/ ___/
\__ \ / / / / / / /_/ / /|_/ / /_ \__ \
___/ // / / /_/ / _, _/ / / / __/ ___/ /
/____//_/ \____/_/ |_/_/ /_/_/ /____/
A FUSE abstraction layer for cloud storage.
Installation Requirements:
=============================================================================
- libfuse ([sudo] apt-get install libfuse-dev libfuse2 fuse-utils)
- libcurl ([sudo] apt-get install libcurl4-gnutls-dev
* OR *
libcurl4-openssl-dev
- glib2 ([sudo] apt-get install libglib2.0-dev)
- autotools ([sudo] apt-get install automake)
- mime-support ([sudo] apt-get install mime-support)
Build:
=============================================================================
./autogen.sh
./configure
make
[make install]
Configuration:
=============================================================================
See the supplied stormfs.conf.example for a basic configuration file
Usage: (see --help for a full list of options)
=============================================================================
stormfs bucket mountpoint [options]
general options:
-o opt,[opt...] mount options
-h --help print help
-V --version print version
STORMFS options:
-o config=CONFIG path to configuration file
(default: /etc/stormfs.conf)
-o url=URL specify a custom service URL
-o acl=ACL canned acl applied to objects (default: private)
valid options: {private,
public-read,
public-read-write,
authenticated-read,
bucket-owner-read,
bucket-owner-full-control}
-o expires=RFC1123DATE expires HTTP header applied to objects
e.g.: Thu\\,\ 08\ Apr\ 2012\ 20:00:00\ GMT
(default: disabled)
-o use_ssl force the use of SSL
-o no_verify_ssl skip SSL certificate/host verification
-o use_rrs use reduced redundancy storage
-o encryption enable server-side encryption
-o mime_path=PATH path to mime.types (default: /etc/mime.types)
-o cache_path=PATH path for cached file storage (default: /tmp/stormfs)
-o cache_timeout=N sets the cache timeout in seconds (default: 300)
-o nocache disable the cache (cache is enabled by default)
Supported APIs
=============================================================================
Amazon Simple Storage Service (Amazon S3)
Eucalyptus (Walrus S3)
Google Cloud Storage[1]
Support is planned for the following services:
Dropbox
Rackspace Cloud Files
Google Cloud Storage (native API)
[1] You must enable "Interoperable Access" and use the provided
"Legacy Storage Access Keys"
Testing
=============================================================================
STORMfs strives to be fully POSIX compliant, the folks at Tuxera have created
an extensive test suit available at:
http://www.tuxera.com/community/posix-test-suite/
Once compiled, you can run the tests like so:
$ cd /path/to/mounted/bucked/testdir
$ prove -r /path/to/fstest
BUGS
=============================================================================
Bugs can be reported at https://github.com/benlemasurier/stormfs/issues
Please be sure to check whether your bug has already been submitted. If it
hasn't, try to provide as much information as necessary to reproduce the bug.