From 5992252b3d5e0b37587bf3f234d289ffeae42ba4 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Thu, 16 Mar 2000 11:32:53 +0000 Subject: updates and fixes --- README.curl | 67 +++++++++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 50 insertions(+), 17 deletions(-) (limited to 'README.curl') diff --git a/README.curl b/README.curl index 3daca8caa..7cddbca6c 100644 --- a/README.curl +++ b/README.curl @@ -122,33 +122,37 @@ UPLOADING FTP - Upload all data on stdin to a specified ftp site: + Upload all data on stdin to a specified ftp site: curl -t ftp://ftp.upload.com/myfile - Upload data from a specified file, login with user and password: + Upload data from a specified file, login with user and password: curl -T uploadfile -u user:passwd ftp://ftp.upload.com/myfile - Upload a local file to the remote site, and use the local file name remote - too: + Upload a local file to the remote site, and use the local file name remote + too: curl -T uploadfile -u user:passwd ftp://ftp.upload.com/ - NOTE: Curl is not currently supporing ftp upload through a proxy! The reason - for this is simply that proxies are seldomly configured to allow this and - that no author has supplied code that makes it possible! + Upload a local file to get appended to the remote file using ftp: + + curl -T localfile -a ftp://ftp.upload.com/remotefile + + NOTE: Curl does not support ftp upload through a proxy! The reason for this + is simply that proxies are seldomly configured to allow this and that no + author has supplied code that makes it possible! HTTP - Upload all data on stdin to a specified http site: + Upload all data on stdin to a specified http site: curl -t http://www.upload.com/myfile - Note that the http server must've been configured to accept PUT before this - can be done successfully. + Note that the http server must've been configured to accept PUT before this + can be done successfully. - For other ways to do http data upload, see the POST section below. + For other ways to do http data upload, see the POST section below. VERBOSE / DEBUG @@ -457,9 +461,9 @@ FTP and firewalls HTTPS - Secure HTTP requires SSLeay to be installed and used when curl is built. If - that is done, curl is capable of retrieving and posting documents using the - HTTPS procotol. + Secure HTTP requires SSL libraries to be installed and used when curl is + built. If that is done, curl is capable of retrieving and posting documents + using the HTTPS procotol. Example: @@ -472,9 +476,10 @@ HTTPS browsers (Netscape and MSEI both use the so called PKCS#12 format). If you want curl to use the certificates you use with your (favourite) browser, you may need to download/compile a converter that can convert your browser's - formatted certificates to PEM formatted ones. Dr Stephen N. Henson has - written a patch for SSLeay that adds this functionality. You can get his - patch (that requires an SSLeay installation) from his site at: + formatted certificates to PEM formatted ones. This kind of converter is + included in recent versions of OpenSSL, and for older versions Dr Stephen + N. Henson has written a patch for SSLeay that adds this functionality. You + can get his patch (that requires an SSLeay installation) from his site at: http://www.drh-consultancy.demon.co.uk/ Example on how to automatically retrieve a document using a certificate with @@ -601,6 +606,34 @@ ENVIRONMENT VARIABLES The usage of the -x/--proxy flag overrides the environment variables. +NETRC + + Unix introduced the .netrc concept a long time ago. It is a way for a user + to specify name and password for commonly visited ftp sites in a file so + that you don't have to type them in each time you visit those sites. You + realize this is a big security risk if someone else gets hold of your + passwords, so therefor most unix programs won't read this file unless it is + only readable by yourself (curl doesn't care though). + + Curl supports .netrc files if told so (using the -n/--netrc option). This is + not restricted to only ftp, but curl can use it for all protocols where + authentication is used. + + A very simple .netrc file could look something like: + + machine curl.haxx.nu login iamdaniel password mysecret + +CUSTOM OUTPUT + + To better allow script programmers to get to know about the progress of + curl, the -w/--write-out option was introduced. Using this, you can specify + what information from the previous transfer you want to extract. + + To display the amount of bytes downloaded together with some text and an + ending newline: + + curl -w 'We downloaded %{size_download} bytes\n' www.download.com + MAILING LIST We have an open mailing list to discuss curl, its development and things -- cgit v1.2.3