← Back to branch summary

~ubuntu-branches/ubuntu/saucy/curl/saucy-proposed

« back to all changes in this revision

Viewing changes to docs/curl.1

  • Committer: Package Import Robot
  • Author(s): Ubuntu Merge-o-Matic
  • Date: 2013-08-12 15:39:32 UTC
  • mfrom: (3.4.41 sid)
  • Revision ID: package-import@ubuntu.com-20130812153932-pmn0qwvy9vghe66x
Tags: 7.32.0-1ubuntu1
https://launchpad.net/bugs/1220928
* Merge from Debian unstable.  Remaining changes:
  - Drop dependencies not in main:
    + Build-Depends: Drop stunnel4 and libssh2-1-dev.
    + Drop libssh2-1-dev from binary package Depends.
  - Add new libcurl3-udeb package.
  - Add new curl-udeb package.
* Fixes freeipa-client join. (LP: #1220928)

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/curl.1
230
230
.IP "--connect-timeout <seconds>"
231
231
Maximum time in seconds that you allow the connection to the server to take.
232
232
This only limits the connection phase, once curl has connected this option is
233
 
of no more use. See also the \fI-m, --max-time\fP option.
 
233
of no more use.  Since 7.32.0, this option accepts decimal values, but the
 
234
actual timeout will decrease in accuracy as the specified timeout increases in
 
235
decimal precision. See also the \fI-m, --max-time\fP option.
234
236
 
235
237
If this option is used several times, the last one will be used.
236
238
.IP "--create-dirs"
393
395
recognized as password delimiter.  If the nickname contains "\\", it needs to
394
396
be escaped as "\\\\" so that it is not recognized as an escape character.
395
397
 
396
 
(iOS and Mac OS X only) If curl is built against Secure Transport, then the certificate string must match the name of a certificate that's in the system or user keychain. The private key corresponding to the certificate, and certificate chain (if any),  must also be present in the keychain.
 
398
(iOS and Mac OS X only) If curl is built against Secure Transport, then the
 
399
certificate string must match the name of a certificate that's in the system or
 
400
user keychain. The private key corresponding to the certificate, and
 
401
certificate chain (if any),  must also be present in the keychain.
397
402
 
398
403
If this option is used several times, the last one will be used.
399
404
.IP "--engine <name>"
810
815
.IP "-m, --max-time <seconds>"
811
816
Maximum time in seconds that you allow the whole operation to take.  This is
812
817
useful for preventing your batch jobs from hanging for hours due to slow
813
 
networks or links going down.  See also the \fI--connect-timeout\fP option.
 
818
networks or links going down.  Since 7.32.0, this option accepts decimal
 
819
values, but the actual timeout will decrease in accuracy as the specified
 
820
timeout increases in decimal precision.  See also the \fI--connect-timeout\fP
 
821
option.
814
822
 
815
823
If this option is used several times, the last one will be used.
816
824
.IP "--mail-auth <address>"
1043
1051
consistency. However, a server may require a POST to remain a POST after such
1044
1052
a redirection. This option is meaningful only when using \fI-L, --location\fP
1045
1053
(Added in 7.19.1)
 
1054
.IP "--post303"
 
1055
(HTTP) Tells curl to respect RFC 2616/10.3.2 and not convert POST requests
 
1056
into GET requests when following a 303 redirection. The non-RFC behaviour is
 
1057
ubiquitous in web browsers, so curl does the conversion by default to maintain
 
1058
consistency. However, a server may require a POST to remain a POST after such
 
1059
a redirection. This option is meaningful only when using \fI-L, --location\fP
 
1060
(Added in 7.26.0)
1046
1061
.IP "--proto <protocols>"
1047
1062
Tells curl to use the listed protocols for its initial retrieval. Protocols
1048
1063
are evaluated left to right, are comma separated, and are each a protocol
1280
1295
Silent or quiet mode. Don't show progress meter or error messages.  Makes Curl
1281
1296
mute. It will still output the data you ask for, potentially even to the
1282
1297
terminal/stdout unless you redirect it.
 
1298
.IP "--sasl-ir"
 
1299
Enable initial response in SASL authentication.
 
1300
(Added in 7.31.0)
1283
1301
.IP "-S, --show-error"
1284
1302
When used with \fI-s\fP it makes curl show an error message if it fails.
1285
1303
.IP "--ssl"
1675
1693
 
1676
1694
.IP "--xattr"
1677
1695
When saving output to a file, this option tells curl to store certain file
1678
 
metadata in extened file attributes. Currently, the URL is stored in the
 
1696
metadata in extended file attributes. Currently, the URL is stored in the
1679
1697
xdg.origin.url attribute and, for HTTP, the content type is stored in
1680
1698
the mime_type attribute. If the file system does not support extended
1681
1699
attributes, a warning is issued.
1695
1713
if not set.
1696
1714
 
1697
1715
If this option is used several times, the last one will be used.
1698
 
.IP "-z/--time-cond <date expression>|<file>"
 
1716
.IP "-z, --time-cond <date expression>|<file>"
1699
1717
(HTTP/FTP) Request a file that has been modified later than the given time and
1700
1718
date, or one that has been modified before that time. The <date expression>
1701
1719
can be all sorts of date strings or if it doesn't match any internal ones, it