summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorenkore <public@enkore.de>2017-06-30 11:05:47 +0200
committerGitHub <noreply@github.com>2017-06-30 11:05:47 +0200
commit193c1850e4752d54a994adb611bdc0291a805104 (patch)
treed3b4c097e01e35d15c32b5215c17054baf5d6086
parent50066d75fcb0a01b2d8bc7ad8b07c6a51a54eef2 (diff)
parent52f76d2cd6f2b7ddb6cea90e60a0f9c63a3cd016 (diff)
Merge pull request #2767 from enkore/issue/2462
docs: mount: add repository example
-rw-r--r--docs/usage/mount.rst21
1 files changed, 15 insertions, 6 deletions
diff --git a/docs/usage/mount.rst b/docs/usage/mount.rst
index f5f1b4f5b..a3ab2ea32 100644
--- a/docs/usage/mount.rst
+++ b/docs/usage/mount.rst
@@ -5,26 +5,35 @@
Examples
~~~~~~~~
-borg mount
-++++++++++
::
- $ borg mount /path/to/repo::root-2016-02-15 /tmp/mymountpoint
+ # Mounting the repository shows all archives.
+ # Archives are loaded lazily, expect some delay when navigating to an archive
+ # for the first time.
+ $ borg mount /path/to/repo /tmp/mymountpoint
$ ls /tmp/mymountpoint
- bin boot etc home lib lib64 lost+found media mnt opt root sbin srv tmp usr var
+ root-2016-02-14 root-2016-02-15
$ borg umount /tmp/mymountpoint
-::
+ # Mounting a specific archive is possible as well.
+ $ borg mount /path/to/repo::root-2016-02-15 /tmp/mymountpoint
+ $ ls /tmp/mymountpoint
+ bin boot etc home lib lib64 lost+found media mnt opt
+ root sbin srv tmp usr var
+ $ borg umount /tmp/mymountpoint
+ # The experimental versions view merges all archives in the repository
+ # and provides a versioned view on files.
$ borg mount -o versions /path/to/repo /tmp/mymountpoint
$ ls -l /tmp/mymountpoint/home/user/doc.txt/
total 24
-rw-rw-r-- 1 user group 12357 Aug 26 21:19 doc.txt.cda00bc9
-rw-rw-r-- 1 user group 12204 Aug 26 21:04 doc.txt.fa760f28
- $ fusermount -u /tmp/mymountpoint
+ $ borg umount /tmp/mymountpoint
borgfs
++++++
+
::
$ echo '/mnt/backup /tmp/myrepo fuse.borgfs defaults,noauto 0 0' >> /etc/fstab