ssh-http-proxy-connect(1)

1ssh-http-proxy-connect(1)        User Commands       ssh-http-proxy-connect(1)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

14       A proxy command for ssh(1) that uses HTTP CONNECT. Typical use is where
15       connections external to a network are only  allowed  via  a  proxy  web
16       server.
17

OPTIONS

19       The following options are supported:
20
21       -h http_proxy_host    Specifies  the  proxy web server through which to
22                             connect. Overrides the HTTPPROXY  and  http_proxy
23                             environment variables if they are set.
24
25
26       -p http_proxy_port    Specifies  the port on which the proxy web server
27                             runs. If not specified, port 80 is assumed. Over‐
28                             rides  the  HTTPPROXYPORT and http_proxy environ‐
29                             ment variables if they are set.
30
31

OPERANDS

33       The following operands are supported:
34
35       http_proxy_host    The host name or IP address (IPv4 or  IPv6)  of  the
36                          proxy.
37
38
39       http_proxy_port    The   numeric   port   number   to   connect  to  on
40                          http_proxy_host.
41
42
43       connect_host       The name of the remote host to which the  proxy  web
44                          server is to connect you.
45
46
47       connect_port       The  numeric  port number of the proxy web server to
48                          connect you to on http_proxy_host.
49
50

EXAMPLES

52       The recommended way to use a proxy connection command is  to  configure
53       the  ProxyCommand in ssh_config(4) (see Example 1 and Example 2). Exam‐
54       ple 3 shows how the proxy command can be specified on the command  line
55       when running ssh(1).
56
57       Example 1 Setting the proxy from the environment
58
59
60       The following example uses ssh-http-proxy-connect in ssh_config(4) when
61       the proxy is set from the environment:
62
63
64         Host playtime.foo.com
65             ProxyCommand /usr/lib/ssh/ssh-http-proxy-connect \
66                 playtime.foo.com 22
67
68
69
70       Example 2 Overriding proxy environment variables
71
72
73       The following example uses ssh-http-proxy-connect in  ssh_config(4)  to
74       override (or if not set) proxy environment variables:
75
76
77         Host playtime.foo.com
78             ProxyCommand /usr/lib/ssh/ssh-http-proxy-connect -h webcache \
79                 -p 8080 playtime.foo.com 22
80
81
82
83       Example 3 Using the command line
84
85
86       The  following example uses ssh-http-proxy-connect from the ssh(1) com‐
87       mand line:
88
89
90         example$ ssh -o'ProxyCommand="/usr/lib/ssh/ssh-http-proxy-connect \
91             -h webcache -p 8080 playtime.foo.com 22"' playtime.foo.com
92
93
94

ENVIRONMENT VARIABLES

96       HTTPPROXY        Takes  the  http_proxy_host  operand  to  specify  the
97                        default  proxy  host. Overrides http_proxy if both are
98                        set.
99
100
101       HTTPPROXYPORT    Takes  the  http_proxy_port  operand  to  specify  the
102                        default proxy port. Ignored if HTTPPROXY is not set.
103
104
105       http_proxy       URL format for specifying proxy host and port.
106
107

EXIT STATUS

109       The following exit values are returned:
110
111       0     Successful completion.
112
113
114       1     An error occurred.
115
116

ATTRIBUTES

118       See attributes(5) for descriptions of the following attributes:
119
120
121
122
123       ┌─────────────────────────────┬─────────────────────────────┐
124       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
125       ├─────────────────────────────┼─────────────────────────────┤
126       │Availability                 │SUNWsshu                     │
127       ├─────────────────────────────┼─────────────────────────────┤
128       │Interface Stability          │Stable                       │
129       └─────────────────────────────┴─────────────────────────────┘
130