.\" $Id: pppclient.1,v 1.4 2003/09/12 19:23:43 thivillon Exp $
.TH pppclient 1 "September 06, 2003" "" "System Contributed Software Manual"
.SH NAME
.B pppclient
\-
Runs PPP over TLS tunnel
.SH SYNOPSIS
.B pppclient
.RB [ -h
.IR finalhost ]
.RB [ -p
.IR finalport ]
.RB [ -r
.IR proxyname ]
.RB [ -u
.IR proxyport ]
.RB [ -a
.IR user-proxy:pass-proxy ]
.RB [ -c
.IR 0|1 ]
.RB [ -d
.IR 0|1 ]
.RB [ -l
.IR logfile ]
.RB [
.IR configfile ]
.SH DESCRIPTION
.B pppclient
is the client part of
.BR ssltunnel ,
a tool to tunnel PPP sessions over SSL.
.PP
The main features are:
.IP o
no Unix shell is needed on the server
.IP o
NTLM proxy authentication supported
.IP o
both pppd and the *BSD userland ppp are supported
.IP o
simpler than IPsec to deploy
.PP
Moreover, while IPsec is filtered on numerous networks, 
.B pppclient
will allow you to connect to your server through an HTTPS proxy - even if it verifies that there is a SSL handshake, or an ISA server.
.SH OPTIONS
The following options are supported:
.TP 15
.BI -h " finalhost"
Connect to the server using
.I finalhost
IP address or hostname.
.TP
.BI -p " finalport"
Connect to the
.I finalport
TCP port (usually 443).
.TP
.BI -r " proxyname"
Use HTTP proxy
.I proxyname
hostname or address.
.TP
.BI -u " proxyport"
Connect to HTTP proxy using 
.I proxyport
TCP port.
.TP
.BI -a " user-proxy:pass-proxy"
Use
.IR user-proxy : pass-proxy
as credentials if HTTP proxy asks for an authentication. If using an NTLM authenticated proxy as MS ISA server, username should be such as DOMAIN\\user.
.TP
.BI -c " 0|1"
If set to 1, restart
.B pppd
if link goes down.
.TP
.BI -d " 0|1"
If set to 1, forks and detach from terminal after reading configuration. Logs are sent to
.IR syslogd (1)
if next option is not set.
.TP
.BI -l " logfile"
Logs to 
.I logfile
instead of
.IR syslogd (1)
when starting as a daemon.
.PP
These options override the corresponding options in the configuration file
.IR configfile .
.PP
If no configuration file is given,
.B pppclient
reads
.IR $HOME/.ssltunnelrc .
.SH FILES
.TP
.I $HOME/.ssltunnelrc
Default configuration file.
.SH BUGS
Please report them !
.SH SEE ALSO
.IR pppwho (8),
.IR pppserver (8), 
.IR gpppclient (1), 
.IR ssltunnelrc (5).
.SH AUTHORS
Alain Thivillon <ssltunnel@rominet.net>