Return to proxy.d CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / curl / docs / cmdline-opts

Annotation of embedaddon/curl/docs/cmdline-opts/proxy.d, revision 1.1.1.1

1.1       misho       1: Long: proxy
                      2: Short: x
                      3: Arg: [protocol://]host[:port]
                      4: Help: Use this proxy
                      5: ---
                      6: Use the specified proxy.
                      7: 
                      8: The proxy string can be specified with a protocol:// prefix. No protocol
                      9: specified or http:// will be treated as HTTP proxy. Use socks4://, socks4a://,
                     10: socks5:// or socks5h:// to request a specific SOCKS version to be used.
                     11: (The protocol support was added in curl 7.21.7)
                     12: 
                     13: HTTPS proxy support via https:// protocol prefix was added in 7.52.0 for
                     14: OpenSSL, GnuTLS and NSS.
                     15: 
                     16: Unrecognized and unsupported proxy protocols cause an error since 7.52.0.
                     17: Prior versions may ignore the protocol and use http:// instead.
                     18: 
                     19: If the port number is not specified in the proxy string, it is assumed to be
                     20: 1080.
                     21: 
                     22: This option overrides existing environment variables that set the proxy to
                     23: use. If there's an environment variable setting a proxy, you can set proxy to
                     24: \&"" to override it.
                     25: 
                     26: All operations that are performed over an HTTP proxy will transparently be
                     27: converted to HTTP. It means that certain protocol specific operations might
                     28: not be available. This is not the case if you can tunnel through the proxy, as
                     29: one with the --proxytunnel option.
                     30: 
                     31: User and password that might be provided in the proxy string are URL decoded
                     32: by curl. This allows you to pass in special characters such as @ by using %40
                     33: or pass in a colon with %3a.
                     34: 
                     35: The proxy host can be specified the exact same way as the proxy environment
                     36: variables, including the protocol prefix (http://) and the embedded user +
                     37: password.
                     38: 
                     39: If this option is used several times, the last one will be used.