Extend the PPPoA section with a guide to using mpd as an alternative to

pptpclient.

PR:		38245
Submitted by:	Dominic Marks <dominic_marks@btinternet.com>
This commit is contained in:
Jeroen Ruigrok van der Werven 2002-05-19 11:14:02 +00:00
parent 6132b09664
commit e3a61d7883
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=13138

View file

@ -2127,6 +2127,93 @@ ppp_profile="name_of_service_provider"</programlisting>
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
l:
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>
: flags=88d1&lt;UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST&gt; 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 @@ ppp_profile="name_of_service_provider"</programlisting>
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>