diff --git a/SftpFrontend.md b/SftpFrontend.md index 9b7825c..29e809e 100644 --- a/SftpFrontend.md +++ b/SftpFrontend.md @@ -48,9 +48,9 @@ The `-o big_writes` option to `sshfs` may improve write performance. # Specific clients -## sshfs +## sshfs on Linux -sshfs is an SFTP client that allows filesystem access via FUSE (a user-space filesystem layer). It works on Linux and other Unix systems that provide FUSE. For Mac OS X, a patched version of sshfs is included as part of [MacFUSE](http://code.google.com/p/macfuse/). +sshfs is an SFTP client that allows filesystem access via FUSE (a user-space filesystem layer). It works on Linux and other Unix systems that provide FUSE. (See below for Mac OS X.) Tahoe's SFTP frontend includes several workarounds and extensions to make it function correctly with sshfs. @@ -68,11 +68,20 @@ If a file in a mutable directory is closed concurrently with an operation that n A POSIX application might assume that deleting a non-empty directory will fail, when it does not on a Tahoe filesystem (#1362). +To avoid potential bugs with rekeying, either use the `-o [RekeyLimit](RekeyLimit)=0` option to `sshfs`, or add the line `RekeyLimit=0` to `~/.ssh/config`. + + +## sshfs on Mac OS X + +For Mac OS X, a patched version of sshfs is included as part of [MacFUSE](http://code.google.com/p/macfuse/). + +However, development of MacFUSE stalled at version 2.0.3, which does not work on the 64-bit kernels used by default in Snow Leopard or Lion, and development has subsequently [splintered into several forks](@@http://www.mail-archive.com/macfuse@googlegroups.com/msg02517.html@@). The Tuxera fork (version 2.2.1) does not work with Tahoe-LAFS, possibly due to issue (2) in [this post](http://osdir.com/ml/macfuse/2011-08/msg00052.html). The Bryan Pahm, OSXFUSE, and FUSE4X forks have not been tested. + +Version 2.0.3 *does* work on Leopard (Mac OS X 10.5.8), with all the caveats noted for Linux above, and the following additional ones: + The MacFUSE version of sshfs stores "extended attributes" in files with names starting with "`._`". For example the attributes for "`foo.txt`" would be stored in a file called "`._foo.txt`". Since some Mac OS X applications may depend on these attributes (especially for their own file formats), if you need to copy or move the original file then you should copy or move the attribute file along with it. The OS X `cp` and `mv` commands will do this by default; operations using the Tahoe WUI or CLI will not (unless you are moving all files in a directory). Note that filenames beginning with "`.`" are not listed by default by `ls`. -On Mac OS X, TextEdit and vi are known to have problems editing files on a Tahoe-via-sshfs filesystem. - -To avoid potential bugs with rekeying, either use the `-o [RekeyLimit](RekeyLimit)=0` option to `sshfs`, or add the line `RekeyLimit=0` to `~/.ssh/config`. +TextEdit and vi are known to have problems editing files on a Tahoe-via-sshfs filesystem on Mac OS X. ## Gnome virtual filesystem (gvfs)