* Grammar nit changes

* Reworded sentences for consistency/understandability
 * Consistency/Standardization changes
 * Minor markup changes, placing items in <devicename>, and so forth
 * Revising constant usage of ie
 * Used generic Example.EDU in examples
This commit is contained in:
Chern Lee 2001-09-20 00:37:20 +00:00
parent 65cbdae147
commit 799d04ae77
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=10769

View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v 1.58 2001/09/07 06:43:50 murray Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v 1.59 2001/09/08 00:29:26 logo Exp $
-->
<chapter id="ppp-and-slip">
@ -43,7 +43,7 @@
<primary>PPP</primary>
<secondary>over Ethernet</secondary>
</indexterm>
<para>This chapter covers four varieties of PPP;
<para>This chapter covers four varieties of PPP:
<emphasis>user</emphasis>, <emphasis>kernel</emphasis>,
<emphasis>PPPoE</emphasis> (PPP over Ethernet) and
<emphasis>PPPoA</emphasis> (PPP over ATM). It also covers
@ -62,11 +62,11 @@
with the outside world whereas kernel-ppp uses the
<devicename>ppp</devicename> device.</para>
<para>From here on out in this chapter, user ppp will simply be
<para>Throughout in this chapter, user ppp will simply be
referred to as ppp unless a distinction needs to be made between it
and any other PPP software such as <command>pppd</command>.
Unless otherwise stated, all of the commands explained in this
section should be executed as root.</para>
section should be executed as <username>root</username>.</para>
</sect1>
<sect1 id="userppp">
@ -114,7 +114,11 @@
</indexterm>
<listitem>
<para>An account with an Internet Service Provider (ISP) which
you connect to using PPP. Further, you have a modem or
you connect to using PPP.</para>
</listitem>
<listitem>
<para>Further, you have a modem or
other device connected to your system and configured
correctly, which allows you to connect to your ISP.</para>
</listitem>
@ -139,16 +143,16 @@
<primary>password</primary>
</indexterm>
<listitem>
<para>Your login name and password. This can be either a
<para>Your login name and password. (Either a
regular Unix-style login and password pair, or a PAP or CHAP
login and password pair.</para>
login and password pair.)</para>
</listitem>
<indexterm id="ppp-nameserver">
<primary>nameserver</primary>
</indexterm>
<listitem>
<para>The IP address(es) of one or more name servers.
<para>The IP address of one or more name servers.
Normally, you will be given two IP addresses by your ISP to
use for this. If they have not given you at least one, then
you can use the <command>enable dns</command> command in
@ -192,7 +196,18 @@
</itemizedlist>
<para>If you do not have any of the required information, contact
your ISP and make sure they provide it to you.</para>
your ISP.</para>
<note>
<para>Throughout this section, many of the examples showing
the contents of configuration files are numbered by line.
These numbers serve to aid in the presentation and
discussion only and are not meant to be placed in the actual
file. Proper indentation with tab and space characters is
also important.</para>
</note>
</sect3>
<sect3>
@ -208,7 +223,7 @@
<note><para>It should be noted that the tunnel driver creates devices
on demand, so <command>ifconfig -a</command> will not necessarily
show up with any <devicename>tun</devicename> devices.</para></note>
show any <devicename>tun</devicename> devices.</para></note>
</sect3>
@ -217,9 +232,10 @@
<para>Under normal circumstances, most users will only use one
<devicename>tun</devicename> device
(<filename>/dev/tun0</filename>). References to
(<devicename>/dev/tun0</devicename>). References to
<devicename>tun0</devicename> below may be changed to
<devicename>tunN</devicename> where N is any unit number.</para>
<devicename>tunN</devicename> where <literal>N</literal>
is any unit number corresponding to your system.</para>
<para>For FreeBSD installations that do not have DEVFS enabled,
the existence of the <devicename>tun0</devicename> device should
@ -227,19 +243,19 @@
nodes will be created on demand).</para>
<para>The easiest way to make sure that the
<devicename>tun0</devicename> device is configured correctly,
<devicename>tun0</devicename> device is configured correctly
is to remake the device. To remake the device, do the
following:</para>
<screen>&prompt.root; <userinput>cd /dev</userinput>
&prompt.root; <userinput>./MAKEDEV tun0</userinput></screen>
&prompt.root; <userinput>sh MAKEDEV tun0</userinput></screen>
<para>If you need 16 tunnel devices in your kernel, you will need
to create them. This can be done by executing the following
commands:</para>
<screen>&prompt.root; <userinput>cd /dev</userinput>
&prompt.root; <userinput>./MAKEDEV tun15</userinput></screen>
&prompt.root; <userinput>sh MAKEDEV tun15</userinput></screen>
</sect3>
<sect3>
@ -254,19 +270,19 @@
<indexterm id="ppp-hosts">
<primary><filename>hosts</filename></primary>
</indexterm>
<para>The resolver is the part of the system that turns IP
<para>The resolver is the part of the system that looks up IP
addresses into hostnames and vice versa. It can be configured
to look for maps that describe IP to hostname mappings in one of
two places. The first is a file called
<filename>/etc/hosts</filename>. Read &man.hosts.5; for more
information. The second is the Internet Domain Name Service
(DNS), a distributed data base, the discussion of which is
beyond the scope of this document.</para>
(DNS), a distributed data base. For more information on DNS
and DNS services, refer to <xref linkend="dns">.</para>
<para>The resolver is a set of system calls that do the name
<para>The resolver is a set of system calls that perform the name
mappings, but you have to tell it where to find the
information. For versions of FreeBSD prior to 5.0, you do this
by first editing the file <filename>/etc/host.conf</filename>.
information. For versions of FreeBSD prior to 5.0. This is done by
editing the file <filename>/etc/host.conf</filename>.
FreeBSD 5.0 uses the <filename>/etc/nsswitch.conf</filename> file.</para>
<sect4>
@ -279,7 +295,7 @@
bind</programlisting>
<para>This instructs the resolver to first look in the file
<filename>/etc/hosts</filename>, and then to consult the DNS
<filename>/etc/hosts</filename>, and to then consult the DNS
if the name was not found.</para>
</sect4>
@ -292,7 +308,7 @@ bind</programlisting>
<programlisting>hosts: files, dns</programlisting>
<para>This instructs the resolver to first look in the file
<filename>/etc/hosts</filename>, and then to consult the DNS
<filename>/etc/hosts</filename>, and to then consult DNS
if the name was not found.</para>
</sect4>
@ -300,7 +316,8 @@ bind</programlisting>
<title>Edit <filename>/etc/hosts</filename></title>
<para>This file may contain the IP addresses and names of
machines on your network. At a bare minimum it should contain
machines on your local network. At a bare minimum it should
contain
entries for the machine which will be running ppp. Assuming
that your machine is called <hostid
role="fqdn">foo.bar.com</hostid> with the IP address <hostid
@ -321,6 +338,12 @@ bind</programlisting>
shorthand <hostid>foo</hostid>) to the IP address <hostid
role="ipaddr">10.0.0.1</hostid>.</para>
<note>
<para><hostid role="ipaddr">127.0.0.1</hostid> and
<hostid>localhost</hostid> are known as loopback
addresses, which loopback to the local machine.</para>
</note>
<para>If your provider allocates you a static IP address and
name, and you are not using that as your host name, add this
to the <filename>/etc/hosts</filename> too.</para>
@ -388,9 +411,10 @@ nameserver <replaceable>y.y.y.y</replaceable></programlisting>
should look similar to the example below.</para>
<note>
<para>Lines that end in a <literal>:</literal> start in the
first column, all other lines should be indented as shown
using spaces or tabs.</para>
<para>Lines that end in a <literal>:</literal> start in
the first column (beginning of the line)&mdash; all other
lines should be indented as shown using spaces or
tabs.</para>
</note>
<programlisting>1 default:
@ -412,9 +436,6 @@ nameserver <replaceable>y.y.y.y</replaceable></programlisting>
17 set ifaddr <replaceable>x.x.x.x</replaceable> <replaceable>y.y.y.y</replaceable> 255.255.255.255 0.0.0.0
18 add default HISADDR</programlisting>
<para>Do not include the line numbers, they are just for
reference in this discussion.</para>
<variablelist>
<varlistentry>
<term>Line 1:</term>
@ -457,9 +478,9 @@ nameserver <replaceable>y.y.y.y</replaceable></programlisting>
<listitem>
<para>Identifies the device to which the modem is
connected. <devicename>COM1</devicename> is
<filename>/dev/cuaa0</filename> and
<devicename>/dev/cuaa0</devicename> and
<devicename>COM2</devicename> is
<filename>/dev/cuaa1</filename>.</para>
<devicename>/dev/cuaa1</devicename>.</para>
</listitem>
</varlistentry>
@ -549,7 +570,7 @@ nameserver <replaceable>y.y.y.y</replaceable></programlisting>
<listitem>
<para>Identifies the user name and password. When connecting
using a unix-style login prompt, these values are referred
using a Unix-style login prompt, these values are referred
to by the <command>set login</command> command using the \U
and \P variables. When connecting using PAP or CHAP, these
values are used at authentication time.</para>
@ -785,7 +806,8 @@ protocol: ppp</screen>
<title><application>PPP</application> Permissions</title>
<para>The <command>ppp</command> command must normally be run
as user id 0. If however, you wish to allow
as the <username>root</username> user. If however, you wish
to allow
<command>ppp</command> to run in server mode as a normal
user by executing <command>ppp</command> as described below,
that user must be given permission to run
@ -856,11 +878,11 @@ exec /usr/sbin/ppp -direct $IDENT</programlisting>
<title>PPP Shells for Static-IP Users</title>
<indexterm><primary>PPP shells</primary></indexterm>
<para>Create the <filename>ppp-shell</filename> file as above
<para>Create the <filename>ppp-shell</filename> file as above,
and for each account with statically assigned IPs create a
symbolic link to <filename>ppp-shell</filename>.</para>
<para>For example, if you have three dialup customers
<para>For example, if you have three dialup customers,
<username>fred</username>, <username>sam</username>, and
<username>mary</username>, that you route class C networks
for, you would type the following:</para>
@ -870,7 +892,7 @@ exec /usr/sbin/ppp -direct $IDENT</programlisting>
&prompt.root; <userinput>ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-mary</userinput></screen>
<para>Each of these users dialup accounts should have their
shell set to the symbolic link created above (i.e.,
shell set to the symbolic link created above (for example,
<username>mary</username>'s shell should be
<filename>/etc/ppp/ppp-mary</filename>).</para>
</sect5>
@ -1034,7 +1056,7 @@ set dns 203.14.100.1 203.14.100.2
set nbns 203.14.100.5</programlisting>
<para>This will tell the clients the primary and secondary
name server addresses, and a netbios nameserver host.</para>
name server addresses, and a NetBIOS nameserver host.</para>
<para>In version 2 and above, if the
<literal>set dns</literal> line is omitted, PPP will use the
@ -1068,10 +1090,6 @@ set nbns 203.14.100.5</programlisting>
12 set authname <replaceable>MyUserName</replaceable>
13 set authkey <replaceable>MyPassword</replaceable></programlisting>
<para>As always, do not include the line numbers, they are just
for reference in this discussion. Indentation of at least one
space is required.</para>
<variablelist>
<varlistentry>
<term>Line 7:</term>
@ -1125,9 +1143,9 @@ set nbns 203.14.100.5</programlisting>
suitable diagnostic port has been set up. To do this, add the
following line to your configuration:</para>
<programlisting>set server /var/run/ppp-tun%d DiagnosticPassword 0177</programlisting>
<programlisting>set server /var/run/ppp-tun<replaceable>%d</replaceable> DiagnosticPassword 0177</programlisting>
<para>This will tell PPP to listen to the specified unix-domain
<para>This will tell PPP to listen to the specified 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
@ -1189,7 +1207,7 @@ set nbns 203.14.100.5</programlisting>
<primary><application>routed</application></primary>
</indexterm>
<para>It is important that the <command>routed</command> daemon is
not started (it is started by default), as it
not started (it is started by default), as
<command>routed</command> tends to delete the default routing
table entries created by <command>ppp</command>.</para>
@ -1361,14 +1379,14 @@ set nbns 203.14.100.5</programlisting>
<orderedlist>
<listitem>
<para>As a <quote>client</quote>, i.e., you want to connect your
<para>As a <quote>client</quote> &mdash; you want to connect your
machine to the outside world via a PPP serial connection or
modem line.</para>
</listitem>
<indexterm><primary>PPP</primary><secondary>server</secondary></indexterm>
<listitem>
<para>as a <quote>server</quote>, i.e. your machine is located on
<para>as a <quote>server</quote> &mdash; your machine is located on
the network and used to connect other computers using
PPP.</para>
</listitem>
@ -1385,6 +1403,17 @@ set nbns 203.14.100.5</programlisting>
</sect2>
<sect2>
<sect2info>
<authorgroup>
<author>
<firstname>Trev</firstname>
<surname>Roydhouse</surname>
<contrib>Based on information provided by </contrib>
<!-- Trev.Roydhouse@f401.n711.z3.fidonet.org -->
</author>
</authorgroup>
</sect2info>
<title>Using <command>pppd</command> as a Client</title>
<indexterm><primary>PPP</primary><secondary>client</secondary></indexterm>
<indexterm><primary>Cisco</primary></indexterm>
@ -1566,10 +1595,6 @@ defaultroute # put this if you want that PPP server will be
to do is run <command>pppd</command>, like so:</para>
<screen>&prompt.root; <userinput>pppd</userinput></screen>
<para>This sample is based primarily on information provided by:
Trev Roydhouse &lt;Trev.Roydhouse@f401.n711.z3.fidonet.org&gt;
and used with permission.</para>
</sect2>
<sect2>
@ -1809,8 +1834,8 @@ exit 1
<see>PPP, over Ethernet</see>
</indexterm>
<para>The following describes how to set up PPP over Ethernet, a.k.a,
PPPoE.</para>
<para>This section how to set up PPP over Ethernet
(<acronym>PPPoE</acronym>).</para>
<sect2>
<title>Configuring the kernel</title>
@ -1959,7 +1984,8 @@ ppp_profile="name_of_service_provider"</programlisting>
Alcatel's license agreement</ulink>.</para>
<para>To install the port, simply use the <link linkend="ports">
ports collection</link> to install the net/pppoa port and follow
ports collection</link> to install the <port>net/pppoa</port>
port and follow
the instructions provided there.</para>
</sect2>
@ -1994,9 +2020,9 @@ ppp_profile="name_of_service_provider"</programlisting>
<title>Setting up a SLIP Client</title>
<indexterm><primary>SLIP</primary><secondary>client</secondary></indexterm>
<para>The following is one way to set up a FreeBSD machine for SLIP
on a static host network. For dynamic hostname assignments (i.e.,
your address changes each time you dial up), you probably need to
do something much fancier.</para>
on a static host network. For dynamic hostname assignments (your
address changes each time you dial up), you probably need to
have a more complex setup.</para>
<para>First, determine which serial port your modem is connected to.
Many people setup a symbolic link, such as
@ -2031,10 +2057,10 @@ ppp_profile="name_of_service_provider"</programlisting>
this:</para>
<programlisting>127.0.0.1 localhost loghost
136.152.64.181 silvia.HIP.Berkeley.EDU silvia.HIP silvia
136.152.64.1 inr-3.Berkeley.EDU inr-3 slip-gateway
128.32.136.9 ns1.Berkeley.edu ns1
128.32.136.12 ns2.Berkeley.edu ns2</programlisting>
136.152.64.181 water.CS.Example.EDU water.CS water
136.152.64.1 inr-3.CS.Example.EDU inr-3 slip-gateway
128.32.136.9 ns1.Example.EDU ns1
128.32.136.12 ns2.Example.EDU ns2</programlisting>
</step>
<step>
@ -2054,13 +2080,14 @@ ppp_profile="name_of_service_provider"</programlisting>
<programlisting>hostname=<quote>myname.my.domain</quote></programlisting>
<para>You should give it your full Internet
hostname.</para>
<para>Your machine's full Internet hostname should be
placed here.</para>
</listitem>
<listitem>
<para>Add sl0 to the list of network interfaces by
changing the line that says:</para>
<para>Add <devicename>sl0</devicename> to the list of
network interfaces by changing the line that
says:</para>
<programlisting>network_interfaces="lo0"</programlisting>
@ -2094,7 +2121,7 @@ ppp_profile="name_of_service_provider"</programlisting>
<para>Make a file <filename>/etc/resolv.conf</filename> which
contains:</para>
<programlisting>domain HIP.Berkeley.EDU
<programlisting>domain CS.Example.EDU
nameserver 128.32.136.9
nameserver 128.32.136.12</programlisting>
@ -2108,10 +2135,7 @@ nameserver 128.32.136.12</programlisting>
<step>
<para>Set the password for <username>root</username> and
<username>toor</username> (and any other
accounts that do not have a password). Use passwd or
&man.vipw.8;, do not edit the
<filename>/etc/passwd</filename> or
<filename>/etc/master.passwd</filename> files!</para>
accounts that do not have a password).</para>
</step>
<step>
@ -2127,9 +2151,9 @@ nameserver 128.32.136.12</programlisting>
<procedure>
<step>
<para>Dial up, type <command>slip</command> at the prompt,
enter your machine name and password. The things you need
to enter depends on your environment. If you use kermit, you
can try a script like this:</para>
enter your machine name and password. What is required to
be entered depends on your environment. If you use
kermit, you can try a script like this:</para>
<programlisting># kermit setup
set modem hayes
@ -2147,19 +2171,22 @@ output ***\x0d, echo \x0aCONNECTED\x0a</programlisting>
<para>Of course, you have to change the hostname and password
to fit yours. After doing so, you can just type
<command>slip</command> from the kermit prompt to get
connected.</para>
<command>slip</command> from the kermit prompt to
connect.</para>
<note>
<para>Leaving your password in plain text anywhere in the
filesystem is generally a BAD idea. Do it at your own
risk.</para>
filesystem is generally a <emphasis>bad</emphasis> idea.
Do it at your own risk.</para>
</note>
</step>
<step>
<para>Leave the kermit there (you can suspend it by
<command>z</command>) and as root, type:</para>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>z</keycap>
</keycombo>) and as root, type:</para>
<screen>&prompt.root; <userinput>slattach -h -c -s 115200 /dev/modem</userinput></screen>
@ -2181,7 +2208,8 @@ output ***\x0d, echo \x0aCONNECTED\x0a</programlisting>
<para>to kill <command>slattach</command>. Keep in mind you must be
<username>root</username> to do the above. Then go back to
kermit (<command>fg</command> if you suspended it) and exit from
kermit (by running <command>fg</command> if you suspended it) and
exit from
it (<command>q</command>).</para>
<para>The <command>slattach</command> manual page says you have
@ -2227,7 +2255,7 @@ sl0: flags=10&lt;POINTOPOINT&gt;
<listitem>
<para>Also, <command>netstat -r</command> will give the
routing table, in case you get the <quote>no route to
host</quote> messages from ping. Mine looks like:</para>
host</quote> messages from ping. An example shown here:</para>
<screen>&prompt.root; <userinput>netstat -r</userinput>
Routing tables
@ -2238,14 +2266,14 @@ Destination Gateway Flags Refs Use IfaceMTU Rtt N
Route Tree for Protocol Family inet:
(root node) =&gt;
default inr-3.Berkeley.EDU UG 8 224515 sl0 - -
localhost.Berkel localhost.Berkeley UH 5 42127 lo0 - 0.438
inr-3.Berkeley.E silvia.HIP.Berkele UH 1 0 sl0 - -
silvia.HIP.Berke localhost.Berkeley UGH 34 47641234 lo0 - 0.438
default inr-3.Example.EDU UG 8 224515 sl0 - -
localhost.Exampl localhost.Example. UH 5 42127 lo0 - 0.438
inr-3.Example.ED water.CS.Example.E UH 1 0 sl0 - -
water.CS.Example localhost.Example. UGH 34 47641234 lo0 - 0.438
(root node)</screen>
<para>This is after transferring a bunch of files, your
numbers should be smaller).</para>
<para>This is after the link has been up for a while, the numbers
on your system will vary.</para>
</listitem>
</itemizedlist>
</sect3>
@ -2258,16 +2286,20 @@ silvia.HIP.Berke localhost.Berkeley UGH 34 47641234 lo0 - 0.438
<para>This document provides suggestions for setting up SLIP Server
services on a FreeBSD system, which typically means configuring
your system to automatically startup connections upon login for
remote SLIP clients. The author has written this document based
remote SLIP clients.</para>
<!-- Disclaimer is not necessarily relevant
<para> The author has written this document based
on his experience; however, as your system and needs may be
different, this document may not answer all of your questions, and
the author cannot be responsible if you damage your system or lose
data due to attempting to follow the suggestions here.</para>
-->
<sect3 id="slips-prereqs">
<title>Prerequisites</title>
<indexterm><primary>TCP/IP networking</primary></indexterm>
<para>This document is very technical in nature, so background
<para>This section is very technical in nature, so background
knowledge is required. It is assumed that you are familiar with
the TCP/IP network protocol, and in particular, network and node
addressing, network address masks, subnetting, routing, and
@ -2317,8 +2349,7 @@ silvia.HIP.Berke localhost.Berkeley UGH 34 47641234 lo0 - 0.438
<para>For example, if a SLIP user ID were
<username>Shelmerg</username>, <username>Shelmerg</username>'s
entry in <filename>/etc/master.passwd</filename> would look
something like this (except it would be all on one
line):</para>
something like this:</para>
<programlisting>Shelmerg:password:1964:89::0:0:Guy Helmer - SLIP:/usr/users/Shelmerg:/usr/sbin/sliplogin</programlisting>
@ -2342,7 +2373,7 @@ silvia.HIP.Berke localhost.Berkeley UGH 34 47641234 lo0 - 0.438
<filename>/etc/sliphome/slip.login</filename> will issue an
<command>ifconfig</command> for the SLIP interface to which
<command>sliplogin</command> attached itself (slip interface
0,in the above example, which was the first parameter in the
0, in the above example, which was the first parameter in the
list given to <filename>slip.login</filename>) to set the
local IP address (<hostid>dc-slip</hostid>), remote IP address
(<hostid>sl-helmer</hostid>), network mask for the SLIP
@ -2350,11 +2381,12 @@ silvia.HIP.Berke localhost.Berkeley UGH 34 47641234 lo0 - 0.438
any additional flags (<literal>autocomp</literal>). If
something goes wrong, <command>sliplogin</command> usually
logs good informational messages via the
<literal>daemon</literal> syslog facility, which usually goes
into <filename>/var/log/messages</filename> (see the manual
<literal>daemon</literal> syslog facility, which usually logs
to <filename>/var/log/messages</filename> (see the manual
pages for &man.syslogd.8; and &man.syslog.conf.5; and perhaps
check <filename>/etc/syslog.conf</filename> to see to which
files <command>syslogd</command> is logging).</para>
check <filename>/etc/syslog.conf</filename> to see to what
<command>syslogd</command> is logging and where it is
logging to.</para>
<para>OK, enough of the examples &mdash; let us dive into
setting up the system.</para>
@ -2381,19 +2413,20 @@ sl0* 296 &lt;Link&gt; 0 0 0 0
sl1* 296 &lt;Link&gt; 0 0 0 0 0</screen>
<para>The <devicename>sl0</devicename> and
<devicename>sl1</devicename> interfaces shown in
<command>netstat -i</command>'s output indicate that there are
<devicename>sl1</devicename> interfaces shown from
<command>netstat -i</command> indicate that there are
two SLIP interfaces built into the kernel. (The asterisks after
the <literal>sl0</literal> and <literal>sl1</literal> indicate
that the interfaces are <quote>down</quote>.)</para>
<para>However, FreeBSD's default kernels do not come configured
to forward packets (ie, your FreeBSD machine will not act as a
<para>However, FreeBSD's default kernel does not come configured
to forward packets (by default, your FreeBSD machine will not act
as a
router) due to Internet RFC requirements for Internet hosts (see
RFCs 1009 [Requirements for Internet Gateways], 1122
[Requirements for Internet Hosts &mdash; Communication Layers],
and perhaps 1127 [A Perspective on the Host Requirements RFCs]),
so if you want your FreeBSD SLIP Server to act as a router, you
and perhaps 1127 [A Perspective on the Host Requirements RFCs]).
If you want your FreeBSD SLIP Server to act as a router, you
will have to edit the <filename>/etc/rc.conf</filename> file and
change the setting of the <literal>gateway_enable</literal> variable to
<option>YES</option>.</para>
@ -2413,9 +2446,9 @@ sl1* 296 &lt;Link&gt; 0 0 0 0
the maximum number of SLIP connections that may be operating
simultaneously.</para>
<para>Please refer to <link linkend="kernelconfig">Configuring the
FreeBSD Kernel</link> for help in reconfiguring your
kernel.</para>
<para>Please refer to <xref linkend="kernelconfig"> on
Configuring the FreeBSD Kernel for help in
reconfiguring your kernel.</para>
</sect3>
<sect3>
@ -2437,7 +2470,7 @@ sl1* 296 &lt;Link&gt; 0 0 0 0
<title><filename>slip.hosts</filename> Configuration</title>
<para><filename>/etc/sliphome/slip.hosts</filename> contains
lines which have at least four items, separated by
lines which have at least four items separated by
whitespace:</para>
<itemizedlist>
@ -2500,24 +2533,16 @@ Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting
</listitem>
</itemizedlist>
<para>Note that <command>sliplogin</command> under early releases
of FreeBSD 2 ignored the options that FreeBSD 1.x recognized,
so the options <option>normal</option>,
<option>compress</option>, <option>autocomp</option>, and
<option>noicmp</option> had no effect until support was added
in FreeBSD 2.2 (unless your <filename>slip.login</filename>
script included code to make use of the flags).</para>
<indexterm><primary>SLIP</primary></indexterm>
<indexterm><primary>TCP/IP networking</primary></indexterm>
<para>Your choice of local and remote addresses for your SLIP
links depends on whether you are going to dedicate a TCP/IP
subnet or if you are going to use <quote>proxy ARP</quote> on
your SLIP server (it is not <quote>true</quote> proxy ARP, but
that is the terminology used in this document to describe it).
that is the terminology used in this section to describe it).
If you are not sure which method to select or how to assign IP
addresses, please refer to the TCP/IP books referenced in the
<link linkend="slips-prereqs">slips-prereqs</link> section
addresses, please refer to the TCP/IP books referenced in
the SLIP Prerequisites (<xref linkend="slips-prereqs">)
and/or consult your IP network manager.</para>
<indexterm>
@ -2563,8 +2588,8 @@ Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting
#
/sbin/ifconfig sl$1 inet $4 $5 netmask $6</programlisting>
<para>This <filename>slip.login</filename> file merely
<command>ifconfig</command>'s the appropriate SLIP interface
<para>This <filename>slip.login</filename> file merely runs
<command>ifconfig</command> for the appropriate SLIP interface
with the local and remote addresses and network mask of the
SLIP interface.</para>
@ -2592,7 +2617,7 @@ Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting
&#36;5 00:11:22:33:44:55 pub</command>, creates an ARP entry
in the SLIP server's ARP table. This ARP entry causes the
SLIP server to respond with the SLIP server's Ethernet MAC
address whenever a another IP node on the Ethernet asks to
address whenever another IP node on the Ethernet asks to
speak to the SLIP client's IP address.</para>
<indexterm><primary>Ethernet</primary><secondary>MAC address</secondary></indexterm>
@ -2620,7 +2645,7 @@ Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting
<para>When you create
<filename>/etc/sliphome/slip.login</filename> and
<filename>/etc/sliphome/slip.logout</filename>, the
<quote>execute</quote> bit (ie, <command>chmod 755
<quote>execute</quote> bit (<command>chmod 755
/etc/sliphome/slip.login /etc/sliphome/slip.logout</command>)
must be set, or <command>sliplogin</command> will be unable
to execute it.</para>
@ -2673,7 +2698,7 @@ Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting
<para>It bears repeating: make sure
<filename>/etc/sliphome/slip.logout</filename> has the execute
bit set for after you create it (ie, <command>chmod 755
bit set after you create it (ie, <command>chmod 755
/etc/sliphome/slip.logout</command>).</para>
</sect4>
</sect3>
@ -2697,7 +2722,7 @@ Shelmerg dc-slip sl-helmerg 0xfffffc00 autocomp</programlisting
<title>Static Routes</title>
<indexterm><primary>static routes</primary></indexterm>
<para>Adding static routes to your nearest default routers can
be troublesome (or impossible, if you do not have authority to
be troublesome (or impossible if you do not have authority to
do so...). If you have a multiple-router network in your
organization, some routers, such as those made by Cisco and Proteon, may
not only need to be configured with the static route to the