Update this whole chapter to 8.X. I also kept 7.X only parts but with a

red warning at the beginning.

PR:		docs/143041
Submitted by:	Robert Jenssen <robertjenssen@ozemail.com.au>
This commit is contained in:
Marc Fonvieille 2010-08-21 12:16:32 +00:00
parent 1b26d4438b
commit 514d4f07ce
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=36291

View file

@ -40,7 +40,7 @@
<para>How to set up user PPP.</para>
</listitem>
<listitem>
<para>How to set up kernel PPP.</para>
<para>How to set up kernel PPP (&os; 7.X only).</para>
</listitem>
<listitem>
<para>How to set up <acronym>PPPoE</acronym> (PPP over
@ -52,7 +52,7 @@
</listitem>
<listitem>
<para>How to configure and set up a SLIP client and
server.</para>
server (&os;&nbsp;7.X only).</para>
</listitem>
</itemizedlist>
@ -135,6 +135,18 @@
<title>Using User PPP</title>
<warning>
<para>As of &os; 8.0, device nodes for serial ports have been
renamed from
<filename>/dev/cuad<replaceable>N</replaceable></filename> to
<filename>/dev/cuau<replaceable>N</replaceable></filename> and
from
<filename>/dev/ttyd<replaceable>N</replaceable></filename> to
<filename>/dev/ttyu<replaceable>N</replaceable></filename>.
&os;&nbsp;7.X users will have to adapt the following
documentation according to these changes.</para>
</warning>
<sect2>
<title>User PPP</title>
@ -290,7 +302,7 @@
<programlisting>1 default:
2 set log Phase Chat LCP IPCP CCP tun command
3 ident user-ppp VERSION (built COMPILATIONDATE)
4 set device /dev/cuad0
4 set device /dev/cuau0
5 set speed 115200
6 set dial "ABORT BUSY ABORT NO\\sCARRIER TIMEOUT 5 \
7 \"\" AT OK-AT-OK ATE1Q0 OK \\dATDT\\T TIMEOUT 40 CONNECT"
@ -348,10 +360,10 @@
<listitem>
<para>Identifies the device to which the modem is
connected. <devicename>COM1</devicename> is
<filename class="devicefile">/dev/cuad0</filename>
<filename class="devicefile">/dev/cuau0</filename>
and
<devicename>COM2</devicename> is
<filename class="devicefile">/dev/cuad1</filename>.</para>
<filename class="devicefile">/dev/cuau1</filename>.</para>
</listitem>
</varlistentry>
@ -816,11 +828,11 @@ exec /usr/sbin/ppp -direct $IDENT</programlisting>
set debug phase lcp chat
set timeout 0
ttyd0:
ttyu0:
set ifaddr 203.14.100.1 203.14.100.20 255.255.255.255
enable proxy
ttyd1:
ttyu1:
set ifaddr 203.14.100.1 203.14.100.21 255.255.255.255
enable proxy</programlisting>
@ -831,7 +843,7 @@ ttyd1:
<para>The <literal>default:</literal> section is loaded for
each session. For each dialup line enabled in
<filename>/etc/ttys</filename> create an entry similar to
the one for <literal>ttyd0:</literal> above. Each line
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>
@ -1322,6 +1334,11 @@ ifconfig_tun0=</programlisting>
<title>Using Kernel PPP</title>
<warning>
<para>This section applies and is valid only for
&os;&nbsp;7.X.</para>
</warning>
<sect2>
<title>Setting Up Kernel PPP</title>
@ -1810,6 +1827,19 @@ exit 1
<secondary>troubleshooting</secondary>
</indexterm>
<warning>
<para>As of &os; 8.0, the &man.uart.4; driver replaces the
&man.sio.4; driver. Device nodes for serial ports have been
renamed from
<filename>/dev/cuad<replaceable>N</replaceable></filename> to
<filename>/dev/cuau<replaceable>N</replaceable></filename> and
from
<filename>/dev/ttyd<replaceable>N</replaceable></filename> to
<filename>/dev/ttyu<replaceable>N</replaceable></filename>.
&os;&nbsp;7.X users will have to adapt the following
documentation according to these changes.</para>
</warning>
<para>This section covers a few issues which may arise when
using PPP over a modem connection. For instance, perhaps you
need to know exactly what prompts the system you are dialing
@ -1828,25 +1858,25 @@ exit 1
<para>When using a custom kernel, make sure to include the following
line in your kernel configuration file:</para>
<programlisting>device sio</programlisting>
<programlisting>device uart</programlisting>
<para>The <devicename>sio</devicename> device is already included
<para>The <devicename>uart</devicename> 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
device with:</para>
<screen>&prompt.root; <userinput>dmesg | grep sio</userinput></screen>
<screen>&prompt.root; <userinput>dmesg | grep uart</userinput></screen>
<para>You should get some pertinent output about the
<devicename>sio</devicename> devices. These are the COM
<devicename>uart</devicename> devices. These are the COM
ports we need. If your modem acts like a standard serial
port then you should see it listed on
<devicename>sio1</devicename>, or <devicename>COM2</devicename>. If
<devicename>uart1</devicename>, or <devicename>COM2</devicename>. If
so, you are not required to rebuild the kernel.
When matching up sio modem is on <devicename>sio1</devicename> or
When matching up sio modem is on <devicename>uart1</devicename> or
<devicename>COM2</devicename> if you are in DOS, then your
modem device would be <filename class="devicefile">/dev/cuad1</filename>.</para>
modem device would be <filename class="devicefile">/dev/cuau1</filename>.</para>
</sect2>
<sect2>
@ -1867,10 +1897,10 @@ exit 1
<para>We have now started <command>ppp</command>.</para>
<screen>ppp ON example&gt; <userinput>set device <filename class="devicefile">/dev/cuad1</filename></userinput></screen>
<screen>ppp ON example&gt; <userinput>set device <filename class="devicefile">/dev/cuau1</filename></userinput></screen>
<para>We set our modem device, in this case it is
<devicename>cuad1</devicename>.</para>
<devicename>cuau1</devicename>.</para>
<screen>ppp ON example&gt; <userinput>set speed 115200</userinput></screen>
@ -1889,7 +1919,7 @@ exit 1
<para>Switch to <quote>terminal</quote> mode so that we can manually
control the modem.</para>
<programlisting>deflink: Entering terminal mode on <filename class="devicefile">/dev/cuad1</filename>
<programlisting>deflink: Entering terminal mode on <filename class="devicefile">/dev/cuau1</filename>
type '~h' for help</programlisting>
<screen><userinput>at</userinput>
@ -2505,6 +2535,11 @@ tun0: flags=8051&lt;UP,POINTOPOINT,RUNNING,MULTICAST&gt; mtu 1500
<title>Using SLIP</title>
<indexterm><primary>SLIP</primary></indexterm>
<warning>
<para>This section applies and is valid only for
&os;&nbsp;7.X.</para>
</warning>
<sect2 id="slipc">
<title>Setting Up a SLIP Client</title>