borg-umount.1 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112
  1. .\" Man page generated from reStructuredText.
  2. .
  3. .
  4. .nr rst2man-indent-level 0
  5. .
  6. .de1 rstReportMargin
  7. \\$1 \\n[an-margin]
  8. level \\n[rst2man-indent-level]
  9. level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
  10. -
  11. \\n[rst2man-indent0]
  12. \\n[rst2man-indent1]
  13. \\n[rst2man-indent2]
  14. ..
  15. .de1 INDENT
  16. .\" .rstReportMargin pre:
  17. . RS \\$1
  18. . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
  19. . nr rst2man-indent-level +1
  20. .\" .rstReportMargin post:
  21. ..
  22. .de UNINDENT
  23. . RE
  24. .\" indent \\n[an-margin]
  25. .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
  26. .nr rst2man-indent-level -1
  27. .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
  28. .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
  29. ..
  30. .TH "BORG-UMOUNT" "1" "2025-05-22" "" "borg backup tool"
  31. .SH NAME
  32. borg-umount \- un-mount the FUSE filesystem
  33. .SH SYNOPSIS
  34. .sp
  35. borg [common options] umount [options] MOUNTPOINT
  36. .SH DESCRIPTION
  37. .sp
  38. This command un\-mounts a FUSE filesystem that was mounted with \fBborg mount\fP\&.
  39. .sp
  40. This is a convenience wrapper that just calls the platform\-specific shell
  41. command \- usually this is either umount or fusermount \-u.
  42. .SH OPTIONS
  43. .sp
  44. See \fIborg\-common(1)\fP for common options of Borg commands.
  45. .SS arguments
  46. .INDENT 0.0
  47. .TP
  48. .B MOUNTPOINT
  49. mountpoint of the filesystem to umount
  50. .UNINDENT
  51. .SH EXAMPLES
  52. .INDENT 0.0
  53. .INDENT 3.5
  54. .sp
  55. .EX
  56. # Mounting the repository shows all archives.
  57. # Archives are loaded lazily, expect some delay when navigating to an archive
  58. # for the first time.
  59. $ borg mount /tmp/mymountpoint
  60. $ ls /tmp/mymountpoint
  61. root\-2016\-02\-14 root\-2016\-02\-15
  62. $ borg umount /tmp/mymountpoint
  63. # The \(dqversions view\(dq merges all archives in the repository
  64. # and provides a versioned view on files.
  65. $ borg mount \-o versions /tmp/mymountpoint
  66. $ ls \-l /tmp/mymountpoint/home/user/doc.txt/
  67. total 24
  68. \-rw\-rw\-r\-\- 1 user group 12357 Aug 26 21:19 doc.cda00bc9.txt
  69. \-rw\-rw\-r\-\- 1 user group 12204 Aug 26 21:04 doc.fa760f28.txt
  70. $ borg umount /tmp/mymountpoint
  71. # Archive filters are supported.
  72. # These are especially handy for the \(dqversions view\(dq,
  73. # which does not support lazy processing of archives.
  74. $ borg mount \-o versions \-\-match\-archives \(aqsh:*\-my\-home\(aq \-\-last 10 /tmp/mymountpoint
  75. # Exclusion options are supported.
  76. # These can speed up mounting and lower memory needs significantly.
  77. $ borg mount /path/to/repo /tmp/mymountpoint only/that/path
  78. $ borg mount \-\-exclude \(aq...\(aq /tmp/mymountpoint
  79. .EE
  80. .UNINDENT
  81. .UNINDENT
  82. .SS borgfs
  83. .INDENT 0.0
  84. .INDENT 3.5
  85. .sp
  86. .EX
  87. $ echo \(aq/mnt/backup /tmp/myrepo fuse.borgfs defaults,noauto 0 0\(aq >> /etc/fstab
  88. $ mount /tmp/myrepo
  89. $ ls /tmp/myrepo
  90. root\-2016\-02\-01 root\-2016\-02\-2015
  91. .EE
  92. .UNINDENT
  93. .UNINDENT
  94. .sp
  95. \fBNOTE:\fP
  96. .INDENT 0.0
  97. .INDENT 3.5
  98. \fBborgfs\fP will be automatically provided if you used a distribution
  99. package or \fBpip\fP to install Borg. Users of the standalone binary will have
  100. to manually create a symlink (see \fIpyinstaller\-binary\fP).
  101. .UNINDENT
  102. .UNINDENT
  103. .SH SEE ALSO
  104. .sp
  105. \fIborg\-common(1)\fP, \fIborg\-mount(1)\fP
  106. .SH AUTHOR
  107. The Borg Collective
  108. .\" Generated by docutils manpage writer.
  109. .