Date: Sat, 18 May 2002 15:54:42 +0100 (BST) From: Dominic Marks <dominic_marks@btinternet.com> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/38245: Addition to PPP handbook chapter Message-ID: <20020518145442.E39FD2A0@host217-41-15-143.in-addr.btopenworld.com>
next in thread | raw e-mail | index | archive | help
>Number: 38245
>Category: docs
>Synopsis: Addition to PPP handbook chapter
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Sat May 18 08:00:02 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator: Dominic Marks
>Release: FreeBSD 4.6-RC i386
>Organization:
Student
>Environment:
System: FreeBSD gallium 4.6-RC FreeBSD 4.6-RC #4:
Thu May 16 22:38:19 BST 2002 dom@gallium:/usr/obj/usr/src/sys/GALLIUM i386
>Description:
Extend the PPPoA section I contributed previously with a guide to
using mpd as an alternative to pptpclient.
>How-To-Repeat:
NA.
>Fix:
Since jade and openjade coredump when trying to build the handbook (yes,
all my docproj stuff is fresh) I haven't been able to test this
throughly. Although I have had keramida@ review it (briefly).
However decides to commit this, please do a test build first. Thanks!
Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v
retrieving revision 1.75
diff -u -r1.75 chapter.sgml
--- chapter.sgml 2002/05/09 21:04:21 1.75
+++ chapter.sgml 2002/05/18 14:49:06
@@ -2127,6 +2127,93 @@
instructions provided with it.</para>
</sect2>
+ <sect2>
+ <title>Using mpd</title>
+
+ <para>You can use <application>mpd</application> to connect to a
+ variety of services, in particular pptp services. You can find
+ <application>mpd</application> in the ports collection,
+ <filename role="package">net/mpd</filename>.</para>
+
+ <para>First you must install the port, and then you can configure
+ <application>mpd</application> to suit your requirements and
+ provider settings. The port places a set of sample configuration
+ files which are well documented in
+ <filename><replaceable>PREFIX</replaceable>/etc/mpd/</filename>.
+ Note here that <emphasis>PREFIX</emphasis> means the directory
+ into which your ports are installed, this defaults to
+ <filename>/usr/local/</filename>. A complete guide to to
+ configuring <application>mpd</application> is available in HTML
+ format once the port has been installed. It is placed in
+ <filename><replaceable>PREFIX</replaceable>/share/mpd/</filename>.
+ Here is a sample configuration for connecting to an ADSL service
+ with <application>mpd</application>. The configuration is spread
+ over two files, first the <filename>mpd.conf</filename>.</para>
+
+ <programlisting>default:
+ load adsl
+
+adsl:
+ new -i ng0 adsl adsl
+ set bundle authname <replaceable>username</replaceable> <co
+ id="co-mpd-ex-user">
+ set bundle password <replaceable>password</replaceable> <co
+ id="co-mpd-ex-pass">
+ set bundle disable multilink
+
+ set link no pap actcomp protocomp
+ set link disable chap
+ set link accept chap
+ set link keep-alive 30 10
+
+ set ipcp no vjcomp
+ set ipcp ranges 0.0.0.0/0 0.0.0.0/0
+
+ set iface route default
+ set iface disable on-demand
+ set iface enable proxy-arp
+ set iface idle 0
+
+ open</programlisting>
+
+ <calloutlist>
+ <callout arearefs="co-mpd-ex-user">
+ <para>The username used to authenticate with your ISP.</para>
+ </callout>
+ <callout arearefs="co-mpd-ex-pass">
+ <para>The password used to authenticate with your ISP.</para>
+ </callout>
+ </calloutlist>
+
+ <para>The <filename>mpd.links</filename> file contains information
+ about the link, or links, you wish to establish. An example
+ <filename>mpd.links</filename> to accompany the above example is
+ given beneath.</para>
+
+ <programlisting>adsl:
+ set link type pptp
+ set pptp mode active
+ set pptp enable originate incoming outcall
+ set pptp self 10.0.0.140
+ set pptp peer 10.0.0.138</programlisting>
+
+ <para>It is possible to initialise the connection easily by issuing
+ the following command as <username>root</username>.</para>
+
+ <screen>&prompt.root; <userinput>mpd -b</userinput><replaceable>adsl</replaceable></screen>
+
+ <para>You can see the status of the connection with the following
+ command.</para>
+
+ <screen>&prompt.user; <userinput>ifconfig <replaceable>ng0</replaceable></userinput>
+ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500
+ inet 216.136.204.117 --> 204.152.186.171 netmask 0xffffffff</screen>
+
+ <para>Using <application>mpd</application> is the recommended way to
+ connect to an ADSL service with &os;.</para>
+
+ </sect2>
+
<sect2>
<title>Using pptpclient</title>
@@ -2147,16 +2234,16 @@
set log phase chat lcp ipcp ccp tun command
set timeout 0
enable dns
- set authname <replaceable>username</replaceable> <co id="co-ex-user">
- set authkey <replaceable>password</replaceable> <co id="co-ex-pass">
+ set authname <replaceable>username</replaceable> <co id="co-pptp-ex-user">
+ set authkey <replaceable>password</replaceable> <co id="co-pptp-ex-pass">
set ifaddr 0 0
add default HISADDR</programlisting>
<calloutlist>
- <callout arearefs="co-ex-user">
+ <callout arearefs="co-pptp-ex-user">
<para>The username of your account with the DSL provider.</para>
</callout>
- <callout arearefs="co-ex-pass">
+ <callout arearefs="co-pptp-ex-pass">
<para>The password for your account.</para>
</callout>
</calloutlist>
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020518145442.E39FD2A0>