MAN Solaris - ssh-http-proxy-connect (1)

advertisement


NAME

ssh-http-proxy-connect - Secure Shell proxy for HTTP

CONTENTS

Synopsis
Description
Options
Operands
Examples
Environment Variables
Exit Status
Attributes
See Also

SYNOPSIS

/usr/lib/ssh/ssh-http-proxy-connect [-h http_proxy_host]
    [-p http_proxy_port] connect_host connect_port

advertisements

advertisements


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). 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 TYPEATTRIBUTE VALUE
AvailabilitySUNWsshu

SEE ALSO

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

Jump to page    or go to Top of page |  Section 1 |  Main Solaris Index.


SunOS 5.11 ssh-http-proxy-connect (1) 24 Oct 2001
Generated by Open Solaris Forum from /usr/share/man/man1/ssh-http-proxy-connect.1 using man macros with tbl support.