diff options
author | Daniel Stenberg <daniel@haxx.se> | 2016-11-16 14:20:36 +0100 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2016-11-16 15:15:57 +0100 |
commit | 342aa4797edfabba78755e798d23a5b6d288d50b (patch) | |
tree | c9607e88e05cef2f5084f6428151c5de52ee2fc4 /docs/cmdline-opts/proto.d | |
parent | c3c1e9618513d245861c35ec0c563ab71ce892bb (diff) |
cmdline-docs: more conversion
Diffstat (limited to 'docs/cmdline-opts/proto.d')
-rw-r--r-- | docs/cmdline-opts/proto.d | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/docs/cmdline-opts/proto.d b/docs/cmdline-opts/proto.d new file mode 100644 index 000000000..1513fdc05 --- /dev/null +++ b/docs/cmdline-opts/proto.d @@ -0,0 +1,43 @@ +Long: proto +Arg: <protocols> +Help: Enable/disable PROTOCOLS +See-also: proto-redir proto-default +Added: 7.20.2 +--- +Tells curl to limit what protocols it may use in the transfer. 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 + +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. |