diff options
author | Alex Bligh <alex@alex.org.uk> | 2010-04-24 12:16:48 +0200 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2010-04-24 12:18:04 +0200 |
commit | 36e245658b44fd8c37f4ff18b258ce6f8903f7cd (patch) | |
tree | 775cdc99d1a64210a181782ead4bcb99e299a121 /docs | |
parent | d487ade72c5f31703ce097e8460e0225fad80348 (diff) |
curl: added --proto and --proto-redir
--proto tells curl to use the listed protocols for its initial
retrieval
--proto-redir tells curl to use the listed protocols after a
redirect
Diffstat (limited to 'docs')
-rw-r--r-- | docs/curl.1 | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/docs/curl.1 b/docs/curl.1 index 02cc3fb63..aec3e48f5 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -927,6 +927,52 @@ in web browsers, so curl does the conversion by default to maintain consistency. However, a server may require a POST to remain a POST after such a redirection. This option is meaningful only when using \fI-L/--location\fP (Added in 7.19.1) +.IP "--proto <protocols>" +Tells curl to use the listed protocols for its initial retrieval. Protocols +are evaluated left to right, are comma separated, and are each a protocol +name or 'all', optionally prefixed by zero or more modifiers. Available +modifiers are: +.RS +.TP 3 +.B + +Permit this protocol in addition to protocols already permitted (this is +the default if no modifier is used). +.TP +.B - +Deny this protocol, removing it from the list of protocols already permitted. +.TP +.B = +Permit only this protocol (ignoring the list already permitted), though +subject to later modification by subsequent entries in the comma separated +list. +.RE +.IP +For example: +.RS +.TP 15 +.B --proto -ftps +uses the default protocols, but disables ftps +.TP +.B --proto -all,https,+http +only enables http and https +.TP +.B --proto =http,https +also only enables http and https +.RE +.IP +Unknown protocols produce a warning. This allows scripts to safely rely on +being able to disable potentially dangerous protocols, without relying upon +support for that protocol being built into curl to avoid an error. + +This option can be used multiple times, in which case the effect is the same +as concatenating the protocols into one instance of the option. + +(Added in 7.20.2) +.IP "--proto-redir <protocols>" +Tells curl to use the listed protocols after a redirect. See --proto for +how protocols are represented. + +(Added in 7.20.2) .IP "--proxy-anyauth" Tells curl to pick a suitable authentication method when communicating with the given proxy. This might cause an extra request/response round-trip. (Added |