pptpd.8 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194
  1. .TH PPTPD 8 "29 December 2005"
  2. .SH NAME
  3. pptpd - PPTP VPN daemon
  4. .SH SYNOPSIS
  5. .PP
  6. .B pptpd
  7. [
  8. .IR options
  9. ]
  10. .SH DESCRIPTION
  11. .B pptpd
  12. is the Poptop PPTP daemon, which manages tunnelled PPP connections
  13. encapsulated in GRE using the PPTP VPN protocol. It may contain
  14. features like IP address management and TCP wrappers if compiled in.
  15. .SH OPTIONS
  16. Here we document the command line options. See
  17. .BR pptpd.conf (5)
  18. for configuration directives, IP address allocation, routing, and
  19. firewall rules.
  20. .TP
  21. \fB-b\fR|\fB--bcrelay \fIinternal-interface
  22. specifies that broadcasts received on the server's internal
  23. network interface should be relayed to the clients.
  24. .TP
  25. \fB-c\fR|\fB--conf \fIconf-file
  26. specifies the configuration file for
  27. .B pptpd
  28. (default
  29. .IR /etc/pptpd.conf )
  30. .TP
  31. .BR -d | --debug
  32. turns on debugging mode, causing more debugging messages to be sent
  33. to syslog.
  34. .TP
  35. \fB-e\fR|\fB--ppp \fIpppd-program
  36. use
  37. .I pppd-program
  38. in place of the default
  39. .BR pppd (8).
  40. .TP
  41. .BR -f | --fg
  42. run in the foreground instead of detaching from terminal
  43. .TP
  44. .BR -h | --help
  45. display program usage.
  46. .TP
  47. .BR -i | --noipparam
  48. do not send the client's IP address to ip-up scripts (required if you are using the
  49. .BR pppd (8)
  50. .I ipparam
  51. option for some other purpose).
  52. .TP
  53. \fB-l\fR|\fB--listen \fIx.x.x.x
  54. specifies the local interface IP address to listen on.
  55. .TP
  56. \fB-o\fR|\fB--option \fIppp-conf-file
  57. specifies that pptpd should specify an alternate configuration file
  58. for the ppp daemon (the default is normally
  59. .I /etc/ppp/options
  60. but may vary depending on your ppp daemon).
  61. .TP
  62. \fB-p\fR|\fB--pidfile \fIpid-file
  63. specifies an alternate location to store the process ID file (default
  64. .IR /var/run/pptpd.pid ).
  65. .TP
  66. \fB-s\fR|\fB--speed \fIbaud
  67. specifies that the speed
  68. .I baud
  69. should be passed to the ppp daemon as the tty speed to use (in some
  70. cases this is ignored by the ppp daemon).
  71. .TP
  72. \fB-t\fR|\fB--stimeout \fIseconds
  73. specifies the number of seconds to wait for the first packet before
  74. dropping the connection. This is a denial of service protection
  75. feature.
  76. .TP
  77. .BR -w | --logwtmp
  78. update
  79. .BR wtmp (5)
  80. as users connect and disconnect. See
  81. .BR wtmp (1).
  82. .TP
  83. \fB-C\fR|\fB--connections \fIn
  84. limits the number of client connections that may be accepted. Corresponds to the
  85. .BR connections
  86. option in
  87. .IR pptpd.conf .
  88. If pptpd is allocating IP addresses (e.g.
  89. .BR --delegate
  90. is not used) then the number of connections is also limited by the
  91. .BR remoteip
  92. option in
  93. .IR pptpd.conf .
  94. .TP
  95. .BR -D | --delegate
  96. delegates the allocation of client IP addresses to
  97. .BR pppd (8).
  98. Without this option, which is the default, pptpd manages the list of
  99. IP addresses for clients and passes the next free address to pppd.
  100. With this option, pptpd does not pass an address, and so pppd may use
  101. radius or chap-secrets to allocate an address.
  102. .TP
  103. .BR -v | --version
  104. displays the current version of the pptp daemon.
  105. .SH FILES
  106. /etc/pptpd.conf
  107. .br
  108. /var/run/pptpd.pid
  109. .SH DEBUGGING
  110. To turn on debugging, add 'debug' to /etc/pptpd.conf and your
  111. PPP options file, and restart pptpd.
  112. .br
  113. .LP
  114. Typically the PPP options file is options.pptpd in /etc/ppp, though on
  115. some distributions it may be pptpd-options. Use your package manager
  116. to find it, e.g. 'rpm -ql pptpd | grep options' or 'dpkg --listfiles
  117. pptpd | grep options'.
  118. .br
  119. .LP
  120. You may need to configure syslogd to catch debug messages. e.g. edit
  121. /etc/syslog.conf and add something similar to the example below, then
  122. restart syslogd.
  123. .br
  124. .LP
  125. # debug logging
  126. .br
  127. *.debug;mail.none /var/log/debug
  128. .br
  129. .LP
  130. This will log all debug information, except mail, to the file
  131. /var/log/debug. Note that this is a lot of information and might
  132. flood your disks. If performance is an issue, you can try turning off
  133. sync during your debugging, by prefixing the destination with '-'.
  134. .br
  135. .LP
  136. # debug logging
  137. .br
  138. *.debug;mail.none -/var/log/debug
  139. .br
  140. .LP
  141. Disable this line and restart syslog after you are done debugging.
  142. See the syslog man pages for more details.
  143. .br
  144. .LP
  145. .SH AUTHORS
  146. Poptop is written by Matthew Ramsay <matthewr@moreton.com.au>, David Luyer
  147. <luyer@ucs.uwa.edu.au>, Kevin Thayer <tmk@netmagic.net>, Peter Galbavy
  148. <Peter.Galbavy@knowledge.com> and others. Development has been moved to
  149. SourceForge and worked on by Richard de Vroede <r.devroede@linvision.com>
  150. since June 26, 2002.
  151. .SH COPYRIGHT
  152. Copyright \(co 1999 Matthew Ramsay and others.
  153. .LP
  154. Poptop is free software; you can redistribute it and/or modify it under
  155. the terms of the GNU General Public License as published by the Free
  156. Software Foundation; either version 2, or (at your option) any later
  157. version.
  158. .LP
  159. Poptop is distributed in the hope that it will be useful, but WITHOUT ANY
  160. WARRANTY; without even the implied warranty of MERCHANTABILITY or
  161. FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
  162. for more details.
  163. .LP
  164. You should have received a copy of the GNU General Public License along
  165. with Poptop; see the file COPYING. If not, write to the Free Software
  166. Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  167. .SH AVAILABILITY
  168. The most recent version of Poptop is available for download from
  169. SourceForge at
  170. .IR http://sourceforge.net/projects/poptop .
  171. .SH "SEE ALSO"
  172. .BR pppd (8),
  173. .BR pptpd (8),
  174. .BR pptpd.conf (5).