index.docbook

Linux/Unix下无限网卡配置和管理程序

<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY kwifimanager "KWiFiManager">
  <!ENTITY kappname "&kwifimanager;">
  <!ENTITY % English "INCLUDE"> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book id="kwifimanager" lang="&language;">

<bookinfo>
<title>The &kwifimanager;-handbook</title>

<authorgroup>
<author> <firstname>Stefan</firstname> <surname>Winter</surname>
<affiliation> <address><email>[e-mail]</email>
</address> </affiliation> </author>
</authorgroup>

<legalnotice>&FDLNotice;</legalnotice>

<copyright>
<year>2002</year>
<holder>Stefan Winter</holder>
</copyright>

<!-- Date and version information of the documentation
Don't forget to include this last date and this last revision number, we
need them for translation coordination !
Please respect the format of the date (DD/MM/YYYY) and of the version
(Major.minor.lesser), it could be used by automation scripts -->

<date>2002-06-10</date>
<releaseinfo>1.0.0</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para>The &kwifimanager; suite can be used to configure and monitor wireless LAN cards.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>wireless</keyword>
<keyword>Wi-Fi</keyword>
<keyword>wlan</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 PC-Card under the K Desktop Environment. It provides
information about your current connection and lets you set up up to
four independent configurations which can be loaded automatically
when KDE is started. KWifiManager supports every wireless LAN card
that uses the wireless extensions interface. This includes many cards
that are supported by the wlan-ng project.
</para>
</chapter>
<chapter id="compile">
<title>Compilation and Installation</title>

<para>
The KWiFiManager suite is distributed as RPM, source RPM and as a tarball.
It can even be found in the Debian distribution.
If you have a RedHat or SuSE System, the easiest way to install KWiFiManager
is to obtain the RPM and let the RedHat Package Manager install it.
</para>
<para>
If you use source RPMs or a tarball, several prerequisits are necessary:
<itemizedlist>
<listitem><para>
an installed Qt toolkit (version 3.0.3+)
</para></listitem>
<listitem><para>
KDE 3.x installed
</para></listitem>
<listitem><para>
glibc2.2
</para></listitem>
</itemizedlist>
</para>
<para>
When these three preconditions are met, a standard

<userinput>./configure</userinput>
<userinput>make</userinput>
<userinput>make install</userinput>

should compile and install KWiFiManager from the tarball without problems.
</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
set configuration and to display connection quality and access
points.
</para><para>
The main application is launched by either typing "kwifimanager" at the
command prompt of a console window or via the K Menu, where it is
located in the "Applications" group. Finally, a third way to launch
KWiFiManager is by clicking once on the panel applet (see section 3.2).
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 four major parts:
</para>

<sect3 id="signalquality">
<title>Signal quality display (left-hand side)</title>
<para>
On the left-hand upper part you can see the quality and type of the active
connection. The most upper icon displays the general state of the wireless
network via a set of pictograms:
<itemizedlist>
<listitem><para>
a PC-Card with a question tag means that no card was detected
</para></listitem>
<listitem><para>
a single laptop means that a PC-Card is inserted and in Infrastructure mode, but there is no radio signal from access-points. The card is out of range.
</para></listitem>
<listitem><para>
a laptop that is connected to a white box 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
</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 the following way:
[ signal strength in dBm - noise level in dBm ]
If your card is out of range, the value is 0; if no card is inserted it
will show N/A.
</para>
</sect3>
<sect3 id="speed">
<title>Connection speed</title>
<para>
A 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.
</para>
</sect3>
<sect3 id="current-config">
<title>Current configuration (right-hand side)</title>
<para>
On the right-hand side, you can find information about your card
configuration. It displays the following information:
<itemizedlist>
<listitem><para>
the network with which the card is connected / tries to connect ("Searching for network: " or "Connected to network: ")
</para></listitem>
<listitem><para>
the MAC adress of the access point to which the card is connected.</para><para>
If the card is in Infrastructure mode but out of range, the value
"44:44:44:44:44:44" is displayed to indicate that no connection
is established.</para><para>
In Ad-Hoc mode, the field shows an adress that is associated with one of the cards in the Ad-Hoc network.
It differs from the MAC address of that card in the second digit: it is raised by the value of "2".
Example: Your card is the first card that enters Ad-Hoc mode. Then all other cards entering Ad-Hoc mode
will see your MAC-address, slightly modified: instead of "00:xx:yy:zz:aa:bb" it will show "02:xx:yy:zz:aa:bb".
This behaviour is intentional.
</para></listitem>
<listitem><para>
on most cards, the frequency on which the card is transmitting data and
the corresponding channel number is displayed.
</para></listitem>
<listitem><para>
your local IP address, if available.
</para></listitem>
<listitem><para>
encryption status (only if you have started KWiFiManager as root)
</para></listitem>
</itemizedlist>
</para>
</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 adresses
with a corresponding information. An example for such a list can be found
in</para><para>
$KDEDIR/share/apps/kwifimanager/locations/DE_BW_Karlsruhe_University.loc
</para><para>
If you want to set up a new list, simply copy your file into the directory
</para><para>
$KDEDIR/share/apps/kwifimanager/locations/
</para><para>
It will be automatically parsed at the next start of KWiFiManager after a successful installation. By the way: if you have a list and want
to have it included in future releases of KWiFiManager, simply send it to
<email>[e-mail]</email>
</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>
</sect2>
<sect2 id="config-edit">
<title>Configuration Editor</title>
<para>
By selecting "Config", "Configuration Editor" you are taken to the control
center module of KWiFiManager (see the appropriate chapter for details). In case
you are not the root user, a window will pop up requesting the root password.
This is because the configuration module contains sensitive information
such as the encryption key for WEP cryptography.
</para>
</sect2>
<sect2 id="misc">
<title>Miscellaneous</title>
<para>