FAQ: How to SFTP from my user's home directory?

diff --git a/docs/FAQ b/docs/FAQ
index 5f1740b43d8ebe7a83fc9246a2f34a72c3a2cc8d..53f927004e400c0142e8cb839e05bcf8229ee01d 100644 (file)
--- a/docs/FAQ
+++ b/docs/FAQ
@@ -1,4 +1,4 @@
-Updated: January 29, 2011 (http://curl.haxx.se/docs/faq.html)
+Updated: March 7, 2011 (http://curl.haxx.se/docs/faq.html)
                                   _   _ ____  _
                               ___| | | |  _ \| |
                              / __| | | | |_) | |
@@ -51,6 +51,7 @@ FAQ
   3.17 How do I list the root dir of an FTP server?
   3.18 Can I use curl to send a POST/PUT and not wait for a response?
   3.19 How do I get HTTP from a host using a specific IP address?
+  3.20 How to SFTP from my user's home directory?
 
  4. Running Problems
   4.1 Problems connecting to SSL servers.
@@ -715,6 +716,21 @@ FAQ
 
     curl --header "Host: www.example.com" http://127.0.0.1/
 
+  3.20 How to SFTP from my user's home directory?
+
+  Contrary to how FTP works, SFTP and SCP URLs specify the exact directory to
+  work with. It means that if you don't specify that you want the user's home
+  directory, you get the actual root directory.
+
+  To specify a file in your user's home directory, you need to use the correct
+  URL syntax which for sftp might look similar to:
+
+    curl -O -u user:password sftp://example.com/~/file.txt
+
+  and for SCP it is just a different protocol prefix:
+
+    curl -O -u user:password scp://example.com/~/file.txt
+
 
 4. Running Problems