ssh-http-proxy-connect(1) User Commands ssh-http-proxy-connect(1)NAMEssh-http-proxy-connect - Secure Shell proxy for HTTP
SYNOPSIS
/usr/lib/ssh/ssh-http-proxy-connect [-h http_proxy_host] [-p
http_proxy_port] connect_host connect_port
DESCRIPTION
A proxy command for ssh(1) that uses HTTP CONNECT. Typical use is where
connections external to a network are only allowed via a proxy web
server.
OPTIONS
The following options are supported:
-h http_proxy_host Specifies the proxy web server through which to
connect. Overrides the HTTPPROXY and http_proxy
environment variables if they are set.
-p http_proxy_port Specifies the port on which the proxy web
server runs. If not specified, port 80 is
assumed. Overrides the HTTPPROXYPORT and
http_proxy environment variables if they are
set.
OPERANDS
The following operands are supported:
http_proxy_host The host name or IP address (IPv4 or IPv6) of
the proxy.
http_proxy_port The numeric port number to connect to on
http_proxy_host.
connect_host The name of the remote host to which the proxy
web server is to connect you.
connect_port The numeric port number of the proxy web server
to connect you to on http_proxy_host.
EXAMPLES
The recommended way to use a proxy connection command is to configure
the ProxyCommand in ssh_config(4) (see Example 1 and Example 2). Exam‐
ple 3 shows how the proxy command can be specified on the command line
when running ssh(1).
Example 1: Setting the proxy from the environment
The following example uses ssh-http-proxy-connect in ssh_config(4) when
the proxy is set from the environment:
Host playtime.foo.com
ProxyCommand /usr/lib/ssh/ssh-http-proxy-connect \
playtime.foo.com 22
Example 2: Overriding proxy environment variables
The following example uses ssh-http-proxy-connect in ssh_config(4) to
override (or if not set) proxy environment variables:
Host playtime.foo.com
ProxyCommand /usr/lib/ssh/ssh-http-proxy-connect -h webcache \
-p 8080 playtime.foo.com 22
Example 3: Using the command line
The following example uses ssh-http-proxy-connect from the ssh(1) com‐
mand line:
example$ ssh -o'ProxyCommand="/usr/lib/ssh/ssh-http-proxy-connect \
-h webcache -p 8080 playtime.foo.com 22"' playtime.foo.com
ENVIRONMENT VARIABLES
HTTPPROXY Takes the http_proxy_host operand to specify
the default proxy host. Overrides http_proxy if
both are set.
HTTPPROXYPORT Takes the http_proxy_port operand to specify
the default proxy port. Ignored if HTTPPROXY is
not set.
http_proxy URL format for specifying proxy host and port.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWsshu │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Stable │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOssh(1), ssh-socks5-proxy-connect(1), ssh_config(4), attributes(5)SunOS 5.10 24 Oct 2001 ssh-http-proxy-connect(1)
