os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add a section on using PPPoE.

Browse source 
Requested by:	jkh
Obtained from:	http://www-dev.node.to/freebsd/how-tos/how-to-freebsd-pppoe.html
This commit is contained in:
Jim Mock 2000-01-11 03:50:32 +00:00
parent 340bf3f8cd
commit d98063bb24
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=6361
2 changed files with 356 additions and 26 deletions
en_US.ISO8859-1/books/handbook/ppp-and-slip
chapter.sgml
en_US.ISO_8859-1/books/handbook/ppp-and-slip
chapter.sgml

191
en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ppp-and-slip/chapter.sgml,v 1.16 1999/09/06 06:53:03 peter Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ppp-and-slip/chapter.sgml,v 1.17 1999/11/07 01:54:53 chris Exp $
-->
<chapter id="ppp-and-slip">
@ -1650,6 +1650,183 @@ exit 1
</sect2>
</sect1>
<sect1 id="pppoe">
<title>Setting up PPP over Ethernet (PPPoE)</title>
<para><emphasis>Contributed by &a.jim; (from <ulink
url="http://www-dev.node.to/freebsd/how-tos/how-to-freebsd-pppoe.html">node.to</ulink>) 10 Jan 2000.</emphasis></para>
<para>The following describes how to set up PPP over Ethernet, a.k.a,
PPPoE.</para>
<sect2>
<title>Prerequisites</title>
<para>There are a few requirements that your system will need to meet
in order for PPPoE to function properly. They are:</para>
<itemizedlist>
<listitem>
<para>Kernel source for FreeBSD &rel.current;-STABLE</para>
</listitem>
<listitem>
<para><application>ppp</application> and
<application>pppd</application> from FreeBSD
&rel.current;-STABLE</para>
</listitem>
<listitem>
<para>Any dependencies for the above</para>
</listitem>
</itemizedlist>
</sect2>
<sect2>
<title>Kernel Configuration</title>
<para>You will need to set the following options in your kernel
configuration and then <link linkend="kernelconfig">compile a new
kernel</link>.</para>
<itemizedlist>
<listitem>
<para>options NETGRAPH</para>
</listitem>
<listitem>
<para>options NETGRAPH_ASYNC</para>
</listitem>
<listitem>
<para>options NETGRAPH_BPF</para>
</listitem>
<listitem>
<para>options NETGRAPH_CISCO</para>
</listitem>
<listitem>
<para>options NETGRAPH_ECHO</para>
</listitem>
<listitem>
<para>options NETGRAPH_FRAME_RELAY</para>
</listitem>
<listitem>
<para>options NETGRAPH_HOLE</para>
</listitem>
<listitem>
<para>options NETGRAPH_IFACE</para>
</listitem>
<listitem>
<para>options NETGRAPH_KSOCKET</para>
</listitem>
<listitem>
<para>options NETGRAPH_LMI</para>
</listitem>
<listitem>
<para>options NETGRAPH_PPP</para>
</listitem>
<listitem>
<para>options NETGRAPH_PPPOE</para>
</listitem>
<listitem>
<para>options NETGRAPH_PPTPGRE</para>
</listitem>
<listitem>
<para>options "NETGRAPH_RFC1490"</para>
</listitem>
<listitem>
<para>options NETGRAPH_SOCKET</para>
</listitem>
<listitem>
<para>options NETGRAPH_TEE</para>
</listitem>
<listitem>
<para>options NETGRAPH_TTY</para>
</listitem>
<listitem>
<para>options NETGRAPH_UI</para>
</listitem>
<listitem>
<para>options NETGRAPH_VJC</para>
</listitem>
</itemizedlist>
<para>Add the above to your kernel configuration, recompile,
install, and then reboot your system.</para>
</sect2>
<sect2>
<title>Setting up <filename>ppp.conf</filename></title>
<para>Here is an example of a working
<filename>ppp.conf</filename>:</para>
<programlisting>
default: # or name_of_service_provider
set device PPPoE:xl1 # replace xl1 with your ethernet device
set MRU 1490
set MTU 1490
set authname YOURLOGINNAME
set authkey YOURPASSWORD
set log Phase tun command # you can add more detailed logging if you wish
set dial
set login "TIMEOUT 1.5 name:-\\r-login:\\U word:\\P ocol:PPP HELLO" # this isn't necessary
set ifaddr 10.0.0.1/0 10.0.0.2/0
add default HISADDR
nat enable yes # if you want to enable nat for your local net
set cd off
set crtscts off
papchap:
set authname YOURLOGINNAME
set authkey YOURPASSWORD</programlisting>
</sect2>
<sect2>
<title>Running <application>PPP</application></title>
<para>As root, you can run either:</para>
<screen>&prompt.root; <userinput>ppp -dedicated</userinput></screen>
<para>or</para>
<screen>&prompt.root; <userinput>ppp -dedicated name_of_service_provider</userinput></screen>
<para>depending on how you have set up
<filename>ppp.conf</filename>.</para>
</sect2>
<sect2>
<title>Starting <application>PPP</application> at Boot</title>
<para>Add the following to your <filename>/etc/rc.conf</filename>
file:</para>
<programlisting>
ppp_enable="YES"
ppp_mode="dedicated"
ppp_nat="YES"
ppp_profile="default" # or your provider</programlisting>
</sect2>
</sect1>
<sect1 id="slipc">
<title>Setting up a SLIP Client</title>
@ -2474,15 +2651,3 @@ import proto rip interface ed {
</sect2>
</sect1>
</chapter>
<!--
Local Variables:
mode: sgml
sgml-declaration: "../chapter.decl"
sgml-indent-data: t
sgml-omittag: nil
sgml-always-quote-attributes: t
sgml-parent-document: ("../book.sgml" "part" "chapter")
End:
-->

191
en_US.ISO_8859-1/books/handbook/ppp-and-slip/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ppp-and-slip/chapter.sgml,v 1.16 1999/09/06 06:53:03 peter Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/ppp-and-slip/chapter.sgml,v 1.17 1999/11/07 01:54:53 chris Exp $
-->
<chapter id="ppp-and-slip">
@ -1650,6 +1650,183 @@ exit 1
</sect2>
</sect1>
<sect1 id="pppoe">
<title>Setting up PPP over Ethernet (PPPoE)</title>
<para><emphasis>Contributed by &a.jim; (from <ulink
url="http://www-dev.node.to/freebsd/how-tos/how-to-freebsd-pppoe.html">node.to</ulink>) 10 Jan 2000.</emphasis></para>
<para>The following describes how to set up PPP over Ethernet, a.k.a,
PPPoE.</para>
<sect2>
<title>Prerequisites</title>
<para>There are a few requirements that your system will need to meet
in order for PPPoE to function properly. They are:</para>
<itemizedlist>
<listitem>
<para>Kernel source for FreeBSD &rel.current;-STABLE</para>
</listitem>
<listitem>
<para><application>ppp</application> and
<application>pppd</application> from FreeBSD
&rel.current;-STABLE</para>
</listitem>
<listitem>
<para>Any dependencies for the above</para>
</listitem>
</itemizedlist>
</sect2>
<sect2>
<title>Kernel Configuration</title>
<para>You will need to set the following options in your kernel
configuration and then <link linkend="kernelconfig">compile a new
kernel</link>.</para>
<itemizedlist>
<listitem>
<para>options NETGRAPH</para>
</listitem>
<listitem>
<para>options NETGRAPH_ASYNC</para>
</listitem>
<listitem>
<para>options NETGRAPH_BPF</para>
</listitem>
<listitem>
<para>options NETGRAPH_CISCO</para>
</listitem>
<listitem>
<para>options NETGRAPH_ECHO</para>
</listitem>
<listitem>
<para>options NETGRAPH_FRAME_RELAY</para>
</listitem>
<listitem>
<para>options NETGRAPH_HOLE</para>
</listitem>
<listitem>
<para>options NETGRAPH_IFACE</para>
</listitem>
<listitem>
<para>options NETGRAPH_KSOCKET</para>
</listitem>
<listitem>
<para>options NETGRAPH_LMI</para>
</listitem>
<listitem>
<para>options NETGRAPH_PPP</para>
</listitem>
<listitem>
<para>options NETGRAPH_PPPOE</para>
</listitem>
<listitem>
<para>options NETGRAPH_PPTPGRE</para>
</listitem>
<listitem>
<para>options "NETGRAPH_RFC1490"</para>
</listitem>
<listitem>
<para>options NETGRAPH_SOCKET</para>
</listitem>
<listitem>
<para>options NETGRAPH_TEE</para>
</listitem>
<listitem>
<para>options NETGRAPH_TTY</para>
</listitem>
<listitem>
<para>options NETGRAPH_UI</para>
</listitem>
<listitem>
<para>options NETGRAPH_VJC</para>
</listitem>
</itemizedlist>
<para>Add the above to your kernel configuration, recompile,
install, and then reboot your system.</para>
</sect2>
<sect2>
<title>Setting up <filename>ppp.conf</filename></title>
<para>Here is an example of a working
<filename>ppp.conf</filename>:</para>
<programlisting>
default: # or name_of_service_provider
set device PPPoE:xl1 # replace xl1 with your ethernet device
set MRU 1490
set MTU 1490
set authname YOURLOGINNAME
set authkey YOURPASSWORD
set log Phase tun command # you can add more detailed logging if you wish
set dial
set login "TIMEOUT 1.5 name:-\\r-login:\\U word:\\P ocol:PPP HELLO" # this isn't necessary
set ifaddr 10.0.0.1/0 10.0.0.2/0
add default HISADDR
nat enable yes # if you want to enable nat for your local net
set cd off
set crtscts off
papchap:
set authname YOURLOGINNAME
set authkey YOURPASSWORD</programlisting>
</sect2>
<sect2>
<title>Running <application>PPP</application></title>
<para>As root, you can run either:</para>
<screen>&prompt.root; <userinput>ppp -dedicated</userinput></screen>
<para>or</para>
<screen>&prompt.root; <userinput>ppp -dedicated name_of_service_provider</userinput></screen>
<para>depending on how you have set up
<filename>ppp.conf</filename>.</para>
</sect2>
<sect2>
<title>Starting <application>PPP</application> at Boot</title>
<para>Add the following to your <filename>/etc/rc.conf</filename>
file:</para>
<programlisting>
ppp_enable="YES"
ppp_mode="dedicated"
ppp_nat="YES"
ppp_profile="default" # or your provider</programlisting>
</sect2>
</sect1>
<sect1 id="slipc">
<title>Setting up a SLIP Client</title>
@ -2474,15 +2651,3 @@ import proto rip interface ed {
</sect2>
</sect1>
</chapter>
<!--
Local Variables:
mode: sgml
sgml-declaration: "../chapter.decl"
sgml-indent-data: t
sgml-omittag: nil
sgml-always-quote-attributes: t
sgml-parent-document: ("../book.sgml" "part" "chapter")
End:
-->