Manual Pages for UNIX Operating System command usage for man ssh-http-proxy-connect

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
                           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 environ-
                           ment 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



SunOS 5.11          Last change: 24 Oct 2001                    1






User Commands                           ssh-http-proxy-connect(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.




SunOS 5.11          Last change: 24 Oct 2001                    2






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



     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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | network/ssh                 |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     ssh(1), ssh-socks5-proxy-connect(1),  ssh_config(4),  attri-
     butes(5)
























SunOS 5.11          Last change: 24 Oct 2001                    3