corkscrew: Add man page from debian
authorFredrik Fornwall <fredrik@fornwall.net>
Fri, 15 Jan 2016 15:22:02 +0000 (10:22 -0500)
committerFredrik Fornwall <fredrik@fornwall.net>
Fri, 15 Jan 2016 15:22:02 +0000 (10:22 -0500)
packages/corkscrew/build.sh
packages/corkscrew/corkscrew.1 [new file with mode: 0644]

index 17e85a2..749c48d 100644 (file)
@@ -3,3 +3,9 @@ TERMUX_PKG_DESCRIPTION="A tool for tunneling SSH through HTTP proxies"
 TERMUX_PKG_DEPENDS="openssh"
 TERMUX_PKG_VERSION=2.0
 TERMUX_PKG_SRCURL=http://agroman.net/corkscrew/corkscrew-${TERMUX_PKG_VERSION}.tar.gz
+
+termux_step_post_make_install () {
+       # Corkscrew does not distribute a man page, use one from debian:
+       mkdir -p $TERMUX_PREFIX/share/man/man1
+       cp $TERMUX_PKG_BUILDER_DIR/corkscrew.1 $TERMUX_PREFIX/share/man/man1
+}
diff --git a/packages/corkscrew/corkscrew.1 b/packages/corkscrew/corkscrew.1
new file mode 100644 (file)
index 0000000..a0cd95b
--- /dev/null
@@ -0,0 +1,135 @@
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+.    de IX
+.    tm Index:\\$1\t\\n%\t"\\$2"
+..
+.    nr % 0
+.    rr F
+.\}
+.el \{\
+.    de IX
+..
+.\}
+.\" ========================================================================
+.\"
+.IX Title "corkscrew 1"
+.TH corkscrew 1 "2013-05-23" "corkscrew" "Networking"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+corkscrew \- Tunnel TCP connections through HTTP proxies
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+.Vb 1
+\&  corkscrew  PROXY PROXYPORT TARGETHOST TARGETPORT [AUTH_FILE]
+.Ve
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+corkscrew is a simple tool to tunnel \s-1TCP\s0 connections through an \s-1HTTP\s0
+proxy supporting the \s-1CONNECT\s0 method. It reads stdin and writes to std\-
+out during the connection, just like netcat. It can be used for
+instance to connect to an \s-1SSH\s0 server running on a remote 443 port
+through a strict \s-1HTTPS\s0 proxy.
+.IP "\s-1PROXY\s0" 4
+.IX Item "PROXY"
+The name of the host running the \s-1HTTP\s0 proxy.
+.IP "\s-1PROXYPORT\s0" 4
+.IX Item "PROXYPORT"
+The port on which to connect on the proxy.
+.IP "\s-1TARGET\s0" 4
+.IX Item "TARGET"
+The host to reach through the proxy.
+.IP "\s-1TARGETPORT\s0" 4
+.IX Item "TARGETPORT"
+The port to connect to on the target host.
+.IP "\s-1AUTH_\s0 \s-1FILE\s0" 4
+.IX Item "AUTH_ FILE"
+The  auth  file is made of one single line containing your username and
+password in the form
+.Sp
+.Vb 1
+\&    username:password
+.Ve
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+None.
+.SH "EXAMPLES"
+.IX Header "EXAMPLES"
+The common usage of corkscrew is to put the following line in
+~/.ssh/ssh_config:
+.PP
+.Vb 1
+\&        ProxyCommand corkscrew proxy proxyport %h %p [<path to auth_file>]
+.Ve
+.PP
+This will let the ssh connection go through the proxy with the help of
+corkscrew.
+.SH "ENVIRONMENT"
+.IX Header "ENVIRONMENT"
+None.
+.SH "FILES"
+.IX Header "FILES"
+None.
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+\&\fIssh_config\fR\|(5)
+.SH "AUTHORS"
+.IX Header "AUTHORS"
+Program was written by Pat Padgett <agroman@agroman.net>.
+.PP
+This manual page was written by Laurent Fousse <laurent@komite.net> for
+the Debian \s-1GNU\s0 system (but may be used by others). Updated by Jari
+Aalto <jari.aalto@cante.net>. Released under license \s-1GNU\s0 \s-1GPL\s0 version 2
+or (at your option) any later version. For more information about
+license, visit <http://www.gnu.org/copyleft/gpl.html>.