<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>