← Back to branch summary

~ubuntu-branches/ubuntu/natty/curl/natty-security

« back to all changes in this revision

Viewing changes to docs/MANUAL

  • Committer: Bazaar Package Importer
  • Author(s): Bhavani Shankar
  • Date: 2010-06-20 13:56:28 UTC
  • mfrom: (3.4.7 sid)
  • Revision ID: james.westby@ubuntu.com-20100620135628-e30tp9jldq6hq985
Tags: 7.21.0-1ubuntu1
https://launchpad.net/bugs/596334
* Merge from debian unstable.  Remaining changes: LP: #596334
  - Keep build deps in main:
    - Drop build dependencies: stunnel, libssh2-1-dev
    - Add build-dependency on openssh-server
    - Drop libssh2-1-dev from libcurl4-openssl-dev's Depends.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/MANUAL
46
46
  Get a file from an SSH server using SCP using a private key to authenticate:
47
47
 
48
48
        curl -u username: --key ~/.ssh/id_dsa --pubkey ~/.ssh/id_dsa.pub \
49
 
                scp://shell.example.com/~/personal.txt
 
49
            scp://shell.example.com/~/personal.txt
50
50
 
51
51
  Get the main page from an IPv6 web server:
52
52
 
168
168
 
169
169
  Get the first 100 bytes of a document using FTP:
170
170
 
171
 
        curl -r 0-99 ftp://www.get.this/README  
 
171
        curl -r 0-99 ftp://www.get.this/README
172
172
 
173
173
UPLOADING
174
174
 
184
184
 
185
185
  Upload a local file to the remote site, and use the local file name remote
186
186
  too:
187
 
 
 
187
 
188
188
        curl -T uploadfile -u user:passwd ftp://ftp.upload.com/
189
189
 
190
190
  Upload a local file to get appended to the remote file:
223
223
  this:
224
224
 
225
225
        curl --trace trace.txt www.haxx.se
226
 
 
 
226
 
227
227
 
228
228
DETAILED INFORMATION
229
229
 
325
325
  To send two files in one post you can do it in two ways:
326
326
 
327
327
  1. Send multiple files in a single "field" with a single field name:
328
 
 
329
 
        curl -F "pictures=@dog.gif,cat.gif" 
330
 
 
331
 
  2. Send two fields with two field names: 
332
 
 
333
 
        curl -F "docpicture=@dog.gif" -F "catpicture=@cat.gif" 
 
328
 
 
329
        curl -F "pictures=@dog.gif,cat.gif"
 
330
 
 
331
  2. Send two fields with two field names:
 
332
 
 
333
        curl -F "docpicture=@dog.gif" -F "catpicture=@cat.gif"
334
334
 
335
335
  To send a field value literally without interpreting a leading '@'
336
336
  or '<', or an embedded ';type=', use --form-string instead of
678
678
  formatted one that curl can use, do something like this (assuming netscape,
679
679
  but IE is likely to work similarly):
680
680
 
681
 
    You start with hitting the 'security' menu button in netscape. 
682
 
 
683
 
    Select 'certificates->yours' and then pick a certificate in the list 
684
 
 
685
 
    Press the 'export' button 
686
 
 
687
 
    enter your PIN code for the certs 
688
 
 
689
 
    select a proper place to save it 
 
681
    You start with hitting the 'security' menu button in netscape.
 
682
 
 
683
    Select 'certificates->yours' and then pick a certificate in the list
 
684
 
 
685
    Press the 'export' button
 
686
 
 
687
    enter your PIN code for the certs
 
688
 
 
689
    select a proper place to save it
690
690
 
691
691
    Run the 'openssl' application to convert the certificate. If you cd to the
692
692
    openssl installation, you can do it like:
793
793
 
794
794
  They should be set for protocol-specific proxies. General proxy should be
795
795
  set with
796
 
        
 
796
 
797
797
        ALL_PROXY
798
798
 
799
799
  A comma-separated list of host names that shouldn't go through any proxy is