Skip to content
This repository

A FUSE-based filesystem for box.com

branch: master

Re-enable passing options to fuse

You will need at least libapp commit ef0be9daca.
Syntax is: boxfs _boxopts_ -- _fuseopts_
latest commit 95926076ab
Domenico Rotiroti authored March 26, 2014
Octocat-spinner-32 .gitignore Applied patch from fjaeger for static linking November 28, 2013
Octocat-spinner-32 Makefile Update deps if compiling statically December 04, 2013
Octocat-spinner-32 README.V1 Doc and license update October 29, 2013
Octocat-spinner-32 README.md Applied patch from fjaeger for static linking November 28, 2013
Octocat-spinner-32 boxapi.c Re-enable passing options to fuse March 26, 2014
Octocat-spinner-32 boxapi.h Re-enable passing options to fuse March 26, 2014
Octocat-spinner-32 boxcache.c Added some more check January 27, 2014
Octocat-spinner-32 boxcache.h let users choose install PREFIX, removed some warning November 05, 2013
Octocat-spinner-32 boxfs-init expire cache entries, better help messages October 31, 2013
Octocat-spinner-32 boxfs.c Re-enable passing options to fuse March 26, 2014
Octocat-spinner-32 boxhttp.c Small fixes January 28, 2014
Octocat-spinner-32 boxhttp.h cleanup, again October 29, 2013
Octocat-spinner-32 boxjson.c remove some unneeded allocation November 08, 2013
Octocat-spinner-32 boxjson.h Fixed a couple of warnings December 11, 2013
Octocat-spinner-32 boxopts.c Re-enable passing options to fuse March 26, 2014
Octocat-spinner-32 boxopts.h expire cache entries, better help messages October 31, 2013
Octocat-spinner-32 boxpath.c Small fixes January 28, 2014
Octocat-spinner-32 boxpath.h fixed reading dirs with more than 100 items November 07, 2013
Octocat-spinner-32 boxutils.c Mount time fixes January 24, 2014
Octocat-spinner-32 boxutils.h let users choose install PREFIX, removed some warning November 05, 2013
Octocat-spinner-32 gpl-3.0.txt Doc and license update October 29, 2013
Octocat-spinner-32 mkrel.sh Support for mtime and ctime, part III (dir support, / missing) November 25, 2009
README.md

BOXFS

A FUSE-based filesystem for box.com.

This software is licensed under the GPLv3 Licence and comes with NO WARRANTY. Use at your own risk. See gpl-3.0.txt.

Boxfs use the v2 version of box.com api (see http://developers.box.com/docs/), older versions used the v1 api.

Compiling

If you prefer a static build or don't want to install libapp and libjson system-wide, you can run make static to:

  • download (git clone) libapp and libjson, inside the boxfs source tree
  • compile them
  • link boxfs against those local libs

Usage

Boxfs can read options from command line or from a config file.

The simplest way to start is to run the script boxfs-init and let it create a configuration file for you.

The first time you run boxfs, you will need to complete the authentication (oauth2) process and grant access to your box.com account. It's easy, just follow the instructions on the terminal and on your browser.

The first mount can be quite slow because boxfs will fetch and cache info (metadata, not file contents!) about your folders.

Usage: boxfs [options] [mountPoint]

Options:
  -h                          shows this help message
  -f               conffile   file containing configuration options
  -t --token_file  tokenfile  file containing oauth tokens
  -c --cache_dir   cachedir   directory used to cache metadata
  -e --expire_time N          expire time for cache entries (in minutes)
  -l --largefiles             enable support for large files (splitting)
  -v --verbose                turn on verbose syslogging
  -U --uid                    user id to use as file owner (defaults to you)
  -G --gid                    group id to use for group permissions
  -F --fperm                  file permissions (default 0644)
  -D --dperm                  directory permissions (default 0755)

When you've done using your files, unmount your filsystem with fusermount -u mountpoint

Authors and Contributors

Boxfs is written by Domenico Rotiroti with contributions from other GitHub users.

See README.V1 for a list of people who helped in the previous releases.

Known problems/limitations

  • Sharing, tags and other file metadata are not handled
  • Updates made from outside boxfs are not visible until remount
  • Can't create empty files
Something went wrong with that request. Please try again.