Date: Sat, 13 Apr 2002 00:47:44 +0100 (BST) From: Dominic Marks <dominic_marks@btinternet.com> To: FreeBSD-gnats-submit@FreeBSD.org Cc: keramida@FreeBSD.org Subject: ports/37030: Addition to PPPoA section of the Handbook Message-ID: <20020412234744.5953A95@host213-123-130-182.in-addr.btopenworld.com>
next in thread | raw e-mail | index | archive | help
>Number: 37030
>Category: ports
>Synopsis: Addition to PPPoA section of the Handbook
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-ports
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Fri Apr 12 16:50:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator: Dominic Marks
>Release: FreeBSD 4.5-STABLE i386
>Organization:
Student
>Environment:
System: FreeBSD gallium 4.5-STABLE FreeBSD 4.5-STABLE #2: Mon Apr 8
21:19:28 BST 2002 dom@gallium:/usr/obj/usr/src/sys/GALLIUM i386
>Description:
I've bulked out the PPPoA section and reworded the previous
information. The previous information makes it sound like the only
use of PPPoA is with the Alcatel SpeedTouch USB. My new version
includes the original information about the net/pppoa port but also
extends the section to cover using the net/pptpclient port to
connect to DSL services using PPPoA with other devices, in this case
an Alcatel SpeedTouch Home (Ethernet DSL router). An example
configuration is also given.
>How-To-Repeat:
NA.
>Fix:
Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v
retrieving revision 1.70
diff -u -3 -r1.70 chapter.sgml
--- chapter.sgml 2002/04/04 23:32:50 1.70
+++ chapter.sgml 2002/04/12 23:33:16
@@ -2104,24 +2104,79 @@
<see>PPP, over ATM</see>
</indexterm>
- <para>The following describes how to set up PPP over ATM, a.k.a,
- PPPoA. Currently, the only hardware supported is the Alcatel
- Speedtouch USB ADSL modem</para>
+ <para>The following describes how to set up PPP over ATM, (PPPoA).
+ PPPoA is a popular choice among European DSL providers.</para>
<sect2>
- <title>Installing PPPoA</title>
+ <title>Using PPPoA with the Alcatel Speedtouch USB</title>
- <para>PPPoA is supplied as a port in FreeBSD because the firmware
- is not distributable under <ulink
- url="http://www.alcatel.com/consumer/dsl/disclaimer_lx.htm">;
- Alcatel's license agreement</ulink>.</para>
-
- <para>To install the port, simply use the <link linkend="ports">
- ports collection</link> to install the <filename role="package">net/pppoa</filename>
- port and follow
- the instructions provided there.</para>
+ <para>PPPoA support for this device is supplied as a port in
+ FreeBSD because the firmware is not distributable under <ulink
+ url="http://www.alcatel.com/consumer/dsl/disclaimer_lx.htm">;
+ Alcatel's license agreement</ulink>.</para>
+ <para>To install the software, simply use the <link linkend="ports">
+ ports collection</link>. Install the
+ <filename role="package">net/pppoa</filename> port and follow the
+ instructions provided with it.</para>
</sect2>
+ <sect2>
+ <title>Using pptpclient</title>
+
+ <para>It is also possible to use FreeBSD to connect to other PPPoA
+ sevices using <filename role="package">net/pptpclient</filename>.</para>
+
+ <para>To use <filename role="package">net/pptpclient</filename> to
+ connect to a DSL service, install the port or package and edit your
+ <filename>/etc/ppp/ppp.conf</filename>. You will need to be
+ <username>root</username> to perform both of these operations. An
+ example section of <filename>ppp.conf</filename> is given below.</para>
+
+ <programlisting>adsl:
+ set log phase chat lcp ipcp ccp tun command
+ set timeout 0
+ enable dns
+ set authname <replaceable>username</replaceable>
+ set authkey <replaceable>password</replaceable>
+ set ifaddr 0 0
+ add default HISADDR</programlisting>
+
+ <para>This will open a tunnel for a PPP session to your DSL
+ router. Ethernet DSL modems have a preconfigured LAN IP address
+ which you connect to. In the case of the Alcatel Speedtouch Home
+ this address is <hostid role="ipaddr">10.0.0.138</hostid>. Your
+ routers documentation should tell you which address your device
+ uses. To open the tunnel and start a
+ <application>ppp</application> session execute the following
+ command.</para>
+
+ <screen>&prompt.root; pptp <replaceable>address</replaceable> <replaceable>isp</replaceable></screen>
+
+ <tip><para>You may wish to add a & to the end of the previous
+ command because <application>pptp</application> will not return
+ your prompt to you otherwise.</para></tip>
+
+ <para>A <devicename>tun</devicename> virtual tunnel device will be
+ created for interaction between the <application>pptp</application>
+ and <application>ppp</application> processes. Once you have been
+ returned to your prompt, or the <application>pptp</application>
+ process has confirmed a connection can you examine the tunnel like
+ so.</para>
+
+ <screen>&prompt.user; ifconfig <replaceable>tun0</replaceable>
+tun0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 1500
+ inet 216.136.204.21 --> 204.152.186.171 netmask 0xffffff00
+ Opened by PID 918
+ </screen>
+
+ <para>If you are unable to connect check that the configurations
+ on your router, which are usually accessible via
+ <application>telnet</application> or with a web browser. If you
+ still cannot connect you should examine the output of the
+ <application>pptp</application> command and the contents of the
+ <application>ppp</application> log file,
+ <filename>/var/log/ppp.log</filename> for clues.</para>
+ </sect2>
</sect1>
<sect1 id="slip">
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-ports" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020412234744.5953A95>