1 |
diff -Nur corkscrew-2.0.orig/corkscrew.1 corkscrew-2.0/corkscrew.1 |
2 |
--- corkscrew-2.0.orig/corkscrew.1 1970-01-01 01:00:00.000000000 +0100 |
3 |
+++ corkscrew-2.0/corkscrew.1 2006-04-04 16:20:56.000000000 +0200 |
4 |
@@ -0,0 +1,99 @@ |
5 |
+.\" Hey, EMACS: -*- nroff -*- |
6 |
+.\" First parameter, NAME, should be all caps |
7 |
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection |
8 |
+.\" other parameters are allowed: see man(7), man(1) |
9 |
+.TH CORKSCREW 1 "November 22, 2003" |
10 |
+.\" Please adjust this date whenever revising the manpage. |
11 |
+.\" |
12 |
+.\" Some roff macros, for reference: |
13 |
+.\" .nh disable hyphenation |
14 |
+.\" .hy enable hyphenation |
15 |
+.\" .ad l left justify |
16 |
+.\" .ad b justify to both left and right margins |
17 |
+.\" .nf disable filling |
18 |
+.\" .fi enable filling |
19 |
+.\" .br insert line break |
20 |
+.\" .sp <n> insert n+1 empty lines |
21 |
+.\" for manpage-specific macros, see man(7) |
22 |
+.SH NAME |
23 |
+corkscrew \- Tunnel TCP connections through HTTP proxies |
24 |
+.SH SYNOPSIS |
25 |
+.B corkscrew |
26 |
+.BR |
27 |
+proxy |
28 |
+.BR |
29 |
+proxyport |
30 |
+.BR |
31 |
+targethost |
32 |
+.BR |
33 |
+targetport |
34 |
+.BR |
35 |
+[ authfile ] |
36 |
+.br |
37 |
+.SH DESCRIPTION |
38 |
+This manual page documents briefly the |
39 |
+.BR corkscrew |
40 |
+command. |
41 |
+This manual page was written for the Debian distribution |
42 |
+because the original program does not have a manual page. |
43 |
+ |
44 |
+corkscrew is a simple tool to tunnel TCP connections through an HTTP |
45 |
+proxy supporting the CONNECT method. It reads stdin and writes to |
46 |
+stdout during the connection, just like netcat. |
47 |
+It can be used for instance to connect to an SSH server running on |
48 |
+a remote 443 port through a strict HTTPS proxy. |
49 |
+ |
50 |
+ |
51 |
+.SH PARAMETERS |
52 |
+ |
53 |
+.TP |
54 |
+.B proxy |
55 |
+This is the name of the host running the HTTP proxy. |
56 |
+.TP |
57 |
+.B proxyport |
58 |
+This is the port on which to connect on the proxy. |
59 |
+.TP |
60 |
+.B target |
61 |
+This is the host to reach through the proxy. |
62 |
+.TP |
63 |
+.B targetport |
64 |
+This is the port to connect to on the target host. |
65 |
+ |
66 |
+.SH COMMON USAGE |
67 |
+ |
68 |
+The common usage of corkscrew is to put the following line in your |
69 |
+ssh_config: |
70 |
+ |
71 |
+ProxyCommand corkscrew proxy proxyport %h %p |
72 |
+ |
73 |
+This will let your ssh connection go through the proxy with the help |
74 |
+of corkscrew. |
75 |
+ |
76 |
+.SH AUTH FILE |
77 |
+ |
78 |
+The auth file is made of one single line containing your username and |
79 |
+password in the form: |
80 |
+ |
81 |
+username:password |
82 |
+ |
83 |
+You should add the path to your auth file in the proxy command |
84 |
+described above: |
85 |
+ |
86 |
+ProxyCommand corkscrew proxy proxyport %h %p auth-file |
87 |
+ |
88 |
+.SH "SEE ALSO" |
89 |
+.IX Header "SEE ALSO" |
90 |
+\&\fIssh_config\fR\|(5) |
91 |
+ |
92 |
+.PP |
93 |
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and |
94 |
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics, |
95 |
+.\" respectively. |
96 |
+.SH AUTHOR |
97 |
+corkscrew was written by Pat Padgett <agroman@agroman.net>. |
98 |
+ |
99 |
+Glenn Rolland <glenux@mandriva.com> is the Mandriva maintainer for this |
100 |
+package. |
101 |
+ |
102 |
+This manual page was written by Laurent Fousse <laurent@komite.net>, for the |
103 |
+Debian GNU/Linux system (but may be used by others). |