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



NAME
     ssh-socks5-proxy-connect - Secure Shell proxy for SOCKS5

SYNOPSIS
     /usr/lib/ssh/ssh-socks5-proxy-connect
          [-h socks5proxyhost]
          [-p socks5proxyport] connecthost connectport


DESCRIPTION
     A proxy command for ssh(1) that uses SOCKS5 (RFC 1928). Typ-
     ical use is where connections external to a network are only
     allowed via a socks gateway server.


     This proxy command  does  not  provide  any  of  the  SOCKS5
     authentication   mechanisms   defined   in  RFC  1928.  Only
     anonymous connections are possible.

OPTIONS
     The following options are supported:

     -h socks5proxyhost    Specifies  the  proxy   web   server
                             through  which to connect. Overrides
                             the SOCKS5SERVER environment  vari-
                             able.


     -p socks5proxyport    Specifies  the  port  on  which  the
                             proxy web server runs. If not speci-
                             fied, port 80 is assumed.  Overrides
                             the  SOCKS5PORT  environment  vari-
                             able.


OPERANDS
     The following operands are supported:

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


     socks5proxyport    The numeric port number to  connect  to
                          on socks5proxyhost.


     connecthost         The name of the remote  host  to  which
                          the socks gateway is to connect you.


     connectport         The numeric port number  of  the  socks
                          gateway    to   connect   you   to   on



SunOS 5.11          Last change: 30 Oct 2002                    1






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



                          connecthost.


EXAMPLES
     The recommended way to use a proxy connection command is  to
     configure  the  ProxyCommand in sshconfig(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-socks5-proxy-connect   in
     sshconfig(4) when the proxy is set from the environment:


       Host playtime.foo.com
           ProxyCommand /usr/lib/ssh/ssh-socks5-proxy-connect \
               playtime.foo.com 22



     Example 2 Overriding proxy environment variables


     The  following  example  uses  ssh-socks5-proxy-connect   in
     sshconfig(4)  to override (or if not set) proxy environment
     variables:


       Host playtime.foo.com
           ProxyCommand /usr/lib/ssh/ssh-socks5-proxy-connect -h socks-gw \
               -p 1080 playtime.foo.com 22



     Example 3 Using the command line


     The following example uses ssh-socks5-proxy-connect from the
     ssh(1) command line:


       example$ ssh -o'ProxyCommand=/usr/lib/ssh/ssh-socks5-proxy-connect \
           -h socks-gw -p 1080 playtime.foo.com 22' playtime.foo.com



ENVIRONMENT VARIABLES
     SOCKS5SERVER    Takes socks5proxyhost operand to  specify
                      the default proxy host.




SunOS 5.11          Last change: 30 Oct 2002                    2






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



     SOCKS5PORT      Takes socks5proxyport  operand to specify
                      the default proxy 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-http-proxy-connect(1),  sshconfig(4),   attri-
     butes(5)
























SunOS 5.11          Last change: 30 Oct 2002                    3