.\"
.\" Copyright (c) 2005 Marcus Glocker <marcus@nazgul.ch>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd Dec 22, 2005
.Dt GOTTHARD 8
.Os
.Sh NAME
.Nm gotthard
.Nd ssh through https proxy tunnel
.Sh SYNOPSIS
.Nm gotthard
.Op Fl hv
.Op Fl c Ar configfile
.Sh DESCRIPTION
.Nm
is a daemon which tunnels
.Xr ssh 1
sessions through an https proxy.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl h
Prints short listing of
.Nm
options.
.It Fl v
Shows version.
.It Fl c Ar configfile
Choose an alternate configuration file.
The default configuration file is
.Ar /etc/gotthard.conf .
.El
.Pp
In the configuration file you define on which address
.Nm
shall
.Ar listen
for client connections, the address the https
.Ar proxy
listens on, and which
.Ar external
address to connect to after passing through the https proxy.
The
.Ar external
host is the one running
.Xr sshd 8 .
After
.Nm
has been started you can establish
connections like in this example:
.Bd -literal -offset indent
ssh -p 2222 hacki@localhost
.Ed
.Pp
If the https proxy needs user authentication, you can do so by using the
.Ar auth
option in the configuration file.
This string must be in the format
<username>:<password>.
.Sh EXAMPLES
The following is an example configuration file:
.Pp
.Bd -literal -offset indent
auth user:password
listen 127.0.0.1:2222
proxy 10.0.0.1:3128
external 192.168.0.1:22
.Ed
.Sh FILES
.Bl -tag -width "xxxxxxxxxxxxxxxxxxxxxxxxxxxx" -compact
.It Pa /etc/gotthard.conf
default configuration file
.It Pa ~HOME/.gotthard/gotthard.log
log file
.It Pa ~HOME/.gotthard/gotthard.pid
pid file
.El
.Sh HISTORY
First version of
.Nm
was written in 2001.
.Sh AUTHORS
Daniel Hartmeier
.Aq daniel@benzedrine.cx
.Pp
Marcus Glocker
.Aq marcus@nazgul.ch