aboutsummaryrefslogtreecommitdiff
path: root/sshfs.rst
diff options
context:
space:
mode:
Diffstat (limited to 'sshfs.rst')
-rw-r--r--sshfs.rst13
1 files changed, 13 insertions, 0 deletions
diff --git a/sshfs.rst b/sshfs.rst
index dac3108..d91a99c 100644
--- a/sshfs.rst
+++ b/sshfs.rst
@@ -107,6 +107,8 @@ Options
:rename: Emulate overwriting an existing file by deleting and
renaming.
+ :renamexdev: Make rename fail with EXDEV instead of the default EPERM
+ to allow moving files across remote filesystems.
:truncate: Work around servers that don't support truncate by
coping the whole file, truncating it locally, and sending it
back.
@@ -228,6 +230,17 @@ removed it, but before SSHFS had the time to rename the old file. In
this case, the rename will still fail.
+Permission denied when moving files across remote filesystems
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Most SFTP servers return only a generic "failure" when failing to rename
+across filesystem boundaries (EXDEV). sshfs normally converts this generic
+failure to a permission denied error (EPERM). If the option ``-o
+workaround=renamexdev`` is given, generic failures will be considered EXDEV
+errors which will make programs like `mv(1)` attempt to actually move the
+file after the failed rename.
+
+
SSHFS hangs
~~~~~~~~~~~