bionic (8) pptpctrl.8.gz

Provided by: pptpd_1.4.0-11build1_amd64 bug

NAME

       pptpctrl - PPTP control connection manager

SYNOPSIS

       pptpctrl pptp-debug-flag no-ipparam-flag ppp-options-value ppp-speed-value ppp-local-ip-value ppp-remote-
       ip-value [ pptp-call-id ] [ ppp-binary ] [ pptp-logwtmp ]

DESCRIPTION

       pptpctrl is usually run by pptpd(8), but 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

       pptpctrl  options  are  unconventional,  as they are designed for use by pptpd(8) rather than users.  The
       option order is critical.  Flag options consist of a 0 or 1, and must be present.  Value options  consist
       of  a  0,  or  a 1 followed by the value.  Either the 0 or both the 1 and the value must be present.  The
       remaining options are optional, but must be present in the defined order.  The options are as follows:

       pptp-debug-flag
              if set (1), enables debug messages to syslog from pptpctrl.  This has no effect on the setting  of
              the PPP debug option.

       no-ipparam-flag
              if  set,  pptpctrl will not pass the client's IP address to pppd(8) using the ipparam option.  See
              the noipparam option in pptpd.conf(5).

       ppp-options-value
              file to use for PPP options.  See the file option in pppd(8).

       ppp-speed-value
              value for the speed option given to pppd(8).  Note that on Linux, this parameter is ineffective.

       ppp-local-ip-value
              if set, specifies the IP address that pppd(8) is to use for the network interface on  the  server.
              If not set, pppd(8) will determine it based on options; usually it will be the ethernet address of
              the server.

       ppp-remote-ip-value
              if set, specifies the IP address that pppd(8) is to use for the network interface on  the  client.
              If not set, pppd(8) will determine it based on options; usually it will be the ethernet address of
              the client, or an address given in chap-secrets.  Must be set if ppp-local-ip-value is set.

       pptp-call-id
              if present, specifies the call  identification  for  the  PPTP  session.   If  omitted,  the  call
              identification is zero.  Normally the ID is allocated by pptpd(8) and passed to pptpctrl.

       ppp-binary
              if present, path to the PPP binary to use.  If omitted, the default value is used.

       pptp-logwtmp
              if present, specifies whether wtmp(5) should be updated as users connect and disconnect.

FILES

       none.

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. Development  has  been
       moved to SourceForge and worked on by Richard de Vroede <r.devroede@linvision.com> since June 26, 2002.

       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   SourceForge   at
       http://sourceforge.net/projects/poptop.

SEE ALSO

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

                                                  28 April 2004                                      PPTPCTRL(8)