From 7cb36a20b418f60a06c4a3c2566603bea967eade Mon Sep 17 00:00:00 2001
From: Milkey Mouse <milkey-mouse@users.noreply.github.com>
Date: Sat, 18 Nov 2017 11:57:39 -0800
Subject: [PATCH] Document sshfs rename workaround (fixes #3315) (#3325)

Document sshfs rename workaround, fixes #3315
---
 docs/faq.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/faq.rst b/docs/faq.rst
index 051d28806..8efc21f76 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -719,6 +719,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
+
+
 Miscellaneous
 #############