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 # EXAMPLE
  43
  44     rm -rf /tmp/buptest
  45     mkdir /tmp/buptest
  46     sudo bup fuse -d /tmp/buptest
  47     ls /tmp/buptest/*/latest
  48     ...
  49     umount /tmp/buptest
  50
  51 # SEE ALSO
  52
  53 `fuse`(7), `fusermount`(1), `bup-ls`(1), `bup-ftp`(1),
  54 `bup-restore`(1), `bup-web`(1)
  55
  56 # BUP
  57
  58 Part of the `bup`(1) suite.