mirror of
https://github.com/borgbackup/borg.git
synced 2025-01-24 08:19:03 +00:00
e1f6a34820
- add archiver.main_mount()
- provide borgfs behaviour when the monolithic binary is called via a
symlink called borgfs
- docs: update usage of mount subcommand, provide examples for borgfs and
add symlink creation to standalone binary installation
- run build_usage
- add entry point in setup.py
- patch helpers.py:get_keys_dir() to allow mounting fstab entries with
"user" option set
Without this, setuid() called at some point by mount changes the HOME
environment variable to '/root' and os.expanduser('~') would return
'/root' as well, thus the mount would fail with
PermissionError: [Errno 13] Permission denied: '/root/.config'
After setuid(), the HOME variable stays intact, so we still can
explicitly query USER's home.
Also, os.path.expanduser() behaves differently for '~' and '~someuser'
as parameters: when called with an explicit username, the possibly set
environment variable HOME is no longer respected. So we have to check if
it is set and only expand the user's home directory if HOME is unset.
- add myself to AUTHORS
47 lines
1.9 KiB
PHP
47 lines
1.9 KiB
PHP
.. _borg_mount:
|
|
|
|
borg mount
|
|
----------
|
|
::
|
|
|
|
usage: borg mount [-h] [-v] [--debug] [--lock-wait N] [--show-rc]
|
|
[--no-files-cache] [--umask M] [--remote-path PATH] [-f]
|
|
[-o OPTIONS]
|
|
REPOSITORY_OR_ARCHIVE MOUNTPOINT
|
|
|
|
Mount archive or an entire repository as a FUSE fileystem
|
|
|
|
positional arguments:
|
|
REPOSITORY_OR_ARCHIVE
|
|
repository/archive to mount
|
|
MOUNTPOINT where to mount filesystem
|
|
|
|
optional arguments:
|
|
-h, --help show this help message and exit
|
|
-v, --verbose, --info
|
|
enable informative (verbose) output, work on log level
|
|
INFO
|
|
--debug enable debug output, work on log level DEBUG
|
|
--lock-wait N wait for the lock, but max. N seconds (default: 1).
|
|
--show-rc show/log the return code (rc)
|
|
--no-files-cache do not load/update the file metadata cache used to
|
|
detect unchanged files
|
|
--umask M set umask to M (local and remote, default: 0077)
|
|
--remote-path PATH set remote path to executable (default: "borg")
|
|
-f, --foreground stay in foreground, do not daemonize
|
|
-o OPTIONS Extra mount options
|
|
|
|
Description
|
|
~~~~~~~~~~~
|
|
|
|
This command mounts an archive as a FUSE filesystem. This can be useful for
|
|
browsing an archive or restoring individual files. Unless the ``--foreground``
|
|
option is given the command will run in the background until the filesystem
|
|
is ``umounted``.
|
|
|
|
The command ``borgfs`` provides a wrapper for ``borg mount``. This can also be
|
|
used in fstab entries:
|
|
``/path/to/repo /mnt/point fuse.borgfs defaults,noauto 0 0``
|
|
|
|
To allow a regular user to use fstab entries, add the ``user`` option:
|
|
``/path/to/repo /mnt/point fuse.borgfs defaults,noauto,user 0 0``
|