Date: Thu, 17 Oct 2013 21:22:38 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42991 - head/en_US.ISO8859-1/books/handbook/ppp-and-slip Message-ID: <201310172122.r9HLMcrw053048@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: dru Date: Thu Oct 17 21:22:38 2013 New Revision: 42991 URL: http://svnweb.freebsd.org/changeset/doc/42991 Log: Initial header tightening in prep for reviewing this chapter. Many more patches to come. Modified: head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Thu Oct 17 19:42:08 2013 (r42990) +++ head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Thu Oct 17 21:22:38 2013 (r42991) @@ -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</progr <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</progr 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</pr <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</program <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</replace <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</replace <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</replace <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"</ <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"</ 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,RUNNIN <para>Using <application>mpd</application> is the recommended way to connect to an ADSL service with &os;.</para> - </sect2> <sect2>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201310172122.r9HLMcrw053048>