Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PPTPD(8)		    System Manager's Manual		      PPTPD(8)

NAME
       pptpd - PPTP VPN	daemon

SYNOPSIS
       pptpd [ options ]

DESCRIPTION
       pptpd  is  the  Poptop PPTP daemon, which manages tunnelled PPP connec-
       tions encapsulated in GRE using the PPTP	VPN protocol.  It may  contain
       features	like IP	address	management and TCP wrappers if compiled	in.

OPTIONS
       Here  we	document the command line options.  See	pptpd.conf(5) for con-
       figuration directives, IP address  allocation,  routing,	 and  firewall
       rules.

       -b|--bcrelay internal-interface
	      specifies	that broadcasts	received on the	server's internal net-
	      work interface should be relayed to the clients.

       -c|--conf conf-file
	      specifies	 the  configuration  file  for pptpd (default /usr/lo-
	      cal/etc/pptpd.conf)

       -d|--debug
	      turns on debugging mode, causing more debugging messages	to  be
	      sent to syslog.

       -e|--ppp	pppd-program
	      use pppd-program in place	of the default pppd(8).

       -f|--fg
	      run in the foreground instead of detaching from terminal

       -h|--help
	      display program usage.

       -i|--noipparam
	      do  not  send the	client's IP address to ip-up scripts (required
	      if you are using the pppd(8) ipparam option for some other  pur-
	      pose).

       -l|--listen x.x.x.x
	      specifies	the local interface IP address to listen on.

       -o|--option ppp-conf-file
	      specifies	 that  pptpd should specify an alternate configuration
	      file for the ppp daemon (the default  is	normally  /etc/ppp/op-
	      tions but	may vary depending on your ppp daemon).

       -p|--pidfile pid-file
	      specifies	 an  alternate	location  to store the process ID file
	      (default /var/run/pptpd.pid).

       -s|--speed baud
	      specifies	that the speed baud should be passed to	the ppp	daemon
	      as the tty speed to use (in some cases this is  ignored  by  the
	      ppp daemon).

       -t|--stimeout seconds
	      specifies	the number of seconds to wait for the first packet be-
	      fore  dropping  the connection. This is a	denial of service pro-
	      tection feature.

       -w|--logwtmp
	      update wtmp(5) as	users connect and disconnect.  See wtmp(1).

       -C|--connections	n
	      limits the number	of client connections that  may	 be  accepted.
	      Corresponds  to  the connections option in pptpd.conf.  If pptpd
	      is allocating IP addresses (e.g.	--delegate is not  used)  then
	      the number of connections	is also	limited	by the remoteip	option
	      in pptpd.conf.

       -D|--delegate
	      delegates	 the  allocation  of  client  IP addresses to pppd(8).
	      Without this option, which is the	 default,  pptpd  manages  the
	      list  of	IP  addresses for clients and passes the next free ad-
	      dress to pppd.  With this	option,	pptpd does  not	 pass  an  ad-
	      dress, and so pppd may use radius	or chap-secrets	to allocate an
	      address.

       -V|--vrf	vrf-name
	      specifies	the VRF	to be used for listening in.

       -v|--version
	      displays the current version of the pptp daemon.

FILES
       /usr/local/etc/pptpd.conf
       /var/run/pptpd.pid

DEBUGGING
       To  turn	 on debugging, add 'debug' to /etc/pptpd.conf and your PPP op-
       tions file, and restart pptpd.

       Typically the PPP options file is options.pptpd in /etc/ppp, though  on
       some  distributions  it may be pptpd-options.  Use your package manager
       to find it, e.g.	'rpm -ql pptpd | grep options'	or  'dpkg  --listfiles
       pptpd | grep options'.

       You  may	 need to configure syslogd to catch debug messages.  e.g. edit
       /etc/syslog.conf	and add	something similar to the example  below,  then
       restart syslogd.

       # debug logging
       *.debug;mail.none				       /var/log/debug

       This  will  log	all  debug  information,  except  mail,	 to  the  file
       /var/log/debug.	Note that this is a lot	of information and might flood
       your disks.  If performance is an issue,	you can	try turning  off  sync
       during your debugging, by prefixing the destination with	'-'.

       # debug logging
       *.debug;mail.none				       -/var/log/debug

       Disable this line and restart syslog after you are done debugging.  See
       the syslog man pages for	more details.

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.de-
       vroede@linvision.com> since June	26, 2002.

COPYRIGHT
       Copyright (C) 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
       pppd(8),	pptpd(8), pptpd.conf(5).

			       29 December 2005			      PPTPD(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pptpd&sektion=8&manpath=FreeBSD+Ports+15.0.quarterly>

home | help