PPTPCTRL(8)

NAME
pptpctrl - PPTP VPN control connection manager

SYNOPSIS
pptpctrl [0|1] [0|1 options] [0|1 speed] [0|1 local-ip] [0|1 remote-ip] [0|1 ipx-net]

DESCRIPTION
pptpctrl is a program usually run by the PoPToP PPTP daemon, pptpd(8), which can also be run from inetd(8) if some of the features of pptpd(8), such as IP pool management and inbuilt TCP wrappers, are not required.

OPTIONS

First option - debugging:
    0 to indicate no debugging or 1 to indicate debugging messages should be generated (and sent to syslog).

Second option - ppp options file:
    0 to indicate the default ppp options file (normally /etc/ppp/options) should be used or 1 options to indicate the file options should be used as the ppp options file.

Third option - tty speed:
    0 to indicate the default speed (normally 115200) or 1 speed to indicate that the speed passed to the ppp daemon should be speed.

Fourth option - local IP address:
    0 to indicate default (pppd-determined) local IP address (normally the first ethernet interface's address) should be used or 1 local-ip to indicate the local IP address should be set to local-ip.

Fifth option - remote IP address:
    0 to indicate that pppd should determine the remote IP address or 1 remote-ip to indicate the remote IP address should be set to remote-ip.

Sixth option - IPX network number:
    0 to indicate that either IPX is not used or IPX network numbers are managed by the PPP daemon or 1 ipx-net to specify a specific IPX network number.

EXAMPLES

pptpctrl stream tcp nowait root /usr/sbin/tcpd /usr/local/sbin/pptpctrl 0 0 0 0 0 0 --buffer-- in inetd.conf to run pptpctrl to service incoming pptp connections using the tcp wrapper /usr/sbin/tcpd. The options here are no debugging, default pppd options file, default speed and default IP addresses. The --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.

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 0 in inetd.conf will run pptpctrl to service incoming pptp connections using the tcp wrapper /usr/sbin/tcpd, as before, however with debugging enabled, an alternate config file of /etc/ppp/options.PPTP, the speed set to 115200 and the local IP address forced to be 192.168.0.1.

NOTE
The 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 /etc/services.

RETURN CODES

0 is returned on normal exit.

1 is returned on bad connection shutdown.

2 is returned on bad command line parameters.

3 is returned on miscellaneous errors.

FILES
/etc/inetd.conf

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.

COPYRIGHT
Copyright © 1999 Matthew Ramsay and others.

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.

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.

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.

AVAILABILITY
The most recent version of PoPToP is available for download from Moreton Bay at http://www.moretonbay.com/vpn/pptp.html.

SEE ALSO
inetd(8), inetd.conf(5), pppd(8), pptpd(8), tcpd(8).