From 838ef1b53a51a6b27c896adc040a0d7f79ad5221 Mon Sep 17 00:00:00 2001 From: Milkey Mouse Date: Fri, 17 Nov 2017 19:09:58 -0800 Subject: [PATCH] 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 2f4a9e119..38bafdf6e 100644 --- a/docs/faq.rst +++ b/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? -----------------------------------------------------------