From 42cabc14d44b69af1df71f6f1e0ae8ccb66a8287 Mon Sep 17 00:00:00 2001 From: Dan Fandrich Date: Fri, 1 Aug 2008 18:41:14 +0000 Subject: Added support for --append on SFTP uploads. Unfortunately, OpenSSH doesn't support this so it goes untested. --- docs/MANUAL | 29 ++++++++++++++++++++++++----- 1 file changed, 24 insertions(+), 5 deletions(-) (limited to 'docs/MANUAL') diff --git a/docs/MANUAL b/docs/MANUAL index 3b1195c0b..3aea5d40f 100644 --- a/docs/MANUAL +++ b/docs/MANUAL @@ -48,6 +48,9 @@ SIMPLE USAGE curl -u username: --key ~/.ssh/id_dsa --pubkey ~/.ssh/id_dsa.pub \ scp://shell.example.com/~/personal.txt + Get the main page from an IPv6 web server: + + curl -g "http://[2001:1890:1112:1::20]/" DOWNLOAD TO A FILE @@ -86,6 +89,13 @@ USING PASSWORDS standards while the recommended "explicit" way is done by using FTP:// and the --ftp-ssl option. + SFTP / SCP + + This is similar to FTP, but you can specify a private key to use instead of + a password. Note that the private key may itself be protected by a password + that is unrelated to the login password of the remote system. If you + provide a private key file you must also provide a public key file. + HTTP Curl also supports user and password in HTTP URLs, thus you can pick a file @@ -154,9 +164,9 @@ RANGES UPLOADING - FTP + FTP / FTPS / SFTP / SCP - Upload all data on stdin to a specified ftp site: + Upload all data on stdin to a specified server: curl -T - ftp://ftp.upload.com/myfile @@ -169,7 +179,7 @@ UPLOADING curl -T uploadfile -u user:passwd ftp://ftp.upload.com/ - Upload a local file to get appended to the remote file using ftp: + Upload a local file to get appended to the remote file: curl -T localfile -a ftp://ftp.upload.com/remotefile @@ -331,7 +341,7 @@ REFERRER curl -e www.coolsite.com http://www.showme.com/ - NOTE: The referer field is defined in the HTTP spec to be a full URL. + NOTE: The Referer: [sic] field is defined in the HTTP spec to be a full URL. USER AGENT @@ -564,6 +574,14 @@ FTP and PATH NAMES (I.e with an extra slash in front of the file name.) +SFTP and SCP and PATH NAMES + + With sftp: and scp: URLs, the path name given is the absolute name on the + server. To access a file relative to the remote user's home directory, + prefix the file with /~/ , such as: + + curl -u $USER sftp://home.example.com/~/.bashrc + FTP and firewalls The FTP protocol requires one of the involved parties to open a second @@ -875,7 +893,8 @@ MULTIPLE TRANSFERS WITH A SINGLE COMMAND LINE As is mentioned above, you can download multiple files with one command line by simply adding more URLs. If you want those to get saved to a local file instead of just printed to stdout, you need to add one save option for each - URL you specify. Note that this also goes for the -O option. + URL you specify. Note that this also goes for the -O option (but not + --remote-name-all). For example: get two files and use -O for the first and a custom file name for the second: -- cgit v1.2.3