| lh | 9ed821d | 2023-04-07 01:36:19 -0700 | [diff] [blame] | 1 | Long: proto |
| 2 | Arg: <protocols> |
| 3 | Help: Enable/disable PROTOCOLS |
| 4 | See-also: proto-redir proto-default |
| 5 | Added: 7.20.2 |
| 6 | --- |
| 7 | Tells curl to limit what protocols it may use in the transfer. Protocols are |
| 8 | evaluated left to right, are comma separated, and are each a protocol name or |
| 9 | 'all', optionally prefixed by zero or more modifiers. Available modifiers are: |
| 10 | .RS |
| 11 | .TP 3 |
| 12 | .B + |
| 13 | Permit this protocol in addition to protocols already permitted (this is |
| 14 | the default if no modifier is used). |
| 15 | .TP |
| 16 | .B - |
| 17 | Deny this protocol, removing it from the list of protocols already permitted. |
| 18 | .TP |
| 19 | .B = |
| 20 | Permit only this protocol (ignoring the list already permitted), though |
| 21 | subject to later modification by subsequent entries in the comma separated |
| 22 | list. |
| 23 | .RE |
| 24 | .IP |
| 25 | For example: |
| 26 | .RS |
| 27 | .TP 15 |
| 28 | .B --proto -ftps |
| 29 | uses the default protocols, but disables ftps |
| 30 | .TP |
| 31 | .B --proto -all,https,+http |
| 32 | only enables http and https |
| 33 | .TP |
| 34 | .B --proto =http,https |
| 35 | also only enables http and https |
| 36 | .RE |
| 37 | |
| 38 | Unknown protocols produce a warning. This allows scripts to safely rely on |
| 39 | being able to disable potentially dangerous protocols, without relying upon |
| 40 | support for that protocol being built into curl to avoid an error. |
| 41 | |
| 42 | This option can be used multiple times, in which case the effect is the same |
| 43 | as concatenating the protocols into one instance of the option. |