unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

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


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).    ATTRIBUTE  TYPEATTRIBUTE  VALUE  AvailabilitySUNWsshu
       Interface StabilityStable


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)