AUTHORS:
========
Paulo Ferreira (acfpaulo@gmail.com)
Bruno Tome (acfpaulo@gmail.com)

This work is made to complete the final project of Informatique Engineering
course of the Informatique Engineering Department in Institute Polytechnic 
of Tomar.

GENERAL OVERVIEW:
=================
This software allows a GNU/Linux or BSD workstation with KDE or Gnome enviorment 
to operate with Xsupplicant in one user-frendly GUI to proceed authenticate 
process with a RADIUS server using 802.1x and various EAP protocols.  The intended 
use is for simplify the operations in working with Xsupplicant deamon, all this 
in a graphical mode.

This provides a good complement to prepare the network parameters and create config
files before it calls the Xsupplicant deamnon to proceed with authentication 
procedure.

Our test setup for wireless access used a Xsupplicant 1.0.1 version on a Suse Linux 
(9.2 and 9.3) distribution and on a Red Hat (9.0) distribution.

This version of Open1xSupplicant works with next EAP methods:

PEAP with MSCHAPv2
EAP-TTLS with MSCHAPv2
(Only the PEAP method was tested)

We don't test this version of Open1xSupplicant in a wired enviorment.

INSTALLATION:
=============
1. ./configure
2. make
3. make install
4. make clean (optional)

DEPENDENCIES:
=============
All dependencies of Xsupplicant and Qt librarys. We recommend a recent KDE (3.1 or 
grater) or Gnome enviorment to work with this software.
 
PROGRAM USAGE:
==============
open1xsupplicant

The program is started from the command line directly. With this program it's 
possible to configure, what interface you whant to use in authentication 
procedure, what dhcp client deamon you use in your sistem or not use it at all, 
what SSID has in your wireless network, your password and your username (in case of 
PEAP and TTLS with MSCHAPv2), what method you whant to use in authentication 
procedure and the size of your wep key to prepare wireless connection before 
starting Xsupplicant.

NOTE: To Open1xSupplicant work correctly, it must necessary you have root premissions
because the network initialization and raw sockets in Xsupplicant. If you do not have 
root premissions, you can use Open1xSupplicant to create only the config files.