ssh-http-proxy-connect(1)					   User Commands					 ssh-http-proxy-connect(1)

NAME

       ssh-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  vari-
			       ables 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 HTTP-
			       PROXYPORT 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).
       Example 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) command 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 ALSO

       ssh(1), ssh-socks5-proxy-connect(1), ssh_config(4), attributes(5)

SunOS 5.10							    24 Oct 2001 					 ssh-http-proxy-connect(1)