mirror of https://github.com/tLDP/LDP
Editing of new "Linux-Networking" guide. This copy is not to be distributed. Its just a draft to give people an idea as to the format of the new document and a backup just in case my laptop dies.
Binh.
This commit is contained in:
parent
7839c0b306
commit
a8d1c1809b
|
@ -375,6 +375,6 @@ connection issue. The administrator can proceed in one of either two ways.
|
||||||
He can move upwards through the hierarchy or downwards, either way he is
|
He can move upwards through the hierarchy or downwards, either way he is
|
||||||
eliminating possible issues at each point which therefore reduces the
|
eliminating possible issues at each point which therefore reduces the
|
||||||
possible number of problems at each point. The purpose of each layer will
|
possible number of problems at each point. The purpose of each layer will
|
||||||
be explained below.
|
be explained in the sections on the TCP/IP and OSI networking models.
|
||||||
|
|
||||||
</sect1>
|
</sect1>
|
||||||
|
|
|
@ -1,4 +1,5 @@
|
||||||
<glossary id="Glossary">
|
<glossary id="Glossary">
|
||||||
|
|
||||||
<title>Glossary</title>
|
<title>Glossary</title>
|
||||||
|
|
||||||
ARPA
|
ARPA
|
||||||
|
|
|
@ -2,491 +2,486 @@
|
||||||
|
|
||||||
<title>Leased-Line</title>
|
<title>Leased-Line</title>
|
||||||
|
|
||||||
|
_______________________________________________________________________________
|
||||||
|
<sect>
|
||||||
|
<para>
|
||||||
|
Configuring your modem and pppd to use a 2 wire twisted pair leased
|
||||||
|
line.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
1.2. What is a leased line
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Any fixed, that is permanent, point to point data communications link,
|
||||||
|
which is leased from a telco or similar organisation. The leased line
|
||||||
|
involves cables, such as twisted pair, coax or fiber optic, and may
|
||||||
|
involve all sorts of other hardware such as (pupin) coils,
|
||||||
|
transformers, amplifiers and regenerators.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
This document deals with:
|
||||||
|
Configuring your modem and pppd to use a 2 wire twisted pair
|
||||||
|
leased line.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
This document does NOT deal with:
|
||||||
|
SLIP, getting or installing pppd, synchronous data
|
||||||
|
communication, baseband modems, xDSL.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
1.3. Assumptions
|
||||||
|
|
||||||
|
<para>
|
||||||
|
You should already have a working pppd on your system. You also need
|
||||||
|
Minicom or a similar program to configure your modems.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
2. Modem
|
||||||
|
|
||||||
|
<para>
|
||||||
|
A leased line is not connected to a telephone exchange and does not
|
||||||
|
provide DC power, dial tone, busy tone or ring signal. This means that
|
||||||
|
your modems are on their own and have to be able to deal with this
|
||||||
|
situation.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
You should have 2 identical (including firmware version) external
|
||||||
|
modems supporting both leased line and dumb mode. Make sure your
|
||||||
|
modems can actually do this! Also make sure your modem is properly
|
||||||
|
documented. You also need:
|
||||||
|
</para>
|
||||||
|
|
||||||
|
· 2 fully wired shielded RS232 cables. The shield should be connected
|
||||||
|
to the connector shell (not pin 1) at both ends (not at one end).
|
||||||
|
· A RS232 test plug may be handy for test purposes.
|
||||||
|
· 2 RJ11 cords, one for each end of the leased line.
|
||||||
|
· A basic understanding of `AT' commands.
|
||||||
|
|
||||||
|
2.1. Modem Configuration
|
||||||
|
|
||||||
|
<para>
|
||||||
|
A note on modem configuration and init strings in general: Configure
|
||||||
|
your modem software such as minicom or (m)getty to use the highest
|
||||||
|
possible speed; 57600 bps for 14k4 and 115200 bps for 28k8 or faster
|
||||||
|
modems. Lots of people use very long and complicated init strings,
|
||||||
|
often starting with AT&F and containing lots of modem brand and -type
|
||||||
|
specific commands. This however is needlessly complicated. Most
|
||||||
|
programs feel happy with the same modem settings, so why not write
|
||||||
|
these settings in the non volatile memory of all your modems, and only
|
||||||
|
use `ATZ' as an init string in all your programs. This way you can
|
||||||
|
swap or upgrade your modems without ever having to reconfigure any of
|
||||||
|
your software.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Most programs require you to use the following settings;
|
||||||
|
</para>
|
||||||
|
|
||||||
|
· Fixed baud rate (no auto baud)
|
||||||
|
· Hardware bidirectional RTS-CTS flow control (no x-on/x-off)
|
||||||
|
· 8 Bits, no parity, 1 stopbit
|
||||||
|
· The modem should produce the TRUE DCD status (&C1)
|
||||||
|
· The modem should NOT ignore the DTR status (&D2 or &D3)
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Check this with AT&V or AT&Ix (consult your modem documentation)
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
These settings are not necessarily the same as the default factory
|
||||||
|
profile (&F), so starting an init string with AT&F is probably not a
|
||||||
|
good idea in the first place. The smart thing to do is probably to use
|
||||||
|
AT&F only when you have reason to believe that the modem setup stored
|
||||||
|
in the non volatile memory is really screwed up. If you think you
|
||||||
|
have found the right setup for your modems, write it to non volatile
|
||||||
|
memory with AT&W and test it thoroughly with Z-modem file transfers of
|
||||||
|
both ASCII text and binary files. Only if all of this works perfectly
|
||||||
|
should you configure your modems for leased line.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Find out how to put your modem into dumb mode and, more importantly,
|
||||||
|
how to get it out of dumb mode; The modem can only be reconfigured
|
||||||
|
when it is not in dumb mode. Make sure you actually configure your
|
||||||
|
modems at the highest possible speed. Once in dumb mode it will
|
||||||
|
ignore all `AT' commands and consequently will not adjust its speed to
|
||||||
|
that of the COM port, but will use the speed at which it was
|
||||||
|
configured instead (this speed is stored in a S-register by the AT&W
|
||||||
|
command).
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Now configure your modem as follows;
|
||||||
|
</para>
|
||||||
|
|
||||||
|
· Reset on DTR toggle (&D3, this is sometimes a S register). This
|
||||||
|
setting is required by some ISP's!
|
||||||
|
· Leased line mode (&L1 or &L2, consult your modem documentation)
|
||||||
|
· The remote modem auto answer (S0=1), the local originate (S0=0)
|
||||||
|
· Disable result codes (Q1, sometimes the dumb mode does this for
|
||||||
|
you)
|
||||||
|
· Dumb mode (\D1 or %D1, this is sometimes a jumper) In dumb mode the
|
||||||
|
modem will ignore all AT commands (sometimes you need to disable
|
||||||
|
the ESC char as well).
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Write the configuration to non-volatile memory (&W).
|
||||||
|
</para>
|
||||||
|
|
||||||
|
2.2. Test
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Now connect the modems to 2 computers using the RS232 cables and
|
||||||
|
connect the modems to each other using a RJ11 lead. Use a modem
|
||||||
|
program such as Minicom (Linux), procom or telix (DOS) on both
|
||||||
|
computers to test the modems. You should be able to type text from
|
||||||
|
one computer to the other and vice versa. If the screen produces
|
||||||
|
garbage check your COM port speed and other settings. Now disconnect
|
||||||
|
and reconnect the RJ11 cord. Wait for the connection to reestablish
|
||||||
|
itself. Disconnect and reconnect the RS232 cables, switch the modems
|
||||||
|
on and off, stop and restart Minicom. The modems should always
|
||||||
|
reconnect at the highest possible speed (some modems have speed
|
||||||
|
indicator leds). Check whether the modems actually ignores the ESC
|
||||||
|
(+++) character. If necessary disable the ESC character.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
If all of this works you may want to reconfigure your modems; Switch
|
||||||
|
off the sound at the remote modem (M0) and put the local modem at low
|
||||||
|
volume (L1).
|
||||||
|
</para>
|
||||||
|
|
||||||
|
2.3. Examples
|
||||||
|
|
||||||
|
2.3.1. Hi-Tech
|
||||||
|
|
||||||
|
<para>
|
||||||
|
This is a rather vague `no name clone modem'. Its config string is
|
||||||
|
however typical and should work on most modems.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Originate (local):
|
||||||
|
ATL1&C1&D3&L2%D1&W&W1
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Answer (remote):
|
||||||
|
ATM0L1&C1&D3&L2%D1S0=1&W&W1
|
||||||
|
</para>
|
||||||
|
|
||||||
|
2.3.2. Tornado FM 228 E
|
||||||
|
|
||||||
|
<para>
|
||||||
|
This is what should work;
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Originate (local):
|
||||||
|
ATB15L1Q1&C1&D3&L2&W&W1
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Answer (remote):
|
||||||
|
ATM0B15M0Q1&C1&D3&L2S0=1&W&W1
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Move the dumb jumper from position 2-3 to 1-2.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Due to a firmware bug, the modems will only connect after being hard
|
||||||
|
reset (power off and on) while DTR is high. I designed a circuit which
|
||||||
|
hard resets the modem on the low to high transition of DTR. The
|
||||||
|
FreeBSD pppd however, isn't very happy about this. By combining the
|
||||||
|
setting &D0 with a circuit which resets on the high to low transition
|
||||||
|
instead, this problem can be avoided.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
2.3.3. Tron DF
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The ESC char should be disabled by setting S2 > 127;
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Originate:
|
||||||
|
ATL1&L1Q1&C1&D3S2=171\D1&W
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Answer:
|
||||||
|
ATM0&L2Q1&C1&D3S0=1S2=171\D1&W
|
||||||
|
</para>
|
||||||
|
|
||||||
|
2.3.4. US Robotics Courier V-Everything
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The USR Sportster and USR Courier-I do not support leased line. You
|
||||||
|
need the Courier V-everything version for this job. There is a
|
||||||
|
webpage on the USR site `explaining' how to set-up your Courier for
|
||||||
|
leased line. However, if you follow these instructions you will end up
|
||||||
|
with a completely brain dead modem, which can not be controlled or
|
||||||
|
monitored by your pppd.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The USR Courier can be configured with dip switches, however you need
|
||||||
|
to feed it the config string first. First make sure it uses the right
|
||||||
|
factory profile. Unlike most other modems it has three; &F0, &F1 and
|
||||||
|
&F2. The default, which is also the one you should use, is &F1. If you
|
||||||
|
send it an AT&F, however it will load the factory profile &F0! For
|
||||||
|
the reset on DTR toggle you set bit 0 of S register 13. This means you
|
||||||
|
have to set S13 to 1. Furthermore you need set it to leased line mode
|
||||||
|
with &L1; ATS13=1&L1&W The dip switches are all default except for the
|
||||||
|
following:
|
||||||
<para>
|
<para>
|
||||||
|
|
||||||
Leased line Mini HOWTO
|
<para>
|
||||||
|
3 OFF Disable result codes
|
||||||
Configuring your modem and pppd to use a 2 wire twisted pair leased
|
4 ON Disable offline commands
|
||||||
line.
|
5 ON For originate, OFF For answer
|
||||||
______________________________________________________________________
|
8 OFF Dumb mode
|
||||||
|
</para>
|
||||||
Table of Contents
|
|
||||||
|
3. PPPD
|
||||||
|
|
||||||
1. Introduction
|
<para>
|
||||||
|
You need a pppd (Point to Point Protocol Daemon) and a reasonable
|
||||||
1.1 Copyright and License
|
knowledge of how it works. Consult the relevant RFC's or the Linux PPP
|
||||||
1.2 What is a leased line
|
HOWTO if necessary. Since you are not going to use a login procedure,
|
||||||
1.3 Assumptions
|
you don't use (m)getty and you do not need a (fake) user associated
|
||||||
|
with the pppd controlling your link. You are not going to dial so you
|
||||||
2. Modem
|
don't need any chat scripts either. In fact, the modem circuit and
|
||||||
|
configuration you have just build, are rather like a fully wired null
|
||||||
2.1 Modem Configuration
|
modem cable. This means you have to configure your pppd the same way
|
||||||
2.2 Test
|
as you would with a null modem cable.
|
||||||
2.3 Examples
|
</para>
|
||||||
2.3.1 Hi-Tech
|
|
||||||
2.3.2 Tornado FM 228 E
|
<para>
|
||||||
2.3.3 Tron DF
|
For a reliable link, your setup should meet the following criteria;
|
||||||
2.3.4 US Robotics Courier V-Everything
|
</para>
|
||||||
|
|
||||||
3. PPPD
|
· Shortly after booting your system, pppd should raise the DTR signal
|
||||||
|
in your RS232 port, wait for DCD to go up, and negotiate the link.
|
||||||
3.1 Configuration
|
· If the remote system is down, pppd should wait until it is up
|
||||||
3.2 Scripts
|
again.
|
||||||
3.2.1 Starting the pppd and keeping it alive
|
· If the link is up and then goes down, pppd should reset the modem
|
||||||
3.2.2 Setting the routes
|
(it does this by dropping and then raising DTR), and then try to
|
||||||
3.3 Test
|
reconnect.
|
||||||
|
· If the quality of the link deteriorates too much, pppd should reset
|
||||||
|
the modem and then reestablish the link.
|
||||||
______________________________________________________________________
|
· If the process controlling the link, that is the pppd, dies, a
|
||||||
|
watchdog should restart the pppd.
|
||||||
The most recent (beta) version of this HOWTO can be found at:
|
|
||||||
http://www.sput.nl/software/leased-line/
|
3.1. Configuration
|
||||||
|
|
||||||
|
<para>
|
||||||
1. Introduction
|
Suppose the modem is connected to COM2, the local IP address is
|
||||||
|
`Loc_Ip' and the remote IP address is `Rem_Ip'. We want to use 576 as
|
||||||
1.1. Copyright and License
|
our MTU. The /etc/ppp/options.ttyS1 would now be:
|
||||||
|
</para>
|
||||||
This document is distributed under the terms of the GNU Free
|
|
||||||
Documentation License. You should have received a copy along with it.
|
<para>
|
||||||
If not, it is available from http://www.fsf.org/licenses/fdl.html.
|
<screen>
|
||||||
|
crtscts
|
||||||
1.2. What is a leased line
|
mru 576
|
||||||
|
mtu 576
|
||||||
Any fixed, that is permanent, point to point data communications link,
|
passive
|
||||||
which is leased from a telco or similar organisation. The leased line
|
Loc_Ip:Rem_Ip
|
||||||
involves cables, such as twisted pair, coax or fiber optic, and may
|
-chap
|
||||||
involve all sorts of other hardware such as (pupin) coils,
|
modem
|
||||||
transformers, amplifiers and regenerators.
|
#noauth
|
||||||
|
-pap
|
||||||
|
persist
|
||||||
|
</screen>
|
||||||
This document deals with:
|
</para>
|
||||||
Configuring your modem and pppd to use a 2 wire twisted pair
|
|
||||||
leased line.
|
<para>
|
||||||
|
Stuff like `asyncmap 0', `lock', `modem' and `-detach' are probably
|
||||||
|
already in /etc/ppp/options. If not, add them to your
|
||||||
|
/etc/ppp/options.ttyS1. So, if the local system is 192.168.1.1 and
|
||||||
This document does NOT deal with:
|
the remote system is 10.1.1.1, then /etc/ppp/options.ttyS1 on the
|
||||||
SLIP, getting or installing pppd, synchronous data
|
local system would be:
|
||||||
communication, baseband modems, xDSL.
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
1.3. Assumptions
|
<screen>
|
||||||
|
crtscts
|
||||||
You should already have a working pppd on your system. You also need
|
mru 576
|
||||||
Minicom or a similar program to configure your modems.
|
mtu 576
|
||||||
|
passive
|
||||||
2. Modem
|
192.168.1.1:10.1.1.1
|
||||||
|
-chap
|
||||||
A leased line is not connected to a telephone exchange and does not
|
modem
|
||||||
provide DC power, dial tone, busy tone or ring signal. This means that
|
#noauth
|
||||||
your modems are on their own and have to be able to deal with this
|
-pap
|
||||||
situation.
|
persist
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
You should have 2 identical (including firmware version) external
|
|
||||||
modems supporting both leased line and dumb mode. Make sure your
|
<para>
|
||||||
modems can actually do this! Also make sure your modem is properly
|
The options.ttyS1 on the remote system would be:
|
||||||
documented. You also need:
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
· 2 fully wired shielded RS232 cables. The shield should be connected
|
<screen>
|
||||||
to the connector shell (not pin 1) at both ends (not at one end).
|
crtscts
|
||||||
|
mru 576
|
||||||
· A RS232 test plug may be handy for test purposes.
|
mtu 576
|
||||||
|
passive
|
||||||
· 2 RJ11 cords, one for each end of the leased line.
|
10.1.1.1:192.168.1.1
|
||||||
|
-chap
|
||||||
· A basic understanding of `AT' commands.
|
modem
|
||||||
|
#noauth
|
||||||
|
-pap
|
||||||
2.1. Modem Configuration
|
persist
|
||||||
|
</screen>
|
||||||
A note on modem configuration and init strings in general: Configure
|
</para>
|
||||||
your modem software such as minicom or (m)getty to use the highest
|
|
||||||
possible speed; 57600 bps for 14k4 and 115200 bps for 28k8 or faster
|
<para>
|
||||||
modems. Lots of people use very long and complicated init strings,
|
The passive option limits the number of (re)connection attempts. The
|
||||||
often starting with AT&F and containing lots of modem brand and -type
|
persist option will keep pppd alive in case of a disconnect or when it
|
||||||
specific commands. This however is needlessly complicated. Most
|
can't connect in the first place. If you telnet a lot while doing
|
||||||
programs feel happy with the same modem settings, so why not write
|
filetransfers (FTP or webbrowsing) at the same time, you might want to
|
||||||
these settings in the non volatile memory of all your modems, and only
|
use a smaller MTU and MRU such as 296. This will make the remote sys
|
||||||
use `ATZ' as an init string in all your programs. This way you can
|
tem more responsive. If you don't care much about telnetting during
|
||||||
swap or upgrade your modems without ever having to reconfigure any of
|
FTP, you could set the MTU and MRU to 1500. Keep in mind though, that
|
||||||
your software.
|
UDP cannot be fragmented. Speakfreely for instance uses 512 byte UDP
|
||||||
|
packets. So the minimum MTU for speakfreely is 552 bytes. The noauth
|
||||||
|
option may be necessary with some newer distributions.
|
||||||
Most programs require you to use the following settings;
|
</para>
|
||||||
|
|
||||||
|
3.2. Scripts
|
||||||
· Fixed baud rate (no auto baud)
|
|
||||||
|
3.2.1. Starting the pppd and keeping it alive
|
||||||
· Hardware bidirectional RTS-CTS flow control (no x-on/x-off)
|
|
||||||
|
<para>
|
||||||
· 8 Bits, no parity, 1 stopbit
|
You could start the pppd form a boot (rc) script. However, if you do
|
||||||
|
this, and the pppd dies, you are without a link. A more stable
|
||||||
· The modem should produce the TRUE DCD status (&C1)
|
solution, is to start the pppd from /etc/inittab;
|
||||||
|
</para>
|
||||||
· The modem should NOT ignore the DTR status (&D2 or &D3)
|
|
||||||
|
<para>
|
||||||
|
<screen>
|
||||||
Check this with AT&V or AT&Ix (consult your modem documentation)
|
s1:23:respawn:/usr/sbin/pppd /dev/ttyS1 115200
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
These settings are not necessarily the same as the default factory
|
|
||||||
profile (&F), so starting an init string with AT&F is probably not a
|
<para>
|
||||||
good idea in the first place. The smart thing to do is probably to use
|
This way, the pppd will be restarted if it dies. Make sure you have a
|
||||||
AT&F only when you have reason to believe that the modem setup stored
|
`-detach' option (nodetach on newer systems) though, otherwise inittab
|
||||||
in the non volatile memory is really screwed up. If you think you
|
will start numerous instances of pppd, will complaining about
|
||||||
have found the right setup for your modems, write it to non volatile
|
`respawning too fast'.
|
||||||
memory with AT&W and test it thoroughly with Z-modem file transfers of
|
</para>
|
||||||
both ASCII text and binary files. Only if all of this works perfectly
|
|
||||||
should you configure your modems for leased line.
|
<para>
|
||||||
|
Note: Some older systems will not accept the speed `115200'. In this
|
||||||
|
case you will have to set the speed to 38400 en set the `spd_vhi' flag
|
||||||
Find out how to put your modem into dumb mode and, more importantly,
|
with setserial. Some systems expect you to use a `cua' instead of
|
||||||
how to get it out of dumb mode; The modem can only be reconfigured
|
`ttyS' device.
|
||||||
when it is not in dumb mode. Make sure you actually configure your
|
</para>
|
||||||
modems at the highest possible speed. Once in dumb mode it will
|
|
||||||
ignore all `AT' commands and consequently will not adjust its speed to
|
3.2.2. Setting the routes
|
||||||
that of the COM port, but will use the speed at which it was
|
|
||||||
configured instead (this speed is stored in a S-register by the AT&W
|
<para>
|
||||||
command).
|
The default route can be set with the defaultroute option or with the
|
||||||
|
/etc/ppp/ip-up script;
|
||||||
|
</para>
|
||||||
Now configure your modem as follows;
|
|
||||||
|
<para>
|
||||||
|
<screen>
|
||||||
· Reset on DTR toggle (&D3, this is sometimes a S register). This
|
#!/bin/bash
|
||||||
setting is required by some ISP's!
|
case $2 in
|
||||||
|
|
||||||
· Leased line mode (&L1 or &L2, consult your modem documentation)
|
|
||||||
|
|
||||||
· The remote modem auto answer (S0=1), the local originate (S0=0)
|
|
||||||
|
|
||||||
· Disable result codes (Q1, sometimes the dumb mode does this for
|
|
||||||
you)
|
|
||||||
|
|
||||||
· Dumb mode (\D1 or %D1, this is sometimes a jumper) In dumb mode the
|
|
||||||
modem will ignore all AT commands (sometimes you need to disable
|
|
||||||
the ESC char as well).
|
|
||||||
|
|
||||||
|
|
||||||
Write the configuration to non-volatile memory (&W).
|
|
||||||
|
|
||||||
2.2. Test
|
|
||||||
|
|
||||||
Now connect the modems to 2 computers using the RS232 cables and
|
|
||||||
connect the modems to each other using a RJ11 lead. Use a modem
|
|
||||||
program such as Minicom (Linux), procom or telix (DOS) on both
|
|
||||||
computers to test the modems. You should be able to type text from
|
|
||||||
one computer to the other and vice versa. If the screen produces
|
|
||||||
garbage check your COM port speed and other settings. Now disconnect
|
|
||||||
and reconnect the RJ11 cord. Wait for the connection to reestablish
|
|
||||||
itself. Disconnect and reconnect the RS232 cables, switch the modems
|
|
||||||
on and off, stop and restart Minicom. The modems should always
|
|
||||||
reconnect at the highest possible speed (some modems have speed
|
|
||||||
indicator leds). Check whether the modems actually ignores the ESC
|
|
||||||
(+++) character. If necessary disable the ESC character.
|
|
||||||
|
|
||||||
|
|
||||||
If all of this works you may want to reconfigure your modems; Switch
|
|
||||||
off the sound at the remote modem (M0) and put the local modem at low
|
|
||||||
volume (L1).
|
|
||||||
|
|
||||||
2.3. Examples
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
2.3.1. Hi-Tech
|
|
||||||
|
|
||||||
This is a rather vague `no name clone modem'. Its config string is
|
|
||||||
however typical and should work on most modems.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Originate (local):
|
|
||||||
ATL1&C1&D3&L2%D1&W&W1
|
|
||||||
|
|
||||||
|
|
||||||
Answer (remote):
|
|
||||||
ATM0L1&C1&D3&L2%D1S0=1&W&W1
|
|
||||||
|
|
||||||
|
|
||||||
2.3.2. Tornado FM 228 E
|
|
||||||
|
|
||||||
This is what should work;
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Originate (local):
|
|
||||||
ATB15L1Q1&C1&D3&L2&W&W1
|
|
||||||
|
|
||||||
|
|
||||||
Answer (remote):
|
|
||||||
ATM0B15M0Q1&C1&D3&L2S0=1&W&W1
|
|
||||||
|
|
||||||
|
|
||||||
Move the dumb jumper from position 2-3 to 1-2.
|
|
||||||
|
|
||||||
|
|
||||||
Due to a firmware bug, the modems will only connect after being hard
|
|
||||||
reset (power off and on) while DTR is high. I designed a circuit which
|
|
||||||
hard resets the modem on the low to high transition of DTR. The
|
|
||||||
FreeBSD pppd however, isn't very happy about this. By combining the
|
|
||||||
setting &D0 with a circuit which resets on the high to low transition
|
|
||||||
instead, this problem can be avoided.
|
|
||||||
|
|
||||||
2.3.3. Tron DF
|
|
||||||
|
|
||||||
The ESC char should be disabled by setting S2 > 127;
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Originate:
|
|
||||||
ATL1&L1Q1&C1&D3S2=171\D1&W
|
|
||||||
|
|
||||||
|
|
||||||
Answer:
|
|
||||||
ATM0&L2Q1&C1&D3S0=1S2=171\D1&W
|
|
||||||
|
|
||||||
|
|
||||||
2.3.4. US Robotics Courier V-Everything
|
|
||||||
|
|
||||||
The USR Sportster and USR Courier-I do not support leased line. You
|
|
||||||
need the Courier V-everything version for this job. There is a
|
|
||||||
webpage on the USR site `explaining' how to set-up your Courier for
|
|
||||||
leased line. However, if you follow these instructions you will end up
|
|
||||||
with a completely brain dead modem, which can not be controlled or
|
|
||||||
monitored by your pppd.
|
|
||||||
|
|
||||||
|
|
||||||
The USR Courier can be configured with dip switches, however you need
|
|
||||||
to feed it the config string first. First make sure it uses the right
|
|
||||||
factory profile. Unlike most other modems it has three; &F0, &F1 and
|
|
||||||
&F2. The default, which is also the one you should use, is &F1. If you
|
|
||||||
send it an AT&F, however it will load the factory profile &F0! For
|
|
||||||
the reset on DTR toggle you set bit 0 of S register 13. This means you
|
|
||||||
have to set S13 to 1. Furthermore you need set it to leased line mode
|
|
||||||
with &L1; ATS13=1&L1&W The dip switches are all default except for the
|
|
||||||
following:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
3 OFF Disable result codes
|
|
||||||
|
|
||||||
|
|
||||||
4 ON Disable offline commands
|
|
||||||
|
|
||||||
|
|
||||||
5 ON For originate, OFF For answer
|
|
||||||
|
|
||||||
|
|
||||||
8 OFF Dumb mode
|
|
||||||
|
|
||||||
|
|
||||||
3. PPPD
|
|
||||||
|
|
||||||
You need a pppd (Point to Point Protocol Daemon) and a reasonable
|
|
||||||
knowledge of how it works. Consult the relevant RFC's or the Linux PPP
|
|
||||||
HOWTO if necessary. Since you are not going to use a login procedure,
|
|
||||||
you don't use (m)getty and you do not need a (fake) user associated
|
|
||||||
with the pppd controlling your link. You are not going to dial so you
|
|
||||||
don't need any chat scripts either. In fact, the modem circuit and
|
|
||||||
configuration you have just build, are rather like a fully wired null
|
|
||||||
modem cable. This means you have to configure your pppd the same way
|
|
||||||
as you would with a null modem cable.
|
|
||||||
|
|
||||||
|
|
||||||
For a reliable link, your setup should meet the following criteria;
|
|
||||||
|
|
||||||
|
|
||||||
· Shortly after booting your system, pppd should raise the DTR signal
|
|
||||||
in your RS232 port, wait for DCD to go up, and negotiate the link.
|
|
||||||
|
|
||||||
· If the remote system is down, pppd should wait until it is up
|
|
||||||
again.
|
|
||||||
|
|
||||||
· If the link is up and then goes down, pppd should reset the modem
|
|
||||||
(it does this by dropping and then raising DTR), and then try to
|
|
||||||
reconnect.
|
|
||||||
|
|
||||||
· If the quality of the link deteriorates too much, pppd should reset
|
|
||||||
the modem and then reestablish the link.
|
|
||||||
|
|
||||||
· If the process controlling the link, that is the pppd, dies, a
|
|
||||||
watchdog should restart the pppd.
|
|
||||||
|
|
||||||
|
|
||||||
3.1. Configuration
|
|
||||||
|
|
||||||
Suppose the modem is connected to COM2, the local IP address is
|
|
||||||
`Loc_Ip' and the remote IP address is `Rem_Ip'. We want to use 576 as
|
|
||||||
our MTU. The /etc/ppp/options.ttyS1 would now be:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
crtscts
|
|
||||||
mru 576
|
|
||||||
mtu 576
|
|
||||||
passive
|
|
||||||
Loc_Ip:Rem_Ip
|
|
||||||
-chap
|
|
||||||
modem
|
|
||||||
#noauth
|
|
||||||
-pap
|
|
||||||
persist
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Stuff like `asyncmap 0', `lock', `modem' and `-detach' are probably
|
|
||||||
already in /etc/ppp/options. If not, add them to your
|
|
||||||
/etc/ppp/options.ttyS1. So, if the local system is 192.168.1.1 and
|
|
||||||
the remote system is 10.1.1.1, then /etc/ppp/options.ttyS1 on the
|
|
||||||
local system would be:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
crtscts
|
|
||||||
mru 576
|
|
||||||
mtu 576
|
|
||||||
passive
|
|
||||||
192.168.1.1:10.1.1.1
|
|
||||||
-chap
|
|
||||||
modem
|
|
||||||
#noauth
|
|
||||||
-pap
|
|
||||||
persist
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The options.ttyS1 on the remote system would be:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
crtscts
|
|
||||||
mru 576
|
|
||||||
mtu 576
|
|
||||||
passive
|
|
||||||
10.1.1.1:192.168.1.1
|
|
||||||
-chap
|
|
||||||
modem
|
|
||||||
#noauth
|
|
||||||
-pap
|
|
||||||
persist
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The passive option limits the number of (re)connection attempts. The
|
|
||||||
persist option will keep pppd alive in case of a disconnect or when it
|
|
||||||
can't connect in the first place. If you telnet a lot while doing
|
|
||||||
filetransfers (FTP or webbrowsing) at the same time, you might want to
|
|
||||||
use a smaller MTU and MRU such as 296. This will make the remote sys
|
|
||||||
tem more responsive. If you don't care much about telnetting during
|
|
||||||
FTP, you could set the MTU and MRU to 1500. Keep in mind though, that
|
|
||||||
UDP cannot be fragmented. Speakfreely for instance uses 512 byte UDP
|
|
||||||
packets. So the minimum MTU for speakfreely is 552 bytes. The noauth
|
|
||||||
option may be necessary with some newer distributions.
|
|
||||||
|
|
||||||
3.2. Scripts
|
|
||||||
|
|
||||||
3.2.1. Starting the pppd and keeping it alive
|
|
||||||
|
|
||||||
You could start the pppd form a boot (rc) script. However, if you do
|
|
||||||
this, and the pppd dies, you are without a link. A more stable
|
|
||||||
solution, is to start the pppd from /etc/inittab;
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
s1:23:respawn:/usr/sbin/pppd /dev/ttyS1 115200
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
This way, the pppd will be restarted if it dies. Make sure you have a
|
|
||||||
`-detach' option (nodetach on newer systems) though, otherwise inittab
|
|
||||||
will start numerous instances of pppd, will complaining about
|
|
||||||
`respawning too fast'.
|
|
||||||
|
|
||||||
Note: Some older systems will not accept the speed `115200'. In this
|
|
||||||
case you will have to set the speed to 38400 en set the `spd_vhi' flag
|
|
||||||
with setserial. Some systems expect you to use a `cua' instead of
|
|
||||||
`ttyS' device.
|
|
||||||
|
|
||||||
3.2.2. Setting the routes
|
|
||||||
|
|
||||||
The default route can be set with the defaultroute option or with the
|
|
||||||
/etc/ppp/ip-up script;
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
#!/bin/bash
|
|
||||||
case $2 in
|
|
||||||
/dev/ttyS1)
|
|
||||||
/sbin/route add -net 0.0.0.0 gw Rem_Ip netmask 0.0.0.0
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Ip-up can also be used to sync your clock using netdate.
|
|
||||||
|
|
||||||
|
|
||||||
Of course the route set in ip-up is not necessarily the default route.
|
|
||||||
Your ip-up sets the route to the remote network while the ip-up script
|
|
||||||
on the remote system sets the route to your network. If your network
|
|
||||||
is 192.168.1.0 and your ppp interface 192.168.1.1, the ip-up script on
|
|
||||||
the remote machine looks like this;
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
#!/bin/bash
|
|
||||||
case $2 in
|
|
||||||
/dev/ttyS1)
|
/dev/ttyS1)
|
||||||
/sbin/route add -net 192.168.1.0 gw 192.168.1.1 netmask 255.255.255.0
|
/sbin/route add -net 0.0.0.0 gw Rem_Ip netmask 0.0.0.0
|
||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Ip-up can also be used to sync your clock using netdate.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Of course the route set in ip-up is not necessarily the default route.
|
||||||
|
Your ip-up sets the route to the remote network while the ip-up script
|
||||||
|
on the remote system sets the route to your network. If your network
|
||||||
|
is 192.168.1.0 and your ppp interface 192.168.1.1, the ip-up script on
|
||||||
|
the remote machine looks like this;
|
||||||
|
</para>
|
||||||
|
|
||||||
The `case $2' and `/dev/ttyS1)' bits are there in case you use more
|
<para>
|
||||||
than one ppp link. Ip-up will run each time a link comes up, but only
|
<screen>
|
||||||
the part between `/dev/ttySx)' and `;;' will be executed, setting the
|
#!/bin/bash
|
||||||
right route for the right ttyS. You can find more about routing in
|
case $2 in
|
||||||
the Linux Networking HOWTO section on routing.
|
/dev/ttyS1)
|
||||||
|
/sbin/route add -net 192.168.1.0 gw 192.168.1.1 netmask 255.255.255.0
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
3.3. Test
|
<para>
|
||||||
|
The `case $2' and `/dev/ttyS1)' bits are there in case you use more
|
||||||
|
than one ppp link. Ip-up will run each time a link comes up, but only
|
||||||
|
the part between `/dev/ttySx)' and `;;' will be executed, setting the
|
||||||
|
right route for the right ttyS. You can find more about routing in
|
||||||
|
the Linux Networking HOWTO section on routing.
|
||||||
|
</para>
|
||||||
|
|
||||||
Test the whole thing just like the modem test. If it works, get on
|
3.3. Test
|
||||||
your bike and bring the remote modem to the remote side of your link.
|
|
||||||
If it doesn't work, one of the things you should check is the COM port
|
<para>
|
||||||
speed; Apparently, a common mistake is to configure the modems with
|
Test the whole thing just like the modem test. If it works, get on
|
||||||
Minicom using one speed and then configure the pppd to use an other.
|
your bike and bring the remote modem to the remote side of your link.
|
||||||
This will NOT work! You have to use the same speed all of the time!
|
If it doesn't work, one of the things you should check is the COM port
|
||||||
|
speed; Apparently, a common mistake is to configure the modems with
|
||||||
|
Minicom using one speed and then configure the pppd to use an other.
|
||||||
|
This will NOT work! You have to use the same speed all of the time!
|
||||||
|
</para>
|
||||||
|
</sect>
|
||||||
|
|
||||||
|
<sect>
|
||||||
|
|
||||||
T1-T4
|
T1-T4
|
||||||
|
<para>
|
||||||
|
A T1 line is a high-speed, dedicated, point-to-point leased line that
|
||||||
|
includes 24 seperate 64 Kbps channles for voice and data. Other lines
|
||||||
|
of this type, called T-carrier lines, support larger numbers of channels.
|
||||||
|
T1 and T3 lines are the most commonly used.
|
||||||
|
</para>
|
||||||
|
|
||||||
A T1 line is a high-speed, dedicated, point-to-point leased line that includes 24 seperate
|
<para>
|
||||||
64 Kbps channles for voice and data. Other lines of this type, called T-carrier lines, support
|
<screen>
|
||||||
larger numbers of channels. T1 and T3 lines are the most commonly used.
|
Carrier Channels Total Bandwidth
|
||||||
|
|
||||||
Carrier Channels Total Bandwidth
|
|
||||||
T1 24 1.544 Mbps
|
T1 24 1.544 Mbps
|
||||||
T2 96 6.312 Mbps
|
T2 96 6.312 Mbps
|
||||||
T3 672 44.736 Mbps
|
T3 672 44.736 Mbps
|
||||||
T4 4032 274.176 Mbps
|
T4 4032 274.176 Mbps
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
While the specification for T-carrier lines does not mandate a particular media type, T1 and
|
<para>
|
||||||
T2 are typically carried on copper, and T3 and T4 typically use fiber optic media. DS1, DS2,
|
While the specification for T-carrier lines does not mandate a particular
|
||||||
DS3, and DS4 are an alternate type of line equivalent to T1-T4, and typically use fiber optic
|
media type, T1 and T2 are typically carried on copper, and T3 and T4
|
||||||
media.
|
typically use fiber optic media. DS1, DS2, DS3, and DS4 are an alternate
|
||||||
|
type of line equivalent to T1-T4, and typically use fiber optic media.
|
||||||
|
</para>
|
||||||
|
|
||||||
SONET (Synchronous Optical Network)
|
SONET (Synchronous Optical Network)
|
||||||
|
<para>
|
||||||
|
A leased-line system using fiber optic media to support data speeds up to
|
||||||
|
2.4 Gbps. SONET services are sold based on optical carier (OC) levels. OC
|
||||||
|
levels are calculated as multiples of the OC-1 speed, 51.840 Mbps. For
|
||||||
|
example, OC-3 level would correspond with a data speed of 155 Mbps and
|
||||||
|
OC-12 level would equate to a data transfer rate of 622 Mbps. OC-1 and
|
||||||
|
OC-3 are the most commonly used SONET lines.
|
||||||
|
</para>
|
||||||
|
|
||||||
A leased-line system using fiber optic media to support data speeds up to 2.4 Gbps. SONET
|
</sect>
|
||||||
services are sold based on optical carier (OC) levels. OC levels are calculated as multiples
|
|
||||||
of the OC-1 speed, 51.840 Mbps. For example, OC-3 level would correspond with a data speed of
|
|
||||||
155 Mbps and OC-12 level would equate to a data transfer rate of 622 Mbps. OC-1 and OC-3
|
|
||||||
are the most commonly used SONET lines.
|
|
||||||
|
|
||||||
</sect1>
|
|
||||||
|
|
|
@ -3,147 +3,183 @@
|
||||||
<title>PLIP</title>
|
<title>PLIP</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
7.2. PLIP for Linux-2.0
|
plip (Parallel Line IP), is like SLIP, in that it is used for
|
||||||
|
providing a point to point network connection between two machines,
|
||||||
PLIP device names are `plip0', `plip1 and plip2.
|
except that it is designed to use the parallel printer ports on your
|
||||||
|
machine instead of the serial ports (a cabling diagram in included in
|
||||||
Kernel Compile Options:
|
the cabling diagram section later in this document). Because it is
|
||||||
|
possible to transfer more than one bit at a time with a parallel port,
|
||||||
|
it is possible to attain higher speeds with the plip interface than
|
||||||
Network device support --->
|
with a standard serial device. In addition, even the simplest of
|
||||||
<*> PLIP (parallel port) support
|
parallel ports, printer ports, can be used in lieu of you having to
|
||||||
|
purchase comparatively expensive 16550AFN UART's for your serial
|
||||||
|
ports. PLIP uses a lot of CPU compared to a serial link and is most
|
||||||
|
certainly not a good option if you can obtain some cheap ethernet
|
||||||
plip (Parallel Line IP), is like SLIP, in that it is used for
|
cards, but it will work when nothing else is available and will work
|
||||||
providing a point to point network connection between two machines,
|
quite well. You should expect a data transfer rate of about 20
|
||||||
except that it is designed to use the parallel printer ports on your
|
kilobytes per second when a link is running well.
|
||||||
machine instead of the serial ports (a cabling diagram in included in
|
|
||||||
the cabling diagram section later in this document). Because it is
|
|
||||||
possible to transfer more than one bit at a time with a parallel port,
|
|
||||||
it is possible to attain higher speeds with the plip interface than
|
|
||||||
with a standard serial device. In addition, even the simplest of
|
|
||||||
parallel ports, printer ports, can be used in lieu of you having to
|
|
||||||
purchase comparatively expensive 16550AFN UART's for your serial
|
|
||||||
ports. PLIP uses a lot of CPU compared to a serial link and is most
|
|
||||||
certainly not a good option if you can obtain some cheap ethernet
|
|
||||||
cards, but it will work when nothing else is available and will work
|
|
||||||
quite well. You should expect a data transfer rate of about 20
|
|
||||||
kilobytes per second when a link is running well.
|
|
||||||
|
|
||||||
The PLIP device drivers competes with the parallel device driver for
|
|
||||||
the parallel port hardware. If you wish to use both drivers then you
|
|
||||||
should compile them both as modules to ensure that you are able to
|
|
||||||
select which port you want to use for PLIP and which ports you want
|
|
||||||
for the printer driver. Refer to the ``Mudules mini-HOWTO'' for more
|
|
||||||
information on kernel module configuration.
|
|
||||||
|
|
||||||
Please note that some laptops use chipsets that will not work with
|
|
||||||
PLIP because they do not allow some combinations of signals that PLIP
|
|
||||||
relies on, that printers don't use.
|
|
||||||
|
|
||||||
The Linux plip interface is compatible with the Crynwyr Packet Driver
|
|
||||||
PLIP and this will mean that you can connect your Linux machine to a
|
|
||||||
DOS machine running any other sort of tcp/ip software via plip.
|
|
||||||
|
|
||||||
In the 2.0.* series kernel the plip devices are mapped to i/o port and
|
|
||||||
IRQ as follows:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
device i/o IRQ
|
|
||||||
------ ----- ---
|
|
||||||
plip0 0x3bc 5
|
|
||||||
plip1 0x378 7
|
|
||||||
plip2 0x278 2
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
If your parallel ports don't match any of the above combinations then
|
|
||||||
you can change the IRQ of a port using the ifconfig command using the
|
|
||||||
`irq' parameter (be sure to enable IRQ's on your printer ports in your
|
|
||||||
ROM BIOS if it supports this option). As an alternative, you can
|
|
||||||
specify ``io='' annd ``irq='' options on the insmod command line, if
|
|
||||||
you use modules. For example:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
root# insmod plip.o io=0x288 irq=5
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
PLIP operation is controlled by two timeouts, whose default values are
|
|
||||||
probably ok in most cases. You will probably need to increase them if
|
|
||||||
you have an especially slow computer, in which case the timers to
|
|
||||||
increase are actually on the other computer. A program called
|
|
||||||
plipconfig exists that allows you to change these timer settings
|
|
||||||
without recompiling your kernel. It is supplied with many Linux
|
|
||||||
distributions.
|
|
||||||
|
|
||||||
To configure a plip interface, you will need to invoke the following
|
|
||||||
commands (or add them to your initialization scripts):
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
root# /sbin/ifconfig plip1 localplip pointopoint remoteplip
|
|
||||||
root# /sbin/route add remoteplip plip1
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Here, the port being used is the one at I/O address 0x378; localplip
|
|
||||||
amd remoteplip are the names or IP addresses used over the PLIP cable.
|
|
||||||
I personally keep them in my /etc/hosts database:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
# plip entries
|
|
||||||
192.168.3.1 localplip
|
|
||||||
192.168.3.2 remoteplip
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The pointopoint parameter has the same meaning as for SLIP, in that it
|
|
||||||
specifies the address of the machine at the other end of the link.
|
|
||||||
|
|
||||||
In almost all respects you can treat a plip interface as though it
|
|
||||||
were a SLIP interface, except that neither dip nor slattach need be,
|
|
||||||
nor can be, used.
|
|
||||||
|
|
||||||
Further information on PLIP may be obtained from the ``PLIP mini-
|
|
||||||
HOWTO''.
|
|
||||||
|
|
||||||
7.3. PLIP for Linux-2.2
|
|
||||||
|
|
||||||
During development of the 2.1 kernel versions, support for the
|
|
||||||
parallel port was changed to a better setup.
|
|
||||||
|
|
||||||
Kernel Compile Options:
|
|
||||||
|
|
||||||
|
|
||||||
General setup --->
|
|
||||||
[*] Parallel port support
|
|
||||||
Network device support --->
|
|
||||||
<*> PLIP (parallel port) support
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The new code for PLIP behaves like the old one (use the same ifconfig
|
|
||||||
and route commands as in the previous section, but initialization of
|
|
||||||
the device is different due to the advanced parallel port support.
|
|
||||||
|
|
||||||
The ``first'' PLIP device is always called ``plip0'', where first is
|
|
||||||
the first device detected by the system, similarly to what happens for
|
|
||||||
Ethernet devices. The actual parallel port being used is one of the
|
|
||||||
available ports, as shown in /proc/parport. For example, if you have
|
|
||||||
only one parallel port, you'll only have a directory called
|
|
||||||
/proc/parport/0.
|
|
||||||
|
|
||||||
If your kernel didn't detect the IRQ number used by your port,
|
|
||||||
``insmod plip'' will fail; in this case just write the right number to
|
|
||||||
/proc/parport/0/irq and reinvoke insmod.
|
|
||||||
|
|
||||||
Complete information about parallel port management is available in
|
|
||||||
the file Documentation/parport.txt, part of your kernel sources.
|
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
</sect1>
|
7.2. PLIP for Linux-2.0
|
||||||
|
|
||||||
|
<para>
|
||||||
|
PLIP device names are `plip0', `plip1 and plip2.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
<screen>
|
||||||
|
Kernel Compile Options:
|
||||||
|
|
||||||
|
Network device support --->
|
||||||
|
<*> PLIP (parallel port) support
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The PLIP device drivers competes with the parallel device driver for
|
||||||
|
the parallel port hardware. If you wish to use both drivers then you
|
||||||
|
should compile them both as modules to ensure that you are able to
|
||||||
|
select which port you want to use for PLIP and which ports you want
|
||||||
|
for the printer driver. Refer to the ``Modules mini-HOWTO'' for more
|
||||||
|
information on kernel module configuration.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Please note that some laptops use chipsets that will not work with
|
||||||
|
PLIP because they do not allow some combinations of signals that PLIP
|
||||||
|
relies on, that printers don't use.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The Linux plip interface is compatible with the Crynwyr Packet Driver
|
||||||
|
PLIP and this will mean that you can connect your Linux machine to a
|
||||||
|
DOS machine running any other sort of tcp/ip software via plip.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
In the 2.0.* series kernel the plip devices are mapped to i/o port and
|
||||||
|
IRQ as follows:
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
<screen>
|
||||||
|
device i/o IRQ
|
||||||
|
------ ----- ---
|
||||||
|
plip0 0x3bc 5
|
||||||
|
plip1 0x378 7
|
||||||
|
plip2 0x278 2
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
If your parallel ports don't match any of the above combinations then
|
||||||
|
you can change the IRQ of a port using the ifconfig command using the
|
||||||
|
`irq' parameter (be sure to enable IRQ's on your printer ports in your
|
||||||
|
ROM BIOS if it supports this option). As an alternative, you can
|
||||||
|
specify ``io='' annd ``irq='' options on the insmod command line, if
|
||||||
|
you use modules. For example:
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
<screen>
|
||||||
|
root# insmod plip.o io=0x288 irq=5
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
PLIP operation is controlled by two timeouts, whose default values are
|
||||||
|
probably ok in most cases. You will probably need to increase them if
|
||||||
|
you have an especially slow computer, in which case the timers to
|
||||||
|
increase are actually on the other computer. A program called
|
||||||
|
plipconfig exists that allows you to change these timer settings
|
||||||
|
without recompiling your kernel. It is supplied with many Linux
|
||||||
|
distributions.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
To configure a plip interface, you will need to invoke the following
|
||||||
|
commands (or add them to your initialization scripts):
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
<screen>
|
||||||
|
root# /sbin/ifconfig plip1 localplip pointopoint remoteplip
|
||||||
|
root# /sbin/route add remoteplip plip1
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Here, the port being used is the one at I/O address 0x378; localplip
|
||||||
|
amd remoteplip are the names or IP addresses used over the PLIP cable.
|
||||||
|
I personally keep them in my /etc/hosts database:
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
<screen>
|
||||||
|
# plip entries
|
||||||
|
192.168.3.1 localplip
|
||||||
|
192.168.3.2 remoteplip
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The pointopoint parameter has the same meaning as for SLIP, in that it
|
||||||
|
specifies the address of the machine at the other end of the link.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
In almost all respects you can treat a plip interface as though it
|
||||||
|
were a SLIP interface, except that neither dip nor slattach need be,
|
||||||
|
nor can be, used.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Further information on PLIP may be obtained from the ``PLIP mini-
|
||||||
|
HOWTO''.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
7.3. PLIP for Linux-2.2
|
||||||
|
|
||||||
|
<para>
|
||||||
|
During development of the 2.1 kernel versions, support for the
|
||||||
|
parallel port was changed to a better setup.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
<screen>
|
||||||
|
Kernel Compile Options:
|
||||||
|
|
||||||
|
General setup --->
|
||||||
|
[*] Parallel port support
|
||||||
|
Network device support --->
|
||||||
|
<*> PLIP (parallel port) support
|
||||||
|
</screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The new code for PLIP behaves like the old one (use the same ifconfig
|
||||||
|
and route commands as in the previous section, but initialization of
|
||||||
|
the device is different due to the advanced parallel port support.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The ``first'' PLIP device is always called ``plip0'', where first is
|
||||||
|
the first device detected by the system, similarly to what happens for
|
||||||
|
Ethernet devices. The actual parallel port being used is one of the
|
||||||
|
available ports, as shown in /proc/parport. For example, if you have
|
||||||
|
only one parallel port, you'll only have a directory called
|
||||||
|
/proc/parport/0.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
If your kernel didn't detect the IRQ number used by your port,
|
||||||
|
``insmod plip'' will fail; in this case just write the right number to
|
||||||
|
/proc/parport/0/irq and reinvoke insmod.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Complete information about parallel port management is available in
|
||||||
|
the file Documentation/parport.txt, part of your kernel sources.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
</sect1>
|
||||||
|
|
File diff suppressed because it is too large
Load Diff
|
@ -1151,5 +1151,38 @@ who we should thank for writing the first versions of this document.
|
||||||
they wrote with questions but ended up giving me as much information
|
they wrote with questions but ended up giving me as much information
|
||||||
as I gave them. Unfortunately I haven't compiled a list of names
|
as I gave them. Unfortunately I haven't compiled a list of names
|
||||||
(maybe next time). You know who you are :-).
|
(maybe next time). You know who you are :-).
|
||||||
|
|
||||||
|
X Window System Architecture Overview HOWTO
|
||||||
|
Daniel Manrique
|
||||||
|
roadmr@entropia.com.mx
|
||||||
|
Revision History
|
||||||
|
Revision 1.0.1 2001-05-22 Revised by: dm
|
||||||
|
Some grammatical corrections, pointed out by Bill Staehle
|
||||||
|
Revision 1.0 2001-05-20 Revised by: dm
|
||||||
|
Initial LDP release.
|
||||||
|
12. Copyright and License
|
||||||
|
Copyright (c) 2001 by Daniel Manrique
|
||||||
|
Permission is granted to copy, distribute and/or modify this document under
|
||||||
|
the terms of the GNU Free Documentation License, Version 1.1 or any later
|
||||||
|
version published by the Free Software Foundation with no Invariant Sections,
|
||||||
|
no Front-Cover Texts, and no Back-Cover Texts. A copy of the license can be
|
||||||
|
found [http://www.gnu.org/copyleft/fdl.html] here.
|
||||||
|
|
||||||
|
The LBX Mini-HOWTO
|
||||||
|
Paul D. Smith, psmith@baynetworks.com
|
||||||
|
v1.04, 11 December 1997
|
||||||
|
|
||||||
|
Leased line Mini HOWTO
|
||||||
|
The most recent (beta) version of this HOWTO can be found at:
|
||||||
|
http://www.sput.nl/software/leased-line/
|
||||||
|
1. Introduction
|
||||||
|
1.1. Copyright and License
|
||||||
|
This document is distributed under the terms of the GNU Free
|
||||||
|
Documentation License. You should have received a copy along with it.
|
||||||
|
If not, it is available from http://www.fsf.org/licenses/fdl.html.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</appendix>
|
</appendix>
|
||||||
|
|
|
@ -258,364 +258,6 @@ my fault. Remember, what you do here could make very large holes in the
|
||||||
security model of your network. You've been warned.
|
security model of your network. You've been warned.
|
||||||
-----------------------------------------------------------------------------
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
1.4.3. GNU Free Documentation License
|
|
||||||
|
|
||||||
Version 1.1, March 2000
|
|
||||||
|
|
||||||
|
|
||||||
Copyright (C) 2000 Free Software Foundation, Inc. 59 Temple Place, Suite
|
|
||||||
330, Boston, MA 02111-1307 USA Everyone is permitted to copy and
|
|
||||||
distribute verbatim copies of this license document, but changing it is
|
|
||||||
not allowed.
|
|
||||||
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
1.4.4. PREAMBLE
|
|
||||||
|
|
||||||
The purpose of this License is to make a manual, textbook, or other written
|
|
||||||
document "free" in the sense of freedom: to assure everyone the effective
|
|
||||||
freedom to copy and redistribute it, with or without modifying it, either
|
|
||||||
commercially or noncommercially. Secondarily, this License preserves for the
|
|
||||||
author and publisher a way to get credit for their work, while not being
|
|
||||||
considered responsible for modifications made by others.
|
|
||||||
|
|
||||||
This License is a kind of "copyleft", which means that derivative works of
|
|
||||||
the document must themselves be free in the same sense. It complements the
|
|
||||||
GNU General Public License, which is a copyleft license designed for free
|
|
||||||
software.
|
|
||||||
|
|
||||||
We have designed this License in order to use it for manuals for free
|
|
||||||
software, because free software needs free documentation: a free program
|
|
||||||
should come with manuals providing the same freedoms that the software does.
|
|
||||||
But this License is not limited to software manuals; it can be used for any
|
|
||||||
textual work, regardless of subject matter or whether it is published as a
|
|
||||||
printed book. We recommend this License principally for works whose purpose
|
|
||||||
is instruction or reference.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.5. APPLICABILITY AND DEFINITIONS
|
|
||||||
|
|
||||||
This License applies to any manual or other work that contains a notice
|
|
||||||
placed by the copyright holder saying it can be distributed under the terms
|
|
||||||
of this License. The "Document", below, refers to any such manual or work.
|
|
||||||
Any member of the public is a licensee, and is addressed as "you".
|
|
||||||
|
|
||||||
A "Modified Version" of the Document means any work containing the Document
|
|
||||||
or a portion of it, either copied verbatim, or with modifications and/or
|
|
||||||
translated into another language.
|
|
||||||
|
|
||||||
A "Secondary Section" is a named appendix or a front-matter section of the
|
|
||||||
Document that deals exclusively with the relationship of the publishers or
|
|
||||||
authors of the Document to the Document's overall subject (or to related
|
|
||||||
matters) and contains nothing that could fall directly within that overall
|
|
||||||
subject. (For example, if the Document is in part a textbook of mathematics,
|
|
||||||
a Secondary Section may not explain any mathematics.) The relationship could
|
|
||||||
be a matter of historical connection with the subject or with related
|
|
||||||
matters, or of legal, commercial, philosophical, ethical or political
|
|
||||||
position regarding them.
|
|
||||||
|
|
||||||
The "Invariant Sections" are certain Secondary Sections whose titles are
|
|
||||||
designated, as being those of Invariant Sections, in the notice that says
|
|
||||||
that the Document is released under this License.
|
|
||||||
|
|
||||||
The "Cover Texts" are certain short passages of text that are listed, as
|
|
||||||
Front-Cover Texts or Back-Cover Texts, in the notice that says that the
|
|
||||||
Document is released under this License.
|
|
||||||
|
|
||||||
A "Transparent" copy of the Document means a machine-readable copy,
|
|
||||||
represented in a format whose specification is available to the general
|
|
||||||
public, whose contents can be viewed and edited directly and
|
|
||||||
straightforwardly with generic text editors or (for images composed of
|
|
||||||
pixels) generic paint programs or (for drawings) some widely available
|
|
||||||
drawing editor, and that is suitable for input to text formatters or for
|
|
||||||
automatic translation to a variety of formats suitable for input to text
|
|
||||||
formatters. A copy made in an otherwise Transparent file format whose markup
|
|
||||||
has been designed to thwart or discourage subsequent modification by readers
|
|
||||||
is not Transparent. A copy that is not "Transparent" is called "Opaque".
|
|
||||||
|
|
||||||
Examples of suitable formats for Transparent copies include plain ASCII
|
|
||||||
without markup, Texinfo input format, LaTeX input format, SGML or XML using a
|
|
||||||
publicly available DTD, and standard-conforming simple HTML designed for
|
|
||||||
human modification. Opaque formats include PostScript, PDF, proprietary
|
|
||||||
formats that can be read and edited only by proprietary word processors, SGML
|
|
||||||
or XML for which the DTD and/or processing tools are not generally available,
|
|
||||||
and the machine-generated HTML produced by some word processors for output
|
|
||||||
purposes only.
|
|
||||||
|
|
||||||
The "Title Page" means, for a printed book, the title page itself, plus such
|
|
||||||
following pages as are needed to hold, legibly, the material this License
|
|
||||||
requires to appear in the title page. For works in formats which do not have
|
|
||||||
any title page as such, "Title Page" means the text near the most prominent
|
|
||||||
appearance of the work's title, preceding the beginning of the body of the
|
|
||||||
text.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.6. VERBATIM COPYING
|
|
||||||
|
|
||||||
You may copy and distribute the Document in any medium, either commercially
|
|
||||||
or noncommercially, provided that this License, the copyright notices, and
|
|
||||||
the license notice saying this License applies to the Document are reproduced
|
|
||||||
in all copies, and that you add no other conditions whatsoever to those of
|
|
||||||
this License. You may not use technical measures to obstruct or control the
|
|
||||||
reading or further copying of the copies you make or distribute. However, you
|
|
||||||
may accept compensation in exchange for copies. If you distribute a large
|
|
||||||
enough number of copies you must also follow the conditions in section 3.
|
|
||||||
|
|
||||||
You may also lend copies, under the same conditions stated above, and you may
|
|
||||||
publicly display copies.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.7. COPYING IN QUANTITY
|
|
||||||
|
|
||||||
If you publish printed copies of the Document numbering more than 100, and
|
|
||||||
the Document's license notice requires Cover Texts, you must enclose the
|
|
||||||
copies in covers that carry, clearly and legibly, all these Cover Texts:
|
|
||||||
Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover.
|
|
||||||
Both covers must also clearly and legibly identify you as the publisher of
|
|
||||||
these copies. The front cover must present the full title with all words of
|
|
||||||
the title equally prominent and visible. You may add other material on the
|
|
||||||
covers in addition. Copying with changes limited to the covers, as long as
|
|
||||||
they preserve the title of the Document and satisfy these conditions, can be
|
|
||||||
treated as verbatim copying in other respects.
|
|
||||||
|
|
||||||
If the required texts for either cover are too voluminous to fit legibly, you
|
|
||||||
should put the first ones listed (as many as fit reasonably) on the actual
|
|
||||||
cover, and continue the rest onto adjacent pages.
|
|
||||||
|
|
||||||
If you publish or distribute Opaque copies of the Document numbering more
|
|
||||||
than 100, you must either include a machine-readable Transparent copy along
|
|
||||||
with each Opaque copy, or state in or with each Opaque copy a
|
|
||||||
publicly-accessible computer-network location containing a complete
|
|
||||||
Transparent copy of the Document, free of added material, which the general
|
|
||||||
network-using public has access to download anonymously at no charge using
|
|
||||||
public-standard network protocols. If you use the latter option, you must
|
|
||||||
take reasonably prudent steps, when you begin distribution of Opaque copies
|
|
||||||
in quantity, to ensure that this Transparent copy will remain thus accessible
|
|
||||||
at the stated location until at least one year after the last time you
|
|
||||||
distribute an Opaque copy (directly or through your agents or retailers) of
|
|
||||||
that edition to the public.
|
|
||||||
|
|
||||||
It is requested, but not required, that you contact the authors of the
|
|
||||||
Document well before redistributing any large number of copies, to give them
|
|
||||||
a chance to provide you with an updated version of the Document.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.8. MODIFICATIONS
|
|
||||||
|
|
||||||
You may copy and distribute a Modified Version of the Document under the
|
|
||||||
conditions of sections 2 and 3 above, provided that you release the Modified
|
|
||||||
Version under precisely this License, with the Modified Version filling the
|
|
||||||
role of the Document, thus licensing distribution and modification of the
|
|
||||||
Modified Version to whoever possesses a copy of it. In addition, you must do
|
|
||||||
these things in the Modified Version:
|
|
||||||
|
|
||||||
A. Use in the Title Page (and on the covers, if any) a title distinct from
|
|
||||||
that of the Document, and from those of previous versions (which should,
|
|
||||||
if there were any, be listed in the History section of the Document). You
|
|
||||||
may use the same title as a previous version if the original publisher of
|
|
||||||
that version gives permission.
|
|
||||||
|
|
||||||
B. List on the Title Page, as authors, one or more persons or entities
|
|
||||||
responsible for authorship of the modifications in the Modified Version,
|
|
||||||
together with at least five of the principal authors of the Document (all
|
|
||||||
of its principal authors, if it has less than five).
|
|
||||||
|
|
||||||
C. State on the Title page the name of the publisher of the Modified
|
|
||||||
Version, as the publisher.
|
|
||||||
|
|
||||||
D. Preserve all the copyright notices of the Document.
|
|
||||||
|
|
||||||
E. Add an appropriate copyright notice for your modifications adjacent to
|
|
||||||
the other copyright notices.
|
|
||||||
|
|
||||||
F. Include, immediately after the copyright notices, a license notice giving
|
|
||||||
the public permission to use the Modified Version under the terms of this
|
|
||||||
License, in the form shown in the Addendum below.
|
|
||||||
|
|
||||||
G. Preserve in that license notice the full lists of Invariant Sections and
|
|
||||||
required Cover Texts given in the Document's license notice.
|
|
||||||
|
|
||||||
H. Include an unaltered copy of this License.
|
|
||||||
|
|
||||||
I. Preserve the section entitled "History", and its title, and add to it an
|
|
||||||
item stating at least the title, year, new authors, and publisher of the
|
|
||||||
Modified Version as given on the Title Page. If there is no section
|
|
||||||
entitled "History" in the Document, create one stating the title, year,
|
|
||||||
authors, and publisher of the Document as given on its Title Page, then
|
|
||||||
add an item describing the Modified Version as stated in the previous
|
|
||||||
sentence.
|
|
||||||
|
|
||||||
J. Preserve the network location, if any, given in the Document for public
|
|
||||||
access to a Transparent copy of the Document, and likewise the network
|
|
||||||
locations given in the Document for previous versions it was based on.
|
|
||||||
These may be placed in the "History" section. You may omit a network
|
|
||||||
location for a work that was published at least four years before the
|
|
||||||
Document itself, or if the original publisher of the version it refers to
|
|
||||||
gives permission.
|
|
||||||
|
|
||||||
K. In any section entitled "Acknowledgements" or "Dedications", preserve the
|
|
||||||
section's title, and preserve in the section all the substance and tone
|
|
||||||
of each of the contributor acknowledgements and/or dedications given
|
|
||||||
therein.
|
|
||||||
|
|
||||||
L. Preserve all the Invariant Sections of the Document, unaltered in their
|
|
||||||
text and in their titles. Section numbers or the equivalent are not
|
|
||||||
considered part of the section titles.
|
|
||||||
|
|
||||||
M. Delete any section entitled "Endorsements". Such a section may not be
|
|
||||||
included in the Modified Version.
|
|
||||||
|
|
||||||
N. Do not retitle any existing section as "Endorsements" or to conflict in
|
|
||||||
title with any Invariant Section.
|
|
||||||
|
|
||||||
|
|
||||||
If the Modified Version includes new front-matter sections or appendices that
|
|
||||||
qualify as Secondary Sections and contain no material copied from the
|
|
||||||
Document, you may at your option designate some or all of these sections as
|
|
||||||
invariant. To do this, add their titles to the list of Invariant Sections in
|
|
||||||
the Modified Version's license notice. These titles must be distinct from any
|
|
||||||
other section titles.
|
|
||||||
|
|
||||||
You may add a section entitled "Endorsements", provided it contains nothing
|
|
||||||
but endorsements of your Modified Version by various parties--for example,
|
|
||||||
statements of peer review or that the text has been approved by an
|
|
||||||
organization as the authoritative definition of a standard.
|
|
||||||
|
|
||||||
You may add a passage of up to five words as a Front-Cover Text, and a
|
|
||||||
passage of up to 25 words as a Back-Cover Text, to the end of the list of
|
|
||||||
Cover Texts in the Modified Version. Only one passage of Front-Cover Text and
|
|
||||||
one of Back-Cover Text may be added by (or through arrangements made by) any
|
|
||||||
one entity. If the Document already includes a cover text for the same cover,
|
|
||||||
previously added by you or by arrangement made by the same entity you are
|
|
||||||
acting on behalf of, you may not add another; but you may replace the old
|
|
||||||
one, on explicit permission from the previous publisher that added the old
|
|
||||||
one.
|
|
||||||
|
|
||||||
The author(s) and publisher(s) of the Document do not by this License give
|
|
||||||
permission to use their names for publicity for or to assert or imply
|
|
||||||
endorsement of any Modified Version.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.9. COMBINING DOCUMENTS
|
|
||||||
|
|
||||||
You may combine the Document with other documents released under this
|
|
||||||
License, under the terms defined in section 4 above for modified versions,
|
|
||||||
provided that you include in the combination all of the Invariant Sections of
|
|
||||||
all of the original documents, unmodified, and list them all as Invariant
|
|
||||||
Sections of your combined work in its license notice.
|
|
||||||
|
|
||||||
The combined work need only contain one copy of this License, and multiple
|
|
||||||
identical Invariant Sections may be replaced with a single copy. If there are
|
|
||||||
multiple Invariant Sections with the same name but different contents, make
|
|
||||||
the title of each such section unique by adding at the end of it, in
|
|
||||||
parentheses, the name of the original author or publisher of that section if
|
|
||||||
known, or else a unique number. Make the same adjustment to the section
|
|
||||||
titles in the list of Invariant Sections in the license notice of the
|
|
||||||
combined work.
|
|
||||||
|
|
||||||
In the combination, you must combine any sections entitled "History" in the
|
|
||||||
various original documents, forming one section entitled "History"; likewise
|
|
||||||
combine any sections entitled "Acknowledgements", and any sections entitled
|
|
||||||
"Dedications". You must delete all sections entitled "Endorsements."
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.10. COLLECTIONS OF DOCUMENTS
|
|
||||||
|
|
||||||
You may make a collection consisting of the Document and other documents
|
|
||||||
released under this License, and replace the individual copies of this
|
|
||||||
License in the various documents with a single copy that is included in the
|
|
||||||
collection, provided that you follow the rules of this License for verbatim
|
|
||||||
copying of each of the documents in all other respects.
|
|
||||||
|
|
||||||
You may extract a single document from such a collection, and distribute it
|
|
||||||
individually under this License, provided you insert a copy of this License
|
|
||||||
into the extracted document, and follow this License in all other respects
|
|
||||||
regarding verbatim copying of that document.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.11. AGGREGATION WITH INDEPENDENT WORKS
|
|
||||||
|
|
||||||
A compilation of the Document or its derivatives with other separate and
|
|
||||||
independent documents or works, in or on a volume of a storage or
|
|
||||||
distribution medium, does not as a whole count as a Modified Version of the
|
|
||||||
Document, provided no compilation copyright is claimed for the compilation.
|
|
||||||
Such a compilation is called an "aggregate", and this License does not apply
|
|
||||||
to the other self-contained works thus compiled with the Document, on account
|
|
||||||
of their being thus compiled, if they are not themselves derivative works of
|
|
||||||
the Document.
|
|
||||||
|
|
||||||
If the Cover Text requirement of section 3 is applicable to these copies of
|
|
||||||
the Document, then if the Document is less than one quarter of the entire
|
|
||||||
aggregate, the Document's Cover Texts may be placed on covers that surround
|
|
||||||
only the Document within the aggregate. Otherwise they must appear on covers
|
|
||||||
around the whole aggregate.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.12. TRANSLATION
|
|
||||||
|
|
||||||
Translation is considered a kind of modification, so you may distribute
|
|
||||||
translations of the Document under the terms of section 4. Replacing
|
|
||||||
Invariant Sections with translations requires special permission from their
|
|
||||||
copyright holders, but you may include translations of some or all Invariant
|
|
||||||
Sections in addition to the original versions of these Invariant Sections.
|
|
||||||
You may include a translation of this License provided that you also include
|
|
||||||
the original English version of this License. In case of a disagreement
|
|
||||||
between the translation and the original English version of this License, the
|
|
||||||
original English version will prevail.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.13. TERMINATION
|
|
||||||
|
|
||||||
You may not copy, modify, sublicense, or distribute the Document except as
|
|
||||||
expressly provided for under this License. Any other attempt to copy, modify,
|
|
||||||
sublicense or distribute the Document is void, and will automatically
|
|
||||||
terminate your rights under this License. However, parties who have received
|
|
||||||
copies, or rights, from you under this License will not have their licenses
|
|
||||||
terminated so long as such parties remain in full compliance.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.14. FUTURE REVISIONS OF THIS LICENSE
|
|
||||||
|
|
||||||
The Free Software Foundation may publish new, revised versions of the GNU
|
|
||||||
Free Documentation License from time to time. Such new versions will be
|
|
||||||
similar in spirit to the present version, but may differ in detail to address
|
|
||||||
new problems or concerns. See [http://www.gnu.org/copyleft/] http://
|
|
||||||
www.gnu.org/copyleft/.
|
|
||||||
|
|
||||||
Each version of the License is given a distinguishing version number. If the
|
|
||||||
Document specifies that a particular numbered version of this License "or any
|
|
||||||
later version" applies to it, you have the option of following the terms and
|
|
||||||
conditions either of that specified version or of any later version that has
|
|
||||||
been published (not as a draft) by the Free Software Foundation. If the
|
|
||||||
Document does not specify a version number of this License, you may choose
|
|
||||||
any version ever published (not as a draft) by the Free Software Foundation.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.4.15. How to use this License for your documents
|
|
||||||
|
|
||||||
To use this License in a document you have written, include a copy of the
|
|
||||||
License in the document and put the following copyright and license notices
|
|
||||||
just after the title page:
|
|
||||||
|
|
||||||
|
|
||||||
Copyright (c) YEAR YOUR NAME. Permission is granted to copy, distribute
|
|
||||||
and/or modify this document under the terms of the GNU Free Documentation
|
|
||||||
License, Version 1.1 or any later version published by the Free Software
|
|
||||||
Foundation; with the Invariant Sections being LIST THEIR TITLES, with the
|
|
||||||
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. A
|
|
||||||
copy of the license is included in the section entitled "GNU Free
|
|
||||||
Documentation License".
|
|
||||||
|
|
||||||
If you have no Invariant Sections, write "with no Invariant Sections" instead
|
|
||||||
of saying which ones are invariant. If you have no Front-Cover Texts, write
|
|
||||||
"no Front-Cover Texts" instead of "Front-Cover Texts being LIST"; likewise
|
|
||||||
for Back-Cover Texts.
|
|
||||||
|
|
||||||
If your document contains nontrivial examples of program code, we recommend
|
|
||||||
releasing these examples in parallel under your choice of free software
|
|
||||||
license, such as the GNU General Public License, to permit their use in free
|
|
||||||
software.
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
1.5. Document History
|
1.5. Document History
|
||||||
|
|
||||||
The original "VPN mini-HOWTO" was written by Arpad Magosanyi, <
|
The original "VPN mini-HOWTO" was written by Arpad Magosanyi, <
|
||||||
|
|
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue