<chapter id="ch4">
<title>Installation</title>

<section>
<title>Prerequisites</title>
<para>
You will need to have the following installed on your system before
 installing xsupplicant: 
</para>

<para> 
OpenSSL - <ulink url="http://www.openssl.org/"/>
</para>

<para>
libpcsclite (For EAP-SIM/EAP-AKA support) - 
<ulink url="http://www.linuxnet.com/"/>
</para>

<para>
Pthreads Support (For EAP-SIM/EAP-AKA support)
</para>

</section>

<section>
<title>Quick Start Guide</title>
<para>
Generally speaking you should be able to type:
<userinput>./configure; make; make install</userinput>
to configure and install the Open1x supplicant.
</para>
<para>
If you run into problems, please read the rest of this chapter.
</para>
</section>

<section>
<title>Running the Configure Script</title>
<para>
The following configuration options are available for xsupplicant:
</para>
<!--REVISIT: Is there an AKA enable flag?-->
<para>
<userinput>--enable-eap-sim </userinput>
- Enables EAP SIM/AKA authentication. (Requires libpcsclite)
</para>
<para>
<userinput>--enable-experimental </userinput>
- Enable the use of experimental features/code.
</para>
<para>
<userinput>--with-ossl-root </userinput>
- Specify the path to the directory holding the OpenSSL source tree.
</para>
<para>
<userinput>--enable-radiator-test </userinput>
- Enable use of the AKA test vectors from Radiator. (Doesn't require a SIM card).
</para>
<para>
<userinput>--enable-static-openssl </userinput>
- Statically link OpenSSL into the xsupplicant binary.
</para>

</section>

<section>
<title>When Things go Wrong.</title>
<para>If you experience a problem building xsupplicant, you should:

<itemizedlist>
<listitem>
<para>Check config.log for any interesting error messages.</para>
</listitem>
<listitem>
<para>Double check the xsupplicant prerequisites.</para>
</listitem>
<listitem>
<para>E-mail the xsupplicant mailing list with a detailed explanation of the 
problem you are experiencing, including any error messages you got and 
please include a copy of your configuration file and any command line 
options you used to run xsupplicant.  The more information you provide to us, 
the easier it will be for us to help you fix your problem.</para>
</listitem>
</itemizedlist>

</para>
</section>

</chapter>
