diff options
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml')
| -rw-r--r-- | en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml | 170 |
1 files changed, 73 insertions, 97 deletions
diff --git a/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml b/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml index 63b70425d2..1917ab86e1 100644 --- a/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml +++ b/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml @@ -4,8 +4,7 @@ $FreeBSD$ --> - -<chapter id="ppp-and-slip"> +<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="ppp-and-slip"> <!-- <chapterinfo> <authorgroup> @@ -20,10 +19,10 @@ <title><acronym>PPP</acronym></title> - <sect1 id="ppp-and-slip-synopsis"> + <sect1 xml:id="ppp-and-slip-synopsis"> <title>Synopsis</title> - <indexterm id="ppp-ppp"> + <indexterm xml:id="ppp-ppp"> <primary><acronym>PPP</acronym></primary> </indexterm> @@ -71,7 +70,7 @@ </itemizedlist> </sect1> - <sect1 id="userppp"> + <sect1 xml:id="userppp"> <!-- <sect1info> <authorgroup> @@ -111,7 +110,7 @@ <para>&os; provides built-in support for managing dial-up <acronym>PPP</acronym> connections using &man.ppp.8;. The default &os; kernel provides support for - <devicename>tun</devicename> which is used to interact with a + <filename>tun</filename> which is used to interact with a modem hardware. Configuration is performed by editing at least one configuration file, and configuration files containing examples are provided. Finally, <command>ppp</command> is @@ -167,13 +166,12 @@ <listitem> <para>The subnet mask. If the <acronym>ISP</acronym> has not - provided one, <hostid - role="netmask">255.255.255.255</hostid> will be used in + provided one, <systemitem class="netmask">255.255.255.255</systemitem> will be used in the &man.ppp.8; configuration file.</para> </listitem> <listitem> - <indexterm id="ppp-static-ip"> + <indexterm xml:id="ppp-static-ip"> <primary>static <acronym>IP</acronym> address</primary> </indexterm> @@ -189,8 +187,7 @@ for common <acronym>PPP</acronym> connection scenarios. The required configuration file is <filename>/etc/ppp/ppp.conf</filename> and additional files and - examples are available in <filename - class="directory">/usr/share/examples/ppp/</filename>.</para> + examples are available in <filename>/usr/share/examples/ppp/</filename>.</para> <note> <para>Throughout this section, many of the file examples @@ -204,7 +201,7 @@ should be indented as shown using spaces or tabs.</para> </note> - <sect2 id="userppp-staticIP"> + <sect2 xml:id="userppp-staticIP"> <title>Basic Configuration</title> <indexterm> @@ -277,10 +274,9 @@ <listitem> <para>Identifies the device to which the modem is - connected, where <devicename>COM1</devicename> is - <filename class="devicefile">/dev/cuau0</filename> - and <devicename>COM2</devicename> is <filename - class="devicefile">/dev/cuau1</filename>.</para> + connected, where <filename>COM1</filename> is + <filename>/dev/cuau0</filename> + and <filename>COM2</filename> is <filename>/dev/cuau1</filename>.</para> </listitem> </varlistentry> @@ -412,8 +408,7 @@ gateway. If the <acronym>ISP</acronym> has only provided a static <acronym>IP</acronym> address without a gateway address, replace - <replaceable>y.y.y.y</replaceable> with <hostid - role="netmask">10.0.0.2/0</hostid>.</para> + <replaceable>y.y.y.y</replaceable> with <systemitem class="netmask">10.0.0.2/0</systemitem>.</para> <para>If the <acronym>IP</acronym> address changes whenever a connection is made, change this line to @@ -463,12 +458,10 @@ remove line 17 from <filename>ppp.conf</filename> and create <filename>/etc/ppp/ppp.linkup</filename> with the above two lines. More examples for this file can be found - in <filename - class="directory">/usr/share/examples/ppp/</filename>.</para> + in <filename>/usr/share/examples/ppp/</filename>.</para> </sect2> - <?ignore - <sect2> + <?ignore <sect2> <title>Receiving Incoming Calls</title> <indexterm> @@ -526,11 +519,11 @@ <title><application>PPP</application> Permissions</title> <para>The <command>ppp</command> command must normally be - run as the <username>root</username> user. To instead + run as the <systemitem class="username">root</systemitem> user. To instead allow <command>ppp</command> to run in server mode as a normal user, that user must be given permission to run <command>ppp</command> by adding them to the - <groupname>network</groupname> group in + <systemitem class="groupname">network</systemitem> group in <filename>/etc/group</filename>.</para> <para>The user also needs access to one or more sections of @@ -543,8 +536,7 @@ <literal>default</literal> section, it gives the specified users access to everything.</para> </sect2> - <?ignore - <sect2> + <?ignore <sect2> <title><acronym>PPP</acronym> Shells for Dynamic <acronym>IP</acronym> Users</title> @@ -689,7 +681,7 @@ mary: add 203.14.103.0 netmask 255.255.255.0 HISADDR</programlisting> </sect2> ?> - <sect2 id="userppp-mgetty"> + <sect2 xml:id="userppp-mgetty"> <title><command>mgetty</command> and AutoPPP</title> <indexterm> @@ -706,9 +698,8 @@ mary: <para><xref linkend="dialup"/> provides a good description on enabling dial-up services using &man.getty.8;.</para> - <para>An alternative to <command>getty</command> is <ulink - url="http://mgetty.greenie.net/">mgetty</ulink> (from - <filename role="package">comms/mgetty+sendfax</filename> + <para>An alternative to <command>getty</command> is <link xlink:href="http://mgetty.greenie.net/">mgetty</link> (from + <package>comms/mgetty+sendfax</package> port), a smarter version of <command>getty</command> designed with dial-up lines in mind.</para> @@ -726,8 +717,7 @@ mary: <para>Refer to <xref linkend="userppp-mgetty"/> for more information on <command>mgetty</command>.</para> - <para>By default the <filename - role="package">comms/mgetty+sendfax</filename> port + <para>By default the <package>comms/mgetty+sendfax</package> port comes with the <literal>AUTO_PPP</literal> option enabled allowing <command>mgetty</command> to detect the LCP phase of <acronym>PPP</acronym> connections and @@ -737,8 +727,7 @@ mary: CHAP.</para> <para>This section assumes the user has successfully - compiled, and installed the <filename - role="package">comms/mgetty+sendfax</filename> port on + compiled, and installed the <package>comms/mgetty+sendfax</package> port on his system.</para> <para>Ensure that @@ -830,7 +819,7 @@ set nbns 203.14.100.5</programlisting> <filename>/etc/resolv.conf</filename>.</para> </sect2> - <sect2 id="userppp-PAPnCHAP"> + <sect2 xml:id="userppp-PAPnCHAP"> <title>PAP and CHAP Authentication</title> <indexterm><primary>PAP</primary></indexterm> @@ -916,7 +905,7 @@ set nbns 203.14.100.5</programlisting> &unix; domain socket, asking clients for the specified password before allowing access. The <literal>%d</literal> in the name is replaced with the - <devicename>tun</devicename> device number that is in + <filename>tun</filename> device number that is in use.</para> <para>Once a socket has been set up, the &man.pppctl.8; @@ -924,7 +913,7 @@ set nbns 203.14.100.5</programlisting> the running program.</para> </sect2> - <sect2 id="userppp-nat"> + <sect2 xml:id="userppp-nat"> <title>Using <acronym>PPP</acronym> Network Address Translation Capability</title> @@ -957,7 +946,7 @@ nat port tcp 10.0.0.2:http http</programlisting> <programlisting>nat deny_incoming yes</programlisting> </sect2> - <sect2 id="userppp-final"> + <sect2 xml:id="userppp-final"> <title>Final System Configuration</title> <indexterm> @@ -980,7 +969,7 @@ nat port tcp 10.0.0.2:http http</programlisting> <para>Look for the <literal>network_interfaces</literal> variable. To configure the system to dial the <acronym>ISP</acronym> on demand, make sure the - <devicename>tun0</devicename> device is added to the list, + <filename>tun0</filename> device is added to the list, otherwise remove it.</para> <programlisting>network_interfaces="lo0 tun0" @@ -1062,7 +1051,7 @@ ifconfig_tun0=</programlisting> </sect2> </sect1> - <sect1 id="ppp-troubleshoot"> + <sect1 xml:id="ppp-troubleshoot"> <!-- <sect1info> <authorgroup> @@ -1099,7 +1088,7 @@ ifconfig_tun0=</programlisting> <programlisting>device uart</programlisting> - <para>The <devicename>uart</devicename> device is already + <para>The <filename>uart</filename> device is already included in the <literal>GENERIC</literal> kernel, so no additional steps are necessary in this case. Just check the <command>dmesg</command> output for the modem @@ -1108,13 +1097,13 @@ ifconfig_tun0=</programlisting> <screen>&prompt.root; <userinput>dmesg | grep uart</userinput></screen> <para>This should display some pertinent output about the - <devicename>uart</devicename> devices. These are the COM + <filename>uart</filename> devices. These are the COM ports we need. If the modem acts like a standard serial port, - it should be listed on <devicename>uart1</devicename>, or - <devicename>COM2</devicename>. If so, a kernel rebuild is not + it should be listed on <filename>uart1</filename>, or + <filename>COM2</filename>. If so, a kernel rebuild is not required. When matching up, if the modem is on - <devicename>uart1</devicename>, the modem device would be - <filename class="devicefile">/dev/cuau1</filename>.</para> + <filename>uart1</filename>, the modem device would be + <filename>/dev/cuau1</filename>.</para> </sect2> <sect2> @@ -1132,10 +1121,10 @@ ifconfig_tun0=</programlisting> <screen>&prompt.root; <userinput>ppp</userinput></screen> - <screen>ppp ON example> <userinput>set device <filename class="devicefile">/dev/cuau1</filename></userinput></screen> + <screen>ppp ON example> <userinput>set device /dev/cuau1</userinput></screen> <para>This second command sets the modem device to - <devicename>cuau1</devicename>.</para> + <filename>cuau1</filename>.</para> <screen>ppp ON example> <userinput>set speed 115200</userinput></screen> @@ -1155,12 +1144,12 @@ ifconfig_tun0=</programlisting> <para>This switches to <quote>terminal</quote> mode in order to manually control the modem.</para> - <programlisting>deflink: Entering terminal mode on <filename class="devicefile">/dev/cuau1</filename> + <programlisting>deflink: Entering terminal mode on <filename>/dev/cuau1</filename> type '~h' for help</programlisting> <screen><userinput>at</userinput> OK -<userinput>atdt<replaceable>123456789</replaceable></userinput></screen> +<userinput>atdt123456789</userinput></screen> <para>Use <command>at</command> to initialize the modem, then use <command>atdt</command> and the number for the @@ -1222,8 +1211,7 @@ OK <para>If everything went good we should now have an active connection to the Internet, which could be thrown into the - background using <keycombo - action="simul"><keycap>CTRL</keycap> + background using <keycombo action="simul"><keycap>CTRL</keycap> <keycap>z</keycap></keycombo> If <command>PPP</command> returns to <command>ppp</command> then the connection has bee lost. This is good to know because it @@ -1266,13 +1254,13 @@ OK <application>PPP</application> before going into terminal mode:</para> - <screen>ppp ON example> <userinput>set authname <replaceable>myusername</replaceable></userinput></screen> + <screen>ppp ON example> <userinput>set authname myusername</userinput></screen> <para>Where <replaceable>myusername</replaceable> should be replaced with the username that was assigned by the <acronym>ISP</acronym>.</para> - <screen>ppp ON example> <userinput>set authkey <replaceable>mypassword</replaceable></userinput></screen> + <screen>ppp ON example> <userinput>set authkey mypassword</userinput></screen> <para>Where <replaceable>mypassword</replaceable> should be replaced with the password that was assigned by the @@ -1308,7 +1296,7 @@ nameserver <replaceable>y.y.y.y</replaceable></programlisting> </sect2> </sect1> - <sect1 id="pppoe"> + <sect1 xml:id="pppoe"> <!-- <sect1info> <authorgroup> @@ -1347,7 +1335,7 @@ name_of_service_provider: set login add default HISADDR</programlisting> - <para>As <username>root</username>, run:</para> + <para>As <systemitem class="username">root</systemitem>, run:</para> <screen>&prompt.root; <userinput>ppp -ddial name_of_service_provider</userinput></screen> @@ -1370,8 +1358,7 @@ ppp_profile="name_of_service_provider"</programlisting> <para>Any required service tag information should be in the documentation provided by the <acronym>ISP</acronym>.</para> - <para>As a last resort, one could try installing the <filename - role="package">net/rr-pppoe</filename> package or port. + <para>As a last resort, one could try installing the <package>net/rr-pppoe</package> package or port. Bear in mind however, this may de-program your modem and render it useless, so think twice before doing it. Simply install the program shipped with the modem. Then, access the @@ -1393,22 +1380,20 @@ ppp_profile="name_of_service_provider"</programlisting> <para>Do not forget to change <replaceable>ISP</replaceable> to the profile.</para> - <para>For additional information, refer to <ulink - url="http://renaud.waldura.com/doc/freebsd/pppoe/">Cheaper - Broadband with &os; on DSL</ulink> by Renaud + <para>For additional information, refer to <link xlink:href="http://renaud.waldura.com/doc/freebsd/pppoe/">Cheaper + Broadband with &os; on DSL</link> by Renaud Waldura.</para> </sect2> - <sect2 id="ppp-3com"> + <sect2 xml:id="ppp-3com"> <title>PPPoE with a &tm.3com; <trademark class="registered">HomeConnect</trademark> ADSL Modem Dual Link</title> <para>This modem does not follow the PPPoE specification defined - in <ulink - url="http://www.faqs.org/rfcs/rfc2516.html">RFC - 2516</ulink>.</para> + in <link xlink:href="http://www.faqs.org/rfcs/rfc2516.html">RFC + 2516</link>.</para> <para>In order to make &os; capable of communicating with this device, a sysctl must be set. This can be done automatically @@ -1423,13 +1408,12 @@ ppp_profile="name_of_service_provider"</programlisting> <para>Unfortunately, because this is a system-wide setting, it is not possible to talk to a normal PPPoE client or server - and a &tm.3com; <trademark - class="registered">HomeConnect</trademark> ADSL Modem at + and a &tm.3com; <trademark class="registered">HomeConnect</trademark> ADSL Modem at the same time.</para> </sect2> </sect1> - <sect1 id="pppoa"> + <sect1 xml:id="pppoa"> <title>Using <application>PPP</application> over <acronym>ATM</acronym> (PPPoA)</title> @@ -1503,18 +1487,16 @@ ppp_profile="adsl"</programlisting> <para>The <application>mpd</application> application can be used to connect to a variety of services, in particular PPTP - services. It can be installed using the <filename - role="package">net/mpd5</filename> package or port. Many + services. It can be installed using the <package>net/mpd5</package> package or port. Many ADSL modems require that a PPTP tunnel is created between the modem and computer.</para> <para>Once installed, configure <application>mpd</application> to suit the provider's settings. The port places a set of sample configuration files which are well documented in - <filename class="directory">/usr/local/etc/mpd/</filename>. + <filename>/usr/local/etc/mpd/</filename>. A complete guide to configure <application>mpd</application> - is available in HTML format in <filename - class="directory">/usr/ports/share/doc/mpd/</filename>. + is available in HTML format in <filename>/usr/ports/share/doc/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 @@ -1530,10 +1512,8 @@ ppp_profile="adsl"</programlisting> 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 authname <replaceable>username</replaceable> <co xml:id="co-mpd-ex-user"/> + set bundle password <replaceable>password</replaceable> <co xml:id="co-mpd-ex-pass"/> set bundle disable multilink set link no pap acfcomp protocomp @@ -1571,10 +1551,8 @@ adsl: set link type pptp set pptp mode active set pptp enable originate outcall - set pptp self <replaceable>10.0.0.1</replaceable> <co - id="co-mpd-ex-self"/> - set pptp peer <replaceable>10.0.0.138</replaceable> <co - id="co-mpd-ex-peer"/></programlisting> + set pptp self <replaceable>10.0.0.1</replaceable> <co xml:id="co-mpd-ex-self"/> + set pptp peer <replaceable>10.0.0.138</replaceable> <co xml:id="co-mpd-ex-peer"/></programlisting> <calloutlist> <callout arearefs="co-mpd-ex-self"> @@ -1583,22 +1561,21 @@ adsl: </callout> <callout arearefs="co-mpd-ex-peer"> <para>The <acronym>IP</acronym> address of the ADSL modem. - The Alcatel &speedtouch; Home defaults to <hostid - role="ipaddr">10.0.0.138</hostid>.</para> + The Alcatel &speedtouch; Home defaults to <systemitem class="ipaddress">10.0.0.138</systemitem>.</para> </callout> </calloutlist> <para>It is possible to initialize the connection easily by issuing the following command as - <username>root</username>:</para> + <systemitem class="username">root</systemitem>:</para> - <screen>&prompt.root; <userinput>mpd -b <replaceable>adsl</replaceable></userinput></screen> + <screen>&prompt.root; <userinput>mpd -b adsl</userinput></screen> <para>To view the status of the connection:</para> - <screen>&prompt.user; <userinput>ifconfig <replaceable>ng0</replaceable></userinput> + <screen>&prompt.user; <userinput>ifconfig ng0</userinput> ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500 - inet 216.136.204.117 --> 204.152.186.171 netmask 0xffffffff</screen> + 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> @@ -1608,10 +1585,9 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500 <title>Using pptpclient</title> <para>It is also possible to use &os; to connect to other - PPPoA services using <filename - role="package">net/pptpclient</filename>.</para> + PPPoA services using <package>net/pptpclient</package>.</para> - <para>To use <filename role="package">net/pptpclient</filename> + <para>To use <package>net/pptpclient</package> to connect to a DSL service, install the port or package, then edit <filename>/etc/ppp/ppp.conf</filename>. An example section of <filename>ppp.conf</filename> is given below. For further @@ -1622,8 +1598,8 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500 set log phase chat lcp ipcp ccp tun command set timeout 0 enable dns - set authname <replaceable>username</replaceable> <co id="co-pptp-ex-user"/> - set authkey <replaceable>password</replaceable> <co id="co-pptp-ex-pass"/> + set authname <replaceable>username</replaceable> <co xml:id="co-pptp-ex-user"/> + set authkey <replaceable>password</replaceable> <co xml:id="co-pptp-ex-pass"/> set ifaddr 0 0 add default HISADDR</programlisting> @@ -1651,12 +1627,12 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500 session to the DSL router. Ethernet DSL modems have a preconfigured LAN <acronym>IP</acronym> address to connect to. In the case of the Alcatel &speedtouch; Home, this address is - <hostid role="ipaddr">10.0.0.138</hostid>. The router's + <systemitem class="ipaddress">10.0.0.138</systemitem>. The router's documentation should list the address the device uses. To open the tunnel and start a <acronym>PPP</acronym> session:</para> - <screen>&prompt.root; <userinput>pptp <replaceable>address</replaceable> <replaceable>adsl</replaceable></userinput></screen> + <screen>&prompt.root; <userinput>pptp address adsl</userinput></screen> <tip> <para>If an ampersand (<quote>&</quote>) is added @@ -1665,7 +1641,7 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500 prompt.</para> </tip> - <para>A <devicename>tun</devicename> virtual tunnel device + <para>A <filename>tun</filename> virtual tunnel device will be created for interaction between the <application>pptp</application> and <application>ppp</application> processes. Once the @@ -1673,9 +1649,9 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500 <application>pptp</application> process has confirmed a connection, examine the tunnel:</para> - <screen>&prompt.user; <userinput>ifconfig <replaceable>tun0</replaceable></userinput> + <screen>&prompt.user; <userinput>ifconfig tun0</userinput> tun0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 1500 - inet 216.136.204.21 --> 204.152.186.171 netmask 0xffffff00 + inet 216.136.204.21 --> 204.152.186.171 netmask 0xffffff00 Opened by PID 918</screen> <para>If the connection fails, check the configuration of |