Annotation of embedaddon/curl/docs/cmdline-opts/proto.d, revision 1.1

1.1     ! misho       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.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>