You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdenetwork/doc/kwifimanager/index.docbook

550 lines
35 KiB

<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kwifimanager "<application>KWiFiManager</application>">
<!ENTITY LAN "<acronym>LAN</acronym>">
<!ENTITY kappname "&kwifimanager;">
<!ENTITY package "tdenetwork">
<!ENTITY % English "INCLUDE"> <!-- change language only here -->
<!ENTITY % addindex "IGNORE">
]>
<book lang="&language;">
<bookinfo>
<title>The &kwifimanager; Handbook</title>
<authorgroup>
<author>
<firstname>Stefan</firstname>
<surname>Winter</surname>
<affiliation>
<address>
<email>swinter@kde.org</email>
</address>
</affiliation>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<legalnotice>&FDLNotice;</legalnotice>
<copyright>
<year>2002-05</year>
<holder>Stefan Winter</holder>
</copyright>
<date>2005--05-11</date>
<releaseinfo>3.5.0</releaseinfo>
<abstract>
<para>The &kwifimanager; suite can be used to configure and monitor wireless &LAN;
cards. It consists of a stand-alone application and a module for the &kde; Control
Center.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>wireless</keyword>
<keyword>Wi-Fi</keyword>
<keyword>wlan</keyword>
<keyword>WEP</keyword>
<keyword>wlan-ng</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title>Introduction</title>
<para> The &kwifimanager; suite is a set of tools which allows you to manage your wireless
&LAN; Network Interface card (PC-Card, PCI or miniPCI) under the Trinity Desktop Environment. It
provides information about your current connection and lets you set up up to ten independent
configurations and use up to four configrations that are pre-configured by distribution-specific
scripts. If you are in a place where none of your preconfigured networks is available,
you can also dynamically switch to an available network with almost no configuration effort.
&kwifimanager; supports every wireless &LAN; card that uses the wireless extensions
interface. This includes virtually all wireless &LAN; cards that are operational at all
under the &Linux; operating system.</para>
</chapter>
<chapter id="using">
<title>Using the &kwifimanager; suite</title>
<sect1 id="kwifimanager-application">
<title>The &kwifimanager; application</title>
<para> Purpose of the main &kwifimanager; application is to show the currently active
network configuration and to display connection quality and access points.</para>
<para>The main application is launched by either typing<userinput>kwifimanager</userinput> at
the command prompt of a console window or via the TDE Menu, where it is located by default in
the<guisubmenu>Applications</guisubmenu> group. If &kwifimanager; is already running
but minimised to the system tray then it can be restored by clicking once on the <link
linkend="systrayicon">system tray icon</link>. If there is more than one wireless &LAN;
card in your system, just open more than one instance of &kwifimanager;: every instance
will show information about a different card automatically.
The &GUI; elements of the application
are explained in the following subsections.</para>
<sect2 id="kwifimanager-main">
<title>Main window</title>
<para> The &kwifimanager; main window consists of five parts:</para>
<sect3 id="signalquality">
<title>Signal quality display</title>
<para> Here you can see the quality and type of the active connection. The uppermost icon
displays the general state of the wireless network via a set of pictograms:<itemizedlist>
<listitem>
<para> a wireless &LAN; card with a question tag means that no card was detected
or its state could not be determined</para>
</listitem>
<listitem>
<para> a single laptop means that a wireless &LAN; card is inserted and in
Infrastructure mode, but there is no radio signal from access-points. The card is
out of range and can not communicate to the infrastructure network.</para>
</listitem>
<listitem>
<para> a laptop that is connected to an access point means that a connection to an
access point is established.</para>
</listitem>
<listitem>
<para> two laptops mean that your system is in Ad-Hoc mode without access points. It
may or may not have established a Peer-to-Peer connection.</para>
</listitem>
</itemizedlist>
</para>
<para> Below these pictograms is a small quality meter. It displays, in a cellular-like
manner, the quality level of the current connection. This information is only available
in Infrastructure mode. In Ad-Hoc mode, the level is always 0.</para>
<para> This graphical information is supplemented by an integer value below the icon. It
shows the signal quality, and is computed in one of two ways: <itemizedlist>
<listitem>
<para>a directly reported value from the card if the card supports
<quote>Quality</quote> reporting</para>
</listitem>
<listitem>
<para>
<literal>(signal strength in dBm) - (noise level in dBm)</literal> for cards that
do not support that.</para>
</listitem>
</itemizedlist> You can manually change the method used by turning
<guimenu>File</guimenu>, <guimenuitem>Use alternate strength calculation</guimenuitem>
on or off. Turning the option on means to use the second method. If your card is out of
range, the value is 0; if no card is inserted or your card is in Ad-Hoc mode it will
show N/A.</para>
</sect3>
<sect3 id="speed">
<title>Connection speed</title>
<para> An indicator for the current connection speed is shown at the right-hand side of
the main window above the configuration info. If the speed settings are set to AUTO, the
value will change once in a while as the card adjusts the connection speed according to
the signal quality. The scale of the bar graph will automatically adjust to up to 108
MBit/s when the current connection speed exceeds 11 MBit/s.</para>
</sect3>
<sect3 id="current-config">
<title>Current configuration</title>
<para>Here you can find information about your card configuration. It displays the
following information:</para>
<itemizedlist>
<listitem>
<para> the network with which the card is connected to / tries to connect to
(<guilabel>Searching for network:</guilabel> or <guilabel>Connected to
network:</guilabel>)</para>
</listitem>
<listitem>
<para> the <acronym>MAC</acronym> address of the access point to which the card is
connected.</para>
<para> If the card is in Infrastructure mode but out of range, an appropriate warning
(<computeroutput>- no access point -</computeroutput>) is displayed to indicate
that no connection is established.</para>
<para> In Ad-Hoc mode, the field shows an address that is associated with one of the
cards in the Ad-Hoc network. It displays a MAC address that has a non-global scope:
its second bit is set to 1, which often results in a prefix of <quote>02:</quote>
instead of <quote>00:</quote>. Many people think this is an error, but in fact it is
done on purpose to show that the cell you are connected to is not an actual physical
device, but rather an imaginary access point without a real physical address.</para>
<informalexample>
<para> Your card is the first card that enters Ad-Hoc mode with a given SSID. Then all other cards
entering Ad-Hoc mode with the same SSID will see your MAC-address, slightly modified: instead
of<computeroutput>00:xx:yy:zz:aa:bb</computeroutput> it will
show<computeroutput>02:xx:yy:zz:aa:bb</computeroutput>. This behavior is
intentional.</para>
</informalexample>
</listitem>
<listitem>
<para> on most cards (those that have the capability to report it), the frequency on
which the card is transmitting data and the corresponding channel number is
displayed.</para>
</listitem>
<listitem>
<para> your local IP (version 4) address, if available. If no address could be
retrieved from the networking subsystem, the word <guilabel>unavailable</guilabel>
is displayed.</para>
</listitem>
<listitem>
<para> encryption status (only if you have started &kwifimanager; as<systemitem
class="username">root</systemitem>). The display will only show
<guilabel>off</guilabel> or <guilabel>active</guilabel>, but never the real key.
This is intentional in order to not reveal the <acronym>WEP</acronym> key to people
passing by the users screen.</para>
</listitem>
</itemizedlist>
</sect3>
<sect3 id="ap-info">
<title>Access Point information (bottom area)</title>
<para> The last line of the main window shows information about your AccessPoint. This
requires that your system administrator provided a list of MAC addresses with a
corresponding information. An example for such a list can be found
in<filename>$<envar>TDEDIR</envar>/share/apps/kwifimanager/locations/DE_BW_Karlsruhe_University.loc</filename>
</para>
<para>If you want to set up a new list, simply create a file in the same format and copy
it into the folder <filename class="directory"
>$<envar>TDEDIR</envar>/share/apps/kwifimanager/locations/</filename>
</para>
<para>It will be automatically parsed at the next start of &kwifimanager;. If you have
a list and want to have it included in future releases of &kwifimanager;, simply
send it to the author or current maintainer.</para>
</sect3>
<sect3 id="scanning">
<title>Information about available networks</title>
<para> The lower-left area of the main window contains a button named <guibutton>Scan for
networks...</guibutton>. If you click on this button, &kwifimanager; will attempt
to retrieve a list of all networks that are in range of your card. The outcome of this
scan depends on two factors: <itemizedlist>
<listitem>
<para>the overall ability of your card and driver to perform network scans</para>
</listitem>
<listitem>
<para>if you have root permissions or not</para>
</listitem>
</itemizedlist> If your card or driver arent able to scan the network, your scanning
results will always be empty. If you are not the root user, the list may be incomplete
or outdated. </para>
<para> In order to receive a reliable, current list of access points you will need to
start the scan with root privileges, for example by using the &tdesu; utility to
start &kwifimanager;</para>
<para> If at least one network was found, you are presented with a table showing details
of the network. It has four columns that inform you about <itemizedlist>
<listitem>
<para>the network name (or the string <guilabel>(hidden cell)</guilabel> if the name
is not disclosed by the access point during the scan)</para>
</listitem>
<listitem>
<para>the type (whether is a <guilabel>Managed</guilabel> or an
<guilabel>Ad-Hoc</guilabel> network)</para>
</listitem>
<listitem>
<para>the signal strength of the network</para>
</listitem>
<listitem>
<para>and whether or not <acronym>WEP</acronym> encryption is used</para>
</listitem>
</itemizedlist> In case of an active <acronym>WEP</acronym> encryption, you can click on
that column and enter the network key. &kwifimanager; will automatically try to
guess if the key is a hexadecimal number or a string. </para>
<para> If the network information for the highlighted network is complete (&ie; all
columns contain meaningful information), you can use the button <guibutton>Switch to
network</guibutton> to enter the selected network. If &kwifimanager; has no root
privileges, you will be prompted with a password prompt to enter the root password in
order to change the network. </para>
<para> Clicking on <guibutton>Close</guibutton> dismisses the network information screen
without changes to the existing settings. </para>
</sect3>
</sect2>
<sect2 id="statistics">
<title>Statistics Viewer</title>
<para> Optionally, by selecting <guimenuitem>Connection statistics</guimenuitem> in the
<guimenu>File</guimenu> menu, a separate window can be shown which displays the signal
level and noise level graphs of the last 240 seconds. The signal level is displayed in
blue and the noise level in red. The difference (SIGNAL minus NOISE) is the connection
quality which is displayed in the main window.</para>
<para>Some cards do not report meaningful noise information. If this is the case for your
card and you get annoyed by the irrelevant red line, you can disable showing the noise
level in the statistics window by unselecting <menuchoice>
<guimenu> Config </guimenu>
<guimenuitem> Show noise level in statistics </guimenuitem>
</menuchoice> in the &kwifimanager; main window.</para>
</sect2>
<sect2 id="config-edit">
<title>Configuration Editor</title>
<para> By selecting<menuchoice>
<guimenu>Config</guimenu>
<guimenuitem>Configuration Editor</guimenuitem>
</menuchoice> you are taken to the <link linkend="control-center">control center
module</link> of &kwifimanager;. In case you are not the <systemitem class="username"
>root</systemitem> user, a window will pop up requesting the <systemitem
class="username">root</systemitem> password. This is because the configuration module
allows you to change network connectivity und uses <userinput>ifconfig</userinput> to make
changes, which requires root privileges.</para>
</sect2>
<sect2 id="misc">
<title>Miscellaneous</title>
<para>There are some minor additional features worth of being mentioned.</para>
<sect3 id="acoustic-scanning">
<title>Acoustic Scanning</title>
<para>First, there is a feature named <guilabel>Acoustic Scanning</guilabel>. If this
option is enabled, the connection quality is converted into an acoustic signal. A higher
signal quality leads to a higher frequency of the <quote>beep</quote> output and to a
more rapid beeping. If you've ever seen the Star Trek(tm) series you will see some
parallels to their <quote>tricorders</quote>
</para>
</sect3>
<sect3 id="logging">
<title>Network logging</title>
<para>A second feature is network logging. It just means that &kwifimanager; will log
the name of the network you are connecting to every time your network changes.
This option is most useful when searching for the special network name
<quote>any</quote>. In this mode, the card will log into any network it finds. The
logfile's position is <filename class="directory"
>$<envar>HOME</envar>/.kde/share/apps/kwifimanager/wireless-log</filename>
</para>
</sect3>
<sect3>
<title>Disabling the wireless network</title>
<para>You can completely disable the card by selecting the option <guimenu>File</guimenu>
<guimenuitem>Disable radio</guimenuitem>. Using this option will turn off the cards
transmitter which effectively turns it off and saves a little bit of energy. This will
only work for your card if it accepts changes to its
<computeroutput>txpower</computeroutput> property.</para>
</sect3>
</sect2>
</sect1>
<sect1 id="systrayicon">
<title>The system tray icon</title>
<para>When &kwifimanager; is launched, it installs a small icon in the system tray. The icon contains
parts of the information of the main window, namely the bar graph and optionally the signal strength
number. If you hover over the icon with the mouse for a few seconds, a tooltip will appear that
contains the currently connected network name. Whether or not the strength number shall be
shown can be configured via <guimenu>Config</guimenu>,
<guimenuitem>Show Strength Number in System Tray</guimenuitem>.</para>
<para>If you have configured &kwifimanager; to stay in the system tray when clicking on the
<guibutton>X</guibutton> button, the icon will stay in the tray persistently unless you really exit
the application by clicking on <guimenu>File</guimenu>, <guimenuitem>Quit</guimenuitem>.</para>
<para>You can always hide the main application to the system tray by clicking on the tray icon. Similarly,
to restore the main application from the tray, just click on it once.</para>
</sect1>
<sect1 id="control-center">
<title>The Control Center module</title>
<para>The configuration module in the &kcontrolcenter; is perhaps the most useful part of
the &kwifimanager; suite. Here you can actually change the basic settings of your
wireless &LAN; card. The module can manage up to ten independent configurations for the
card. If you dont need that many configurations, you can reduce the number of configs
shown at any time by changing the <guilabel>Number of Configurations</guilabel> entry.
If you have configured your wireless settings with a distribution-specific tool, chances are good
that the &kcontrolcenter; module will automatically detect this and also read in and show that
configuration. In any case these configurations will be read-only, because it is the distribution's
job to handle updating these settings and the module should not interfere with their internal magic.
Up to five additional preset configurations can be shown in addition to the ten
that are self-definable. These configurations will have the name <guilabel>Vendor x</guilabel>
to distinguish them from the others.
The &kcontrolcenter; can even automatically set your card up whenever you start the module.
Since establishing (or bringing down) a network connection is a security sensitive operation,
any changes to the configuration can only be done by <systemitem class="username">root</systemitem>.</para>
<sect2 id="configuration-tab">
<title>The Configuration Tabs</title>
<para>The configurations are split up in three parts: <itemizedlist>
<listitem>
<para>general configuration settings (like the network name)</para>
</listitem>
<listitem>
<para>encryption settings</para>
</listitem>
<listitem>
<para>power saving settings</para>
</listitem>
</itemizedlist>
These parts are explained in the following sections.
</para>
<sect3 id="config_general">
<title>General settings</title>
<para>The upper part of the control center module consists of one to ten tabs labelled
<guilabel>Config 1</guilabel> through <guilabel>Config 10</guilabel>. Each of these tabs
can hold a configuration for your WLAN card. In addition (as explained above) up to five vendor-specific
configurations may be visible, labelled <guilabel>Vendor 1</guilabel> through <guilabel>Vendor 5</guilabel>.</para>
<para>The most important settings are always visible, the cryptography and power management
options are only shown when activated. The perhaps most important element in each
configuration tab is the field<guilabel>Network name</guilabel>. Here you can specify
which network you would like to log into. You can either specify the name of your network
directly, or you can try a scan on all available networks by setting the network name to
<userinput>any</userinput>.</para>
<para>In addition to the network name, you have to specify the type of network to log into.
That's the purpose of the button group<guilabel>Operation mode</guilabel>. The
option<guilabel>Managed</guilabel> means that the network consists of designated
base stations, so-called <quote>access points</quote> or sometimes <quote>residential
gateways</quote>. This is the most common operation mode for company networks. The second
option,<guilabel>Ad-hoc</guilabel> means that your network is just a direct
connection between computers, without access points. The three other options
(<guilabel>Repeater</guilabel>, <guilabel>Master</guilabel> and <guilabel>Secondary</guilabel>)
are only very seldomly used. If you want to use them, please be aware that these settings are simply
passed to the iwconfig program and have not been tested extensively. In case something doesnt
work as expected, you are welcome to send a bug report.</para>
<para>You can optionally set the connection speed for your connection. The setting
<guilabel>auto</guilabel> should do for most uses, since the card will determine the
appropriate speed itself. However, if you find that the speed changes every few seconds,
for example when you have a weak connection, you can set the speed manually.</para>
<para>Below these configuration items you will find a field named<guilabel>Execute script on
connect:</guilabel>. Here you can enter the name of a script to execute after setting up
the network connection. It will be
executed whenever you hit the <guilabel>Activate configuration</guilabel> button and,
optionally, automatically when you start the Control Center module. The script will have
<systemitem class="username">root</systemitem> rights. This may lead to problems
if you want to start an X application in the script and the X server belongs to someone
else than root. You can make such scripts work correctly if you execute the X application
via<userinput>
<command>tdesu</command>
<option>-u</option>
<replaceable>USERNAME</replaceable>
<option>-c</option>
<replaceable>COMMAND</replaceable>
</userinput>. Or, you can instruct your X server to also allow connections coming from
root. You can do this with the <command>xhost</command> program.</para>
</sect3>
<sect3 id="config_crypto">
<title>Cryptography settings</title>
<para>The checkbox <guilabel>Use encryption</guilabel> determines whether or not encryption
shall be activated. If it is checked, a button labelled <guibutton>Configure...</guibutton> becomes
available which allows you to configure the details of encryption.
After pushing the button, you are presented the following settings in a new dialog: </para>
<variablelist>
<varlistentry>
<term>
<guilabel>Key to use:</guilabel>
</term>
<listitem>
<para>You can define up to four secret keys for each configuration; in this field you
can set which one you want to use to send encrypted packets. The card can always
receive packets that are encrypted with <emphasis>any</emphasis> of the keys.</para>
<tip><para>You can achieve asymetrical encryption (different keys for sending and receiving)
if you configure your access point to send packets with a different key than the card. Just make
sure that the partner station has the required key in any one of its key slots.</para></tip>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel>Crypto mode:</guilabel>
</term>
<listitem>
<para>When encryption is activated, there are two ways to deal with incoming
non-encrypted packets: discard or allow. When you set your card for <guilabel>Open</guilabel>,
the card will also listen to non-encrypted packets.
<guilabel>Restricted</guilabel> will only allow encrypted network packets,
any other packets are discarded.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel>Crypto keys:</guilabel>
</term>
<listitem>
<para>This box lets you specify the secret keys to use for cryptography. To protect
your passwords, only asterisks will be shown when you enter a password. The &kcontrolcenter;
module will automatically try to guess whether you want to set an encryption string
or a hexadecimal number by checking the input length: string keys are usually 5 or 13
characters long (for 64- or 128-Bit key lengths) whereas hex values are 10 or 26 characters
long (please do not put a <quote>0x</quote> in front of hex keys).</para>
</listitem>
</varlistentry>
</variablelist>
<para>Be aware that the built-in cryptography support (named WEP for Wired Equivalent
Privacy) is not very safe at all. See <xref linkend="wep"/> for details.</para>
</sect3>
<sect3 id="config_power">
<title>Power saving settings</title>
<para>The last configuration element that remains to be described is the power management.
When checking the box <guilabel>Enable Power Management</guilabel> a button for the
configuration of the setting will become active. After clicking this button, a new dialog will open
and you will be presented
some options that can help you save energy. The first two input fields named
<guilabel>Sleep timeout</guilabel> and <guilabel>Wakeup period</guilabel>
describe the periodicity of network online times for your wireless &LAN; card. The card will
turn the radio antenna off for the time period (in seconds) specified in
<guilabel>Sleep timeout</guilabel>. Afterwards it will be active for <guilabel>Wakeup
period</guilabel> and will in that time establish the network connection and send/receive
packets that queued up during the sleep time. If no network
connection is found, it will go to sleep again immediately and the cycle begins again. The box named
<guilabel>Receive packets</guilabel> below lets you specify which packets the card
should listen to when awaken. You can either select <guilabel>Unicast only</guilabel>
(which will only let your card listen to packets sent specifically to your card),
<guilabel>Multi/Broadcast only</guilabel> (will only listen to packets sent to multiple
machines and discard packets directed to your card) or <guilabel>Both</guilabel>. Most
people should select the default value <guilabel>Both</guilabel>.</para>
</sect3>
</sect2>
<sect2 id="auto-configuration">
<title>Auto-configuration on &kcontrolcenter; Module startup</title>
<para> If you wish, you can make &kwifimanager; initialize your wireless &LAN; card
whenever you start the &kcontrolcenter; module. To do so, check the box <guilabel>Load
preset configuration on startup</guilabel> and select the configuration you want to use
in the listbox below. If you want to set the card to
these settings at once, push the button <guilabel>Activate
configuration</guilabel>.</para>
</sect2>
<sect2 id="autodetect">
<title>Autodetecting your device</title>
<para>&kwifimanager; needs to know the interface name of your wireless &LAN; card to
apply any settings. You can either enter the information (&eg;
<userinput>eth1</userinput> or<userinput>wlan0</userinput>) manually in the input field
on the right-hand side of<guilabel>Settings apply to interface:</guilabel>, or let &kwifimanager;
auto-detect the interface. To do so, push the button<guibutton>Autodetect
interface</guibutton>. This will perform a scan on all interfaces listed in <filename
class="directory">/proc/net/dev</filename> to find your card. The result of the scan
will show up in the input field beside the button. If the field remains empty, no card was
found. Please note that &kwifimanager; uses the wireless extensions to detect cards.
If you use a card controlled by the wlan-ng package, &kwifimanager; only shows correct
results if your driver has a compatibility layer for the wireless extensions
built-in. In the case that there are multiple wireless LAN cards present on the system,
scanning stops after the first card found. So, if you want to apply the settings to a different
card than the one that was detected during the scan, you need to enter its interface name
by hand.</para>
</sect2>
</sect1>
</chapter>
<chapter id="credits">
<title>License and contributors</title>
<para>Documentation copyright &copy; Stefan
Winter<email>mail@stefan-winter.de</email>.</para> &underFDL; &underGPL;
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
</chapter>
<appendix id="further-information">
<title>Further Information</title>
<para>This appendix contains some extra information of items concerning wireless &LAN; that
are not directly related to &kwifimanager;.</para>
<sect1 id="macaddress">
<title>Notes on the MAC address display in Ad-hoc mode</title>
<para>At first glance, the MAC address in the field <guilabel>Access Point</guilabel> seems to
be wrong in Ad-hoc mode because it changes the first two digits of the MAC address
to<computeroutput>02</computeroutput>. But actually, this is a hardcoded feature in
wireless &LAN; cards.</para>
<para>Usually a card is connected to a <quote>real</quote> access point. Then the correct MAC
address is shown. If you change to Ad-hoc (or <quote>Peer-to-peer</quote>) mode, one of the
computers must act as a server for the other computers. The first computer that enters a
network will set itself as server. So, all other computers connecting to the same Ad-hoc
network will see that first computer as network server. But since this computer is not a
<quote>real</quote> server (that is, it is not a permanently available access point),
clients should be aware that the network they are connecting to is not a permanent one. IEEE
standards for MAC addresses have a place reserved for such (rare) occasions: MAC addresses that are
not globally valid have a bit set to one that shows that these addresses are
<quote>locally administered</quote>. This bit is the second bit in transmit order, and the seventh
bit in logical order and will hence raise the number of the MAC's first digit block from 00 to 02.</para>
<para>You can compare this sort of address to the non-global IP addresses like<quote>192.168.*.*.</quote>
</para>
<para>So, the implementors of wireless networking agreed to give these<quote>virtual</quote>
network servers a MAC address that is within the <quote>locally administered</quote> scope.
To keep this virtual MAC address unique, they used a little trick: they only changed the
first segment of the MAC address of the wireless &LAN; card, and since the remaining
segments are still unique in the world, they have a unique address to use as network
server.</para>
</sect1>
<sect1 id="wep">
<title>Security considerations on <acronym>WEP</acronym> cryptography</title>
<para>
<acronym>WEP</acronym> cryptography is not very secure at all. A paper from
cryptography analysts called the encryption algorithm <quote>kindergarten
cryptography</quote>. Actually, software exists that exploits a huge security hole in the
encryption standard. This software listens to the encrypted network traffic, analyzes it,
and after only a few hours it reveals the password to enter the network in clear text. The
more traffic on the network, the easier it is to find out the password because some packets are
particularly weak because they carry a bad so-called initialisation vector (IV). Recent access
points try to avoid these bad IVs, so it is getting harder to exploit the hole.</para>
<para>If you are truly concerned about your security, do<emphasis>not</emphasis> use plain
<acronym>WEP</acronym>. If you are just setting up a two-computer home network, well, then
I guess<acronym>WEP</acronym> should do.</para>
<para>There are many alternatives to <acronym>WEP</acronym> encryption. Its successors WPA and
WPA2 are better designed and do a better job protecting your traffic, for example by dynamically changing
the keys after a while.
If you dont want to rely on the basic safety of the network link you could use
<acronym>SSH</acronym> to communicate over the network. <acronym>SSH</acronym> is a
program suite that encrypts data with its own algorithm, which is very secure. Another
option is to use <acronym>PPTP</acronym>, the Point-to-Point-Tunneling protocol. However,
even <acronym>PPTP</acronym> seems to be a bit leaky concerning encryption security. And
finally, you could set up an IPSec tunnel (VPN connection) for your encrypted connections. As of yet, this
encryption seems to be very safe and flexible.</para>
</sect1>
</appendix>
<appendix id="compile">
<title>Compilation and Installation</title> &install.intro.documentation;
&install.compile.documentation;</appendix> &documentation.index;</book>