Annotation of embedaddon/mpd/doc/mpd47.html, revision 1.1
1.1 ! misho 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.6 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 <- some link type -> PAC <- PPTP tunnel -> 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) <- PPTP tunnel -> 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.6 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>