Provided by: pptpd_1.3.4-2.1ubuntu1_i386 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

       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)