Initial header tightening in prep for reviewing this chapter. Many more patches to come.
This commit is contained in:
Dru Lavigne
parent
f301ef0952
commit
478a8bda84
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=42991
1 changed files with 55 additions and 109 deletions
|
|
@ -6,16 +6,17 @@
|
|||
-->
|
||||
|
||||
<chapter id="ppp-and-slip">
|
||||
<!--
|
||||
<chapterinfo>
|
||||
<authorgroup>
|
||||
<author>
|
||||
<firstname>Jim</firstname>
|
||||
<surname>Mock</surname>
|
||||
<contrib>Restructured, reorganized, and updated by </contrib>
|
||||
<!-- 1 Mar 2000 -->
|
||||
<contrib>Restructured, reorganized, and updated by in Mar 2000</contrib>
|
||||
</author>
|
||||
</authorgroup>
|
||||
</chapterinfo>
|
||||
-->
|
||||
|
||||
<title>PPP</title>
|
||||
|
||||
|
|
@ -48,15 +49,15 @@
|
|||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<indexterm id="ppp-ppp-user">
|
||||
<indexterm>
|
||||
<primary>PPP</primary>
|
||||
<secondary>user PPP</secondary>
|
||||
</indexterm>
|
||||
<indexterm id="ppp-ppp-kernel">
|
||||
<indexterm>
|
||||
<primary>PPP</primary>
|
||||
<secondary>kernel PPP</secondary>
|
||||
</indexterm>
|
||||
<indexterm id="ppp-ppp-ethernet">
|
||||
<indexterm>
|
||||
<primary>PPP</primary>
|
||||
<secondary>over Ethernet</secondary>
|
||||
</indexterm>
|
||||
|
|
@ -75,6 +76,7 @@
|
|||
</sect1>
|
||||
|
||||
<sect1 id="userppp">
|
||||
<!--
|
||||
<sect1info>
|
||||
<authorgroup>
|
||||
<author>
|
||||
|
|
@ -106,14 +108,9 @@
|
|||
</author>
|
||||
</authorgroup>
|
||||
</sect1info>
|
||||
-->
|
||||
|
||||
<title>Using User PPP</title>
|
||||
|
||||
<sect2>
|
||||
<title>User PPP</title>
|
||||
|
||||
<sect3>
|
||||
<title>Assumptions</title>
|
||||
<title>Configuring PPP</title>
|
||||
|
||||
<para>This document assumes you have the following:</para>
|
||||
|
||||
|
|
@ -198,17 +195,6 @@
|
|||
characters is also important.</para>
|
||||
</note>
|
||||
|
||||
</sect3>
|
||||
|
||||
<sect3>
|
||||
<title>Automatic <application>PPP</application>
|
||||
Configuration</title>
|
||||
|
||||
<indexterm>
|
||||
<primary>PPP</primary>
|
||||
<secondary>configuration</secondary>
|
||||
</indexterm>
|
||||
|
||||
<para><command>ppp</command> uses the configuration files
|
||||
located in <filename class="directory">/etc/ppp</filename>.
|
||||
Examples can be found in <filename
|
||||
|
|
@ -222,8 +208,8 @@
|
|||
(i.e., your IP address changes each time you connect to
|
||||
your ISP).</para>
|
||||
|
||||
<sect4 id="userppp-staticIP">
|
||||
<title>PPP and Static IP Addresses</title>
|
||||
<sect2 id="userppp-staticIP">
|
||||
<title>PPP With Static IP Addresses</title>
|
||||
|
||||
<indexterm>
|
||||
<primary>PPP</primary>
|
||||
|
|
@ -513,10 +499,10 @@ protocol: ppp</screen>
|
|||
<filename
|
||||
class="directory">/usr/share/examples/ppp/</filename>
|
||||
directory.</para>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4 id="userppp-dynamicIP">
|
||||
<title>PPP and Dynamic IP Addresses</title>
|
||||
<sect2 id="userppp-dynamicIP">
|
||||
<title>PPP With Dynamic IP Addresses</title>
|
||||
|
||||
<indexterm>
|
||||
<primary>PPP</primary>
|
||||
|
|
@ -615,9 +601,9 @@ protocol: ppp</screen>
|
|||
and
|
||||
<filename>/usr/share/examples/ppp/ppp.linkup.sample</filename>
|
||||
for a detailed example.</para>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4>
|
||||
<sect2>
|
||||
<title>Receiving Incoming Calls</title>
|
||||
|
||||
<indexterm>
|
||||
|
|
@ -636,9 +622,9 @@ protocol: ppp</screen>
|
|||
file contains the following:</para>
|
||||
|
||||
<programlisting>gateway_enable="YES"</programlisting>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4>
|
||||
<sect2>
|
||||
<title>Which getty?</title>
|
||||
|
||||
<para><link linkend="dialup">Configuring FreeBSD for
|
||||
|
|
@ -665,9 +651,9 @@ protocol: ppp</screen>
|
|||
<para>Refer to <link linkend="userppp-mgetty">Mgetty and
|
||||
AutoPPP</link> for more information on
|
||||
<command>mgetty</command>.</para>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4>
|
||||
<sect2>
|
||||
<title><application>PPP</application> Permissions</title>
|
||||
|
||||
<para>The <command>ppp</command> command must normally be
|
||||
|
|
@ -688,10 +674,10 @@ protocol: ppp</screen>
|
|||
<para>If this command is used in the
|
||||
<literal>default</literal> section, it gives the specified
|
||||
users access to everything.</para>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4>
|
||||
<title>PPP Shells for Dynamic-IP Users</title>
|
||||
<sect2>
|
||||
<title>PPP Shells for Dynamic IP Users</title>
|
||||
|
||||
<indexterm>
|
||||
<primary>PPP shells</primary>
|
||||
|
|
@ -740,10 +726,10 @@ exec /usr/sbin/ppp -direct $IDENT</programlisting>
|
|||
|
||||
<para>which prevents <filename>/etc/motd</filename> from
|
||||
being displayed.</para>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4>
|
||||
<title>PPP Shells for Static-IP Users</title>
|
||||
<sect2>
|
||||
<title>PPP Shells for Static IP Users</title>
|
||||
|
||||
<indexterm>
|
||||
<primary>PPP shells</primary>
|
||||
|
|
@ -767,11 +753,11 @@ exec /usr/sbin/ppp -direct $IDENT</programlisting>
|
|||
their shell set to the symbolic link created above (for
|
||||
example, <username>mary</username>'s shell should be
|
||||
<filename>/etc/ppp/ppp-mary</filename>).</para>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4>
|
||||
<sect2>
|
||||
<title>Setting Up <filename>ppp.conf</filename> for
|
||||
Dynamic-IP Users</title>
|
||||
Dynamic IP Users</title>
|
||||
|
||||
<para>The <filename>/etc/ppp/ppp.conf</filename> file
|
||||
should contain something along the lines of:</para>
|
||||
|
|
@ -798,11 +784,11 @@ ttyu1:
|
|||
to the one for <literal>ttyu0:</literal> above. Each
|
||||
line should get a unique IP address from your pool of
|
||||
IP addresses for dynamic users.</para>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4>
|
||||
<sect2>
|
||||
<title>Setting Up <filename>ppp.conf</filename> for
|
||||
Static-IP Users</title>
|
||||
Static IP Users</title>
|
||||
|
||||
<para>Along with the contents of the sample
|
||||
<filename>/usr/share/examples/ppp/ppp.conf</filename>
|
||||
|
|
@ -834,9 +820,9 @@ sam:
|
|||
|
||||
mary:
|
||||
add 203.14.103.0 netmask 255.255.255.0 HISADDR</programlisting>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4 id="userppp-mgetty">
|
||||
<sect2 id="userppp-mgetty">
|
||||
<title><command>mgetty</command> and AutoPPP</title>
|
||||
|
||||
<indexterm>
|
||||
|
|
@ -907,9 +893,9 @@ exec /usr/sbin/ppp -direct pap$IDENT</programlisting>
|
|||
<filename>/etc/ppp/ppp.secret</filename>. See
|
||||
<filename>/usr/share/examples/ppp/ppp.secret.sample</filename>
|
||||
for examples.</para>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4>
|
||||
<sect2>
|
||||
<title>MS Extensions</title>
|
||||
|
||||
<indexterm>
|
||||
|
|
@ -950,9 +936,9 @@ set nbns 203.14.100.5</programlisting>
|
|||
<literal>set dns</literal> line is omitted, PPP will
|
||||
use the values found in
|
||||
<filename>/etc/resolv.conf</filename>.</para>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4 id="userppp-PAPnCHAP">
|
||||
<sect2 id="userppp-PAPnCHAP">
|
||||
<title>PAP and CHAP Authentication</title>
|
||||
|
||||
<indexterm><primary>PAP</primary></indexterm>
|
||||
|
|
@ -1023,9 +1009,9 @@ set nbns 203.14.100.5</programlisting>
|
|||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</sect4>
|
||||
</sect2>
|
||||
|
||||
<sect4>
|
||||
<sect2>
|
||||
<title>Changing Your <command>ppp</command> Configuration
|
||||
on the Fly</title>
|
||||
|
||||
|
|
@ -1046,10 +1032,9 @@ set nbns 203.14.100.5</programlisting>
|
|||
<para>Once a socket has been set up, the &man.pppctl.8;
|
||||
program may be used in scripts that wish to manipulate
|
||||
the running program.</para>
|
||||
</sect4>
|
||||
</sect3>
|
||||
</sect2>
|
||||
|
||||
<sect3 id="userppp-nat">
|
||||
<sect2 id="userppp-nat">
|
||||
<title>Using PPP Network Address Translation
|
||||
Capability</title>
|
||||
|
||||
|
|
@ -1080,9 +1065,9 @@ nat port tcp 10.0.0.2:http http</programlisting>
|
|||
<para>or do not trust the outside at all</para>
|
||||
|
||||
<programlisting>nat deny_incoming yes</programlisting>
|
||||
</sect3>
|
||||
</sect2>
|
||||
|
||||
<sect3 id="userppp-final">
|
||||
<sect2 id="userppp-final">
|
||||
<title>Final System Configuration</title>
|
||||
|
||||
<indexterm>
|
||||
|
|
@ -1188,9 +1173,9 @@ ifconfig_tun0=</programlisting>
|
|||
<filename>start_if.tun0</filename> script), type:</para>
|
||||
|
||||
<screen>&prompt.root; <userinput>ppp -auto provider</userinput></screen>
|
||||
</sect3>
|
||||
</sect2>
|
||||
|
||||
<sect3>
|
||||
<sect2>
|
||||
<title>Summary</title>
|
||||
|
||||
<para>To recap, the following steps are necessary when setting
|
||||
|
|
@ -1278,21 +1263,21 @@ ifconfig_tun0=</programlisting>
|
|||
file.</para>
|
||||
</step>
|
||||
</procedure>
|
||||
</sect3>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="ppp-troubleshoot">
|
||||
<!--
|
||||
<sect1info>
|
||||
<authorgroup>
|
||||
<author>
|
||||
<firstname>Tom</firstname>
|
||||
<surname>Rhodes</surname>
|
||||
<contrib>Contributed by </contrib>
|
||||
<contrib>Contributed by in June 2003</contrib>
|
||||
</author>
|
||||
</authorgroup>
|
||||
<!-- 13 June 2003 -->
|
||||
</sect1info>
|
||||
-->
|
||||
<title>Troubleshooting <acronym>PPP</acronym> Connections</title>
|
||||
|
||||
<indexterm>
|
||||
|
|
@ -1460,8 +1445,9 @@ OK
|
|||
connection to the <acronym>ISP</acronym> and lowercase p's
|
||||
show that the connection has been lost for whatever reason.
|
||||
<command>ppp</command> only has these 2 states.</para>
|
||||
</sect2>
|
||||
|
||||
<sect3>
|
||||
<sect2>
|
||||
<title>Debugging</title>
|
||||
|
||||
<para>If you have a direct line and cannot seem to make a
|
||||
|
|
@ -1546,15 +1532,11 @@ nameserver <replaceable>y.y.y.y</replaceable></programlisting>
|
|||
|
||||
<para>to <filename>/etc/syslog.conf</filename>. In most
|
||||
cases, this functionality already exists.</para>
|
||||
|
||||
</sect3>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
|
||||
|
||||
|
||||
<sect1 id="pppoe">
|
||||
<!--
|
||||
<sect1info>
|
||||
<authorgroup>
|
||||
<author>
|
||||
|
|
@ -1562,12 +1544,11 @@ nameserver <replaceable>y.y.y.y</replaceable></programlisting>
|
|||
<surname>Mock</surname>
|
||||
<contrib>Contributed (from
|
||||
http://node.to/freebsd/how-tos/how-to-freebsd-pppoe.html)
|
||||
by </contrib>
|
||||
by in Jan 2000</contrib>
|
||||
</author>
|
||||
</authorgroup>
|
||||
<!-- 10 Jan 2000 -->
|
||||
</sect1info>
|
||||
|
||||
-->
|
||||
<title>Using PPP over Ethernet (PPPoE)</title>
|
||||
|
||||
<indexterm>
|
||||
|
|
@ -1575,26 +1556,9 @@ nameserver <replaceable>y.y.y.y</replaceable></programlisting>
|
|||
<secondary>over Ethernet</secondary>
|
||||
</indexterm>
|
||||
|
||||
<indexterm>
|
||||
<primary>PPPoE</primary>
|
||||
<see>PPP, over Ethernet</see>
|
||||
</indexterm>
|
||||
|
||||
<para>This section describes how to set up PPP over Ethernet
|
||||
(<acronym>PPPoE</acronym>).</para>
|
||||
|
||||
<sect2>
|
||||
<title>Configuring the Kernel</title>
|
||||
|
||||
<para>No kernel configuration is necessary for PPPoE any longer.
|
||||
If the necessary netgraph support is not built into the
|
||||
kernel, it will be dynamically loaded by
|
||||
<application>ppp</application>.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Setting Up <filename>ppp.conf</filename></title>
|
||||
|
||||
<para>Here is an example of a working
|
||||
<filename>ppp.conf</filename>:</para>
|
||||
|
||||
|
|
@ -1610,18 +1574,10 @@ name_of_service_provider:
|
|||
set login
|
||||
add default HISADDR</programlisting>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Running <application>ppp</application></title>
|
||||
|
||||
<para>As <username>root</username>, you can run:</para>
|
||||
|
||||
<screen>&prompt.root; <userinput>ppp -ddial name_of_service_provider</userinput></screen>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Starting <application>ppp</application> at Boot</title>
|
||||
|
||||
<para>Add the following to your
|
||||
|
|
@ -1631,7 +1587,6 @@ name_of_service_provider:
|
|||
ppp_mode="ddial"
|
||||
ppp_nat="YES" # if you want to enable nat for your local network, otherwise NO
|
||||
ppp_profile="name_of_service_provider"</programlisting>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Using a PPPoE Service Tag</title>
|
||||
|
|
@ -1670,16 +1625,10 @@ ppp_profile="name_of_service_provider"</programlisting>
|
|||
<para>Do not forget to change <replaceable>ISP</replaceable>
|
||||
to the profile you have just found above.</para>
|
||||
|
||||
<para>For additional information, see:</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink
|
||||
<para>For additional information, refer to <ulink
|
||||
url="http://renaud.waldura.com/doc/freebsd/pppoe/">Cheaper
|
||||
Broadband with FreeBSD on DSL</ulink> by Renaud
|
||||
Waldura.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="ppp-3com">
|
||||
|
|
@ -1714,7 +1663,6 @@ ppp_profile="name_of_service_provider"</programlisting>
|
|||
and a &tm.3com; <trademark
|
||||
class="registered">HomeConnect</trademark> ADSL Modem at
|
||||
the same time.</para>
|
||||
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
|
|
@ -1784,7 +1732,6 @@ ppp_profile="adsl"</programlisting>
|
|||
<para>For this to work correctly you will need to have used the
|
||||
sample <filename>ppp.conf</filename> which is supplied with
|
||||
the <filename role="package">net/pppoa</filename> port.</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
|
|
@ -1897,7 +1844,6 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500
|
|||
|
||||
<para>Using <application>mpd</application> is the recommended
|
||||
way to connect to an ADSL service with &os;.</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
|
|
|
|||
Loading…
Reference in a new issue