Browse Source

Merge pull request #3345 from milkey-mouse/document-sshfs-stupidity-bp1.0

Document sshfs rename workaround (1.0 backport)
TW 7 years ago
parent
commit
52b5f98cbb
1 changed files with 12 additions and 0 deletions
  1. 12 0
      docs/faq.rst

+ 12 - 0
docs/faq.rst

@@ -529,6 +529,18 @@ rather not implement progress / ETA display than doing futile attempts.
 See also: https://xkcd.com/612/
 
 
+Why am I getting 'Operation not permitted' errors when backing up on sshfs?
+---------------------------------------------------------------------------
+
+By default, ``sshfs`` is not entirely POSIX-compliant when renaming files due to
+a technicality in the SFTP protocol. Fortunately, it also provides a workaround_
+to make it behave correctly::
+
+    sshfs -o workaround=rename user@host:dir /mnt/dir
+
+.. _workaround: https://unix.stackexchange.com/a/123236
+
+
 Requirements for the borg single-file binary, esp. (g)libc?
 -----------------------------------------------------------