.TH PPTPCTRL 8 "13 August 1999"
.SH NAME
pptpctrl - PPTP VPN control connection manager
.SH SYNOPSIS
.B pptpctrl
.RB [ 0 | 1 ]
.RB [ 0 | 1
.IR options ]
.RB [ 0 | 1
.IR speed ]
.RB [ 0 | 1
.IR local-ip ]
.RB [ 0 | 1
.IR remote-ip ]
.SH DESCRIPTION
.B pptpctrl
is a program usually run by the PoPToP PPTP daemon,
.BR pptpd (8),
which can also be run from
.BR inetd (8)
if some of the features of
.BR pptpd (8),
such as IP pool management and inbuilt TCP wrappers, are not required.
.SH OPTIONS
.TP
First option - debugging:
.B 0
to indicate no debugging or
.B 1
to indicate debugging messages should be generated (and sent to
syslog).
.TP
Second option - ppp options file:
.B 0
to indicate the default ppp options file (normally
.IR /etc/ppp/options )
should be used or
.BI "1 " options
to indicate the file
.I options
should be used as the ppp options file.
.TP
Third option - tty speed:
.B 0
to indicate the default speed (normally
.IR 115200 )
or
.BI "1 " speed
to indicate that the speed passed to the ppp daemon should be
.IR speed .
.TP
Fourth option - local IP address:
.B 0
to indicate default (pppd-determined) local IP address (normally
the first ethernet interface's address) should be used or
.BI "1 " local-ip
to indicate the local IP address should be set to
.IR local-ip .
.TP
Fifth option - remote IP address:
.B 0
to indicate that pppd should determine the remote IP address or
.BI "1 " remote-ip
to indicate the remote IP address should be set to
.IR remote-ip .
.SH EXAMPLES
.PP
.B pptpctrl stream tcp nowait root /usr/sbin/tcpd /usr/local/sbin/pptpctrl 0 0 0 0 0 --buffer--
in
.I inetd.conf
to run
.B pptpctrl
to service incoming pptp connections using the tcp wrapper
.IR /usr/sbin/tcpd .
The options here are no debugging, default pppd options file,
default speed and default IP addresses.  The
.I --buffer--
string is ignored and is there to extend the process name
so that the process can change its name to include the client
IP address.
.PP
.B pptpctrl stream tcp nowait root /usr/sbin/tcpd /usr/local/sbin/pptpctrl 1 1 /etc/ppp/options.PPTP 1 115200 1 192.168.0.1 0
in
.I inetd.conf
will run
.B pptpctrl
to service incoming pptp connections using the tcp wrapper
.IR /usr/sbin/tcpd ,
as before, however with debugging enabled, an alternate
config file of
.IR /etc/ppp/options.PPTP ,
the speed set to
.I 115200
and the local IP address forced to be
.IR 192.168.0.1 .
.SH NOTE
The
.B pptpctrl
service must be registered as port 1723/tcp for the above examples
to work.  On most systems services can be registered by adding them
to
.IR /etc/services .
.SH FILES
/etc/inetd.conf
.SH AUTHORS
PoPToP is written by Matthew Ramsay <matthewr@moreton.com.au>, David Luyer
<luyer@ucs.uwa.edu.au>, Kevin Thayer <tmk@netmagic.net>, Peter Galbavy
<Peter.Galbavy@knowledge.com> and others.
.SH COPYRIGHT
Copyright \(co 1999 Matthew Ramsay and others.
.LP
PoPToP is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.
.LP
PoPToP is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.
.LP
You should have received a copy of the GNU General Public License along
with PoPToP; see the file COPYING.  If not, write to the Free Software
Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
.SH AVAILABILITY
The most recent version of PoPToP is available for download from
Moreton Bay at
.IR http://www.moretonbay.com/vpn/pptp.html .
.SH "SEE ALSO"
.BR inetd (8),
.BR inetd.conf (5),
.BR pppd (8),
.BR pptpd (8),
.BR tcpd (8).