File:  [ELWIX - Embedded LightWeight unIX -] / embedaddon / mpd / doc / mpd47.html
Revision 1.1.1.2 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Mon Jul 22 08:44:30 2013 UTC (10 years, 11 months ago) by misho
Branches: mpd, MAIN
CVS tags: v5_7p0, v5_7, HEAD
5.7

    1: <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
    2: <HTML>
    3: <HEAD>
    4: <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
    5: <TITLE>PPTP device type commands</TITLE>
    6: </HEAD>
    7: <BODY text="#000000" bgcolor="#ffffff">
    8: 
    9: <A HREF="mpd.html"><EM>Mpd 5.7 User Manual</EM></A>
   10:  <b>:</b> <A HREF="mpd42.html"><EM>Device Types</EM></A>
   11:  <b>:</b> <EM>PPTP device type commands</EM><BR>
   12: <b>Previous:</b> <A HREF="mpd46.html"><EM>UDP device type commands</EM></A><BR>
   13: <b>Next:</b> <A HREF="mpd48.html"><EM>L2TP device type commands</EM></A>
   14: 
   15: 
   16: <HR NOSHADE>
   17:   <H2><A NAME="47"></A>5.5. PPTP device type commands<A NAME="pptp"></A></H2>
   18: <p>This chapter describes commands that are specific to PPTP type links.
   19: These commands apply to the currently active link, and are only
   20: valid if the currently active link has type <b>pptp</b>.</p>
   21: <p>The PPTP protocol can be most easily understood as just another
   22: link layer type, where the link layer medium just happens to be
   23: an IP connection. So, for example, instead of configuring a
   24: telephone number to dial as you would with a modem, you configure
   25: an IP address to connect to. Everything else that's above the
   26: link layer functions exactly the same. Hence PPTP allows you
   27: to ``tunnel'' PPP frames over IP.</p>
   28: <p>Note that PPTP connections are initiated by a TCP connection from
   29: one machine to another, and that servers usually listen to TCP
   30: port 1723 (and this is the default for <code><em>port</em></code>
   31: in the commands below). PPTP also uses the GRE protocol, which
   32: has IP protocol number 47. Your firewall may need to be adjusted
   33: to allows this type of IP packet.</p>
   34: <p>Complete PPTP network topology looks like:
   35: <pre>
   36: client &lt;- some link type -&gt; PAC &lt;- PPTP tunnel -&gt; PNS
   37: </pre>
   38: </p>
   39: <p>PAC is physical level repeater, which receives PPP connection of some 
   40: type and forwards it to PNS using PPTP protocol. PNS is a PPP endpoint, 
   41: which receives PPP frames via PPTP tunnel and processes them.</p>
   42: <p>In simple case, when physical conversion is not required, topology 
   43: can be simplified to:
   44: <pre>
   45: client (PAC emulator) &lt;- PPTP tunnel -&gt; PNS
   46: </pre>
   47: </p>
   48: <p>Mpd is able to operate in both PAC and PNS modes. As PAC mpd supports 
   49: both simple case PAC emulator and complete PAC topologies. Complete 
   50: PAC can be configured by joining two physical devices using mpd's
   51: repeater functionality.</p>
   52: <p>
   53: <dl>
   54: 
   55: <dt><b><code>set pptp self <em>ipaddr</em> [ <em>port</em> ]</code></b><dd><p>Sets the local IP address and port for the PPTP connection.</p>
   56: 
   57: <dt><b><code>set pptp peer <em>ipaddr</em> [ <em>port</em> ]</code></b><dd><p>Sets the peer IP address and port for the PPTP connection.
   58: This command applies to both incoming and outgoing connections.
   59: For outgoing connections, this command is required in order to
   60: specify where to connect to. For incoming connections, this command
   61: is optional; if not given, mpd accepts incoming connections from any
   62: host. Otherwise, only connections from the stated IP address
   63: (and, optionally, port) are allowed.</p>
   64: 
   65: <dt><b><code>set pptp callingnum <em>number</em></code></b><dd>
   66: <dt><b><code>set pptp callednum <em>number</em></code></b><dd><p>Sets the calling and called telephone number to use when initiating a PPTP
   67: connection. For most VPN applications this is ignored, but in certain
   68: cases an actual phone number is required.
   69: The default is the empty string.</p>
   70: 
   71: <dt><b><code>set pptp enable <em>option ...</em> </code></b><dd>
   72: <dt><b><code>set pptp disable <em>option ...</em> </code></b><dd>
   73: <p>Enable and disable PPTP device type options for the link.</p>
   74: 
   75: </dl>
   76: </p>
   77: 
   78: <p>The following options are supported:</p>
   79: <p>
   80: <dl>
   81: 
   82: <dt><b><code>outcall</code></b><dd><p>In PPTP, each individual PPP connection between two IP hosts (there
   83: may be several, and these are not to be confused with the
   84: <em>single</em> TCP connection between any two IP hosts), is
   85: initiated as either an incoming or an outgoing call. 
   86: This allows to make an outgoing phone call (by PNS) via a remote access
   87: server (PAC), as well as in more common case forward an incoming
   88: phone call from an access server (PAC) to a remote PPTP server (PNS).</p>
   89: <p>When this option is enabled, mpd will initiate outgoing calls (PNS);
   90: otherwise mpd will initiate incoming calls (PAC). Although it seems that
   91: incoming would be more correct, the default is outgoing, as this
   92: is consistent with the behavior of the Microsoft PPTP dial-up adapter
   93: client.</p>
   94: <p>Mpd will accept either type of call on an incoming PPTP connection.</p>
   95: 
   96: <dt><b><code>delayed-ack</code></b><dd><p>Enable delayed ACK's. This can improve throughput on reliable links.</p>
   97: <p>The default is enable.</p>
   98: 
   99: <dt><b><code>always-ack</code></b><dd><p>Always include ACK even if already sent. This can improve throughput
  100: on unreliable links.</p>
  101: <p>The default is disable.</p>
  102: 
  103: <dt><b><code>windowing</code></b><dd><p>Enables the windowing mechanism specified by the protocol. Disabling 
  104: this will cause Mpd to violate the protocol, possibly confusing some 
  105: PPTP peers, but usually results in better performance. The windowing 
  106: mechanism is a design error in the PPTP protocol; L2TP, the successor 
  107: to PPTP, removes it.</p>
  108: <p>The default is disable.</p>
  109: 
  110: <dt><b><code>resolve-once</code></b><dd><p>Enables resolving peer address only once, on startup, or on manual
  111: typing in CLI.</p>
  112: <p>The default is enable.</p>
  113: 
  114: </dl>
  115: </p>
  116: <p>Note that if you are connecting to an NT server, your authentication
  117: name must include the NT domain name. For example:</p>
  118: <p>
  119: <blockquote><code>
  120: <pre>
  121:     set auth authname "DOMAIN\\username"
  122: </pre>
  123: </code></blockquote>
  124: </p>
  125: <p>For updating Windows 95 and 98 clients so they work properly, see
  126: <A href="http://support.microsoft.com/default.aspx?scid=KB;EN-US;Q191540">http://support.microsoft.com/default.aspx?scid=KB;EN-US;Q191540</A></p>
  127: 
  128: 
  129: 
  130:  <HR NOSHADE>
  131: <A HREF="mpd.html"><EM>Mpd 5.7 User Manual</EM></A>
  132:  <b>:</b> <A HREF="mpd42.html"><EM>Device Types</EM></A>
  133:  <b>:</b> <EM>PPTP device type commands</EM><BR>
  134: <b>Previous:</b> <A HREF="mpd46.html"><EM>UDP device type commands</EM></A><BR>
  135: <b>Next:</b> <A HREF="mpd48.html"><EM>L2TP device type commands</EM></A>
  136: 
  137: 
  138: 
  139: </BODY>
  140: </HTML>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>