[Assorted-commits] SF.net SVN: assorted:[987] sharing-gateway/trunk/README

[<yan...@us...>]

Revision: 987
          http://assorted.svn.sourceforge.net/assorted/?rev=987&view=rev
Author:   yangzhang
Date:     2008-10-05 18:42:32 +0000 (Sun, 05 Oct 2008)

Log Message:
-----------
updated documentation

Modified Paths:
--------------
    sharing-gateway/trunk/README

Modified: sharing-gateway/trunk/README
===================================================================
--- sharing-gateway/trunk/README	2008-10-05 17:17:01 UTC (rev 986)
+++ sharing-gateway/trunk/README	2008-10-05 18:42:32 UTC (rev 987)
@@ -9,12 +9,20 @@
 but:
 
 - uses a simple YAML configuration file format
+- allows usage of higher-level tools than `mount`, such as `sshfs`
 - can handle hostnames instead of IPs for CIFS shares
-- can create the mountpoint directories
+- can create and remove the mountpoint directories
 
 The rest of this is mostly documentation on how to configure your own servers
 for the gateway.
 
+Explicitly supported backends:
+
+- bind
+- curlftpfs
+- sshfs
+- cifs
+
 Setup
 -----
 
@@ -30,6 +38,17 @@
 [Python]: http://python.org/
 [Python YAML]: http://pyyaml.org/
 
+### Backends
+
+The following are conditionally required, depending on what kind of file
+systems you want to mount.
+
+- [sshfs]
+- [curlftpfs]
+
+[sshfs]: http://fuse.sourceforge.net/sshfs.html
+[curlftpfs]: http://curlftpfs.sourceforge.net/
+
 ### Web Frontend
 
 Requirements:
@@ -173,3 +192,17 @@
 - uploads
 
 The FTP server we'll use is ProFTPD.
+
+Tips
+----
+
+- When using a SSHFS, you may have a key pair that you use for authentication,
+  so that with ssh-agent you can get (nearly) passwordless logins.  However, to
+  allow the root user to mount this SSHFS using your credentials, you can still
+  get a passwordless without running ssh-agent for root by creating a
+  passwordless (insecure) copy of your private key.  This is done above in the
+  instructions for preparing certificates for HTTP/SSL (shown here for either
+  RSA or DSA):
+
+    openssl rsa -in id_rsa -out insecure_id_rsa
+    openssl dsa -in id_dsa -out insecure_id_dsa


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.