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



NAME
     ssh-http-proxy-connect - Secure Shell proxy for HTP

SYNOPSIS
     /usr/lib/ssh/ssh-http-proxy-connect [-h httpproxyhost]
          [-p httpproxyport] connecthost connectport


DESCRIPTION
     A proxy command for ssh(1) that uses HTP  CONECT.  Typical
     use  is  where  connections  external  to a network are only
     allowed via a proxy web server.

OPTIONS
     The following options are supported:

     -h httpproxyhost    Specifies the proxy web server through
                           which   to   connect.   Overrides  the
                           HTPROXY and  httpproxy  environment
                           variables if they are set.


     -p httpproxyport    Specifies the port on which the  proxy
                           web  server  runs.  If  not specified,
                           port  80  is  assumed.  Overrides  the
                           HTPROXYPORT  and httpproxy environ-
                           ment variables if they are set.


OPERANDS
     The following operands are supported:

     httpproxyhost    The host name  or  IP  address  (IPv4  or
                        IPv6) of the proxy.


     httpproxyport    The numeric port number to connect to  on
                        httpproxyhost.


     connecthost       The name of the remote host to which  the
                        proxy web server is to connect you.


     connectport       The numeric port number of the proxy  web
                        server    to    connect    you    to   on
                        httpproxyhost.


EXAMPLES
     The recommended way to use a proxy connection command is  to
     configure  the  ProxyCommand in sshconfig(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
     sshconfig(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
     sshconfig(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
     HTPROXY        Takes  the   httpproxyhost   operand   to
                      specify  the  default proxy host. Overrides
                      httpproxy if both are set.


     HTPROXYPORT    Takes  the   httpproxyport   operand   to
                      specify  the default proxy port. Ignored if
                      HTPROXY is not set.




SunOS 5.11          Last change: 24 Oct 2001                    2






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



     httpproxy       URL format for specifying  proxy  host  and
                      port.


EXIT STATUS
     The following exit values are returned:

     0     Successful completion.


     1     An error occurred.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWsshu                    
    
     Interface Stability          Stable                      
    


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
























SunOS 5.11          Last change: 24 Oct 2001                    3