proto.md (1447B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Long: proto 5 Arg: <protocols> 6 Help: Enable/disable PROTOCOLS 7 Added: 7.21.0 8 Category: connection curl 9 Multi: single 10 See-also: 11 - proto-redir 12 - proto-default 13 Example: 14 - --proto =http,https,sftp $URL 15 --- 16 17 # `--proto` 18 19 Limit what protocols to allow for transfers. Protocols are evaluated left to 20 right, are comma separated, and are each a protocol name or 'all', optionally 21 prefixed by zero or more modifiers. Available modifiers are: 22 23 ## + 24 Permit this protocol in addition to protocols already permitted (this is 25 the default if no modifier is used). 26 27 ## - 28 Deny this protocol, removing it from the list of protocols already permitted. 29 30 ## = 31 Permit only this protocol (ignoring the list already permitted), though 32 subject to later modification by subsequent entries in the comma separated 33 list. 34 35 ## 36 37 For example: --proto -ftps uses the default protocols, but disables ftps 38 39 --proto -all,https,+http only enables http and https 40 41 --proto =http,https also only enables http and https 42 43 Unknown and disabled protocols produce a warning. This allows scripts to 44 safely rely on being able to disable potentially dangerous protocols, without 45 relying upon support for that protocol being built into curl to avoid an error. 46 47 This option can be used multiple times, in which case the effect is the same 48 as concatenating the protocols into one instance of the option.