Documentation/bup-fuse.md

   1 % bup-fuse(1) Bup %BUP_VERSION%
   2 % Avery Pennarun <apenwarr@gmail.com>
   3 % %BUP_DATE%
   4
   5 # NAME
   6
   7 bup-fuse - mount a bup repository as a filesystem
   8
   9 # SYNOPSIS
  10
  11 bup fuse [-d] [-f] [-o] \<mountpoint\>
  12
  13 # DESCRIPTION
  14
  15 `bup fuse` opens a bup repository and exports it as a
  16 `fuse`(7) userspace filesystem.
  17
  18 This feature is only available on systems (such as Linux)
  19 which support FUSE.
  20
  21 **WARNING**: bup fuse is still experimental and does not
  22 enforce any file permissions!  All files will be readable
  23 by all users.
  24
  25 When you're done accessing the mounted fuse filesystem, you
  26 should unmount it with `umount`(8).
  27
  28 # OPTIONS
  29
  30 -d, \--debug
  31 :   run in the foreground and print FUSE debug information
  32     for each request.
  33
  34 -f, \--foreground
  35 :   run in the foreground and exit only when the filesystem
  36     is unmounted.
  37
  38 -o, \--allow-other
  39 :   permit other users to access the filesystem. Necessary for
  40     exporting the filesystem via Samba, for example.
  41
  42 # EXAMPLES
  43     rm -rf /tmp/buptest
  44     mkdir /tmp/buptest
  45     sudo bup fuse -d /tmp/buptest
  46     ls /tmp/buptest/*/latest
  47     ...
  48     umount /tmp/buptest
  49
  50 # SEE ALSO
  51
  52 `fuse`(7), `fusermount`(1), `bup-ls`(1), `bup-ftp`(1),
  53 `bup-restore`(1), `bup-web`(1)
  54
  55 # BUP
  56
  57 Part of the `bup`(1) suite.