mirror of
https://github.com/curl/curl.git
synced 2024-12-09 06:30:06 +08:00
68784d73c3
The file format for each option now features a "Example:" header that can provide one or more examples that get rendered appropriately in the output. All options MUST have at least one example or gen.pl complains at build-time. This fix also does a few other minor format and consistency cleanups. Closes #7654
46 lines
1.3 KiB
D
46 lines
1.3 KiB
D
Long: proto
|
|
Arg: <protocols>
|
|
Help: Enable/disable PROTOCOLS
|
|
See-also: proto-redir proto-default
|
|
Added: 7.20.2
|
|
Category: connection curl
|
|
Example: --proto =http,https,sftp $URL
|
|
---
|
|
Tells curl to limit what protocols it may use for transfers. 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.
|