======================================================================   
                        Setup notes for the
             Intel(R) Embedded Graphics Display Driver GUI (IEGDGUI) 
                             for Linux
======================================================================   
   
Contents   
========   
- Supported Linux distributions
- IEGDGUI components
- QT Library Availability
- Setting up QT library for use
- Software Licenses
- Legal / Disclaimers



Supported Linux distributions
=============================
The IEGDGUI has been developed on and validated on 
Red Hat Linux 9, Fedora Core 2 and SUSE SLES 9.

IEGDGUI support is limited to this Linux distribution
on the following chipsets that are running the Intel(R)
Embedded Graphics Display Driver (version 3.4 and above).

       Intel(R) 945G Chipset
       Intel(R) 945GM Chipset
       Intel(R) 915GM Chipset
       Intel(R) 915GV Chipset
       Intel(R) 855GME Chipset
       Intel(R) 852GM Chipset
       Intel(R) 852GME Chipset
       Intel(R) 845GV Chipset
       Intel(R) 815 Chipset
       Intel(R) 815E Chipset

Although it may be able to support other Linux distributions
such as Red Hat Linux 8, this is not officially supported
at this time.



IEGDGUI Components   
====================   
In order to run the IEGDGUI, you need to ensure that 
the XServer has been configured to use the above mentioned 
version of the Intel(R) Embedded Graphics Display Driver.

You also need the IEGDGUI binary (file name "IEGDGUI"). 
This binary needs to be mode changed to be executable. 
This binary comes with the Intel(R) Embedded Graphics 
Display Driver package.

Finally, you will also need a runtime QT library that 
is required by the IEGDGUI to run.



QT Library Availability
======================
In order to run the IEGDGUI binary, the runtime QT library, 
is required to be installed onto the system.

The QT library should be freely available on the Linux distribution
you are running the IEGDGUI on. This of course depends on the
distribution's support for the application built based on 
QT development kit.

As of the time of the creation of this document, this QT library
comes freely with the Red Hat 9 Linux distribution, the 
Fedora Core 2 distribution and the SUSE SLES 9 distribution.

For Red Hat 9, this library is available at the following path:

     /usr/lib/qt-3.1/lib.

For Fedora Core 2, this library is available at the following path:

    /usr/lib/qt-3.3/lib
    
For SUSE SLES 9, this library is available at the following path:

    /usr/lib/qt3/lib

If it is not available, the library can be retrieved from the following
website:

    http://www.trolltech.com



Setting up QT library for use
=============================

The following environment variables must be setup.

    LD_LIBRARY_PATH=/usr/X11R6/lib:/usr/lib/qt-3.1/lib (for Red Hat 9)
    LD_LIBRARY_PATH=/usr/X11R6/lib:/usr/lib/qt-3.3/lib (for Fedora Core 2)
    LD_LIBRARY_PATH=/usr/X11R6/lib:/usr/lib/qt3/lib (for SUSE SLES 9)                                                        

For Red Hat 9, the following 6 symbolic links must be created:

	1. libqt-mt.so.3 
	2. libqt-mt.so.3.1 
	3. libqt.so 
	4. libqt.so.3 
	5. libqt.so.3.1 
	6. libqt.so.3.1.1 

The steps above, provided in the form of command line script:

	export LD_LIBRARY_PATH=/usr/X11R6/lib:/usr/lib/qt-3.1/lib
	cd /usr/lib/qt-3.1/lib 
	ln -s libqt-mt.so.3.1.1 libqt-mt.so.3 
	ln -s libqt-mt.so.3.1.1 libqt-mt.so.3.1
	ln -s libqt-mt.so.3.1.1 libqt.so
	ln -s libqt-mt.so.3.1.1 libqt.so.3
	ln -s libqt-mt.so.3.1.1 libqt.so.3.1 
	ln -s libqt-mt.so.3.1.1 libqt.so.3.1.1

For Fedora Core 2, the following 4 symbolic links must be created:

	1. libqt.so 
	2. libqt.so.3 
	3. libqt.so.3.3 
	4. libqt.so.3.3.2

The steps above, provided in the form of command line script:

	export LD_LIBRARY_PATH=/usr/X11R6/lib:/usr/lib/qt-3.3/lib
	cd /usr/lib/qt-3.3/lib 
	ln -s libqt-mt.so libqt.so
	ln -s libqt-mt.so.3 libqt.so.3
	ln -s libqt-mt.so.3.3 libqt.so.3.3 
	ln -s libqt-mt.so.3.3.2 libqt.so.3.3.2

For SUSE SLES 9, the following 3 symbolic links must be created:

	1. libqt.so.3 
	2. libqt.so.3.3 
	3. libqt.so.3.3.1

The steps above, provided in the form of command line script:

	export LD_LIBRARY_PATH=/usr/X11R6/lib:/usr/lib/qt3/lib
	cd /usr/lib/qt3/lib 
	ln -s libqt-mt.so.3 libqt.so.3
	ln -s libqt-mt.so.3.3 libqt.so.3.3 
	ln -s libqt-mt.so.3.3.1 libqt.so.3.3.1

At this point, the IEGDGUI should be able to launch and run.


Software Licenses   
=================   
   
The Intel(R) Embedded Graphics Display Driver GUI for Linux* is subject 
to the terms of the license agreement located in the LICENSE file 
of the Intel(R) Embedded Graphics Display Driver distribution package.   
   

  
Legal / Disclaimers   
===================   
  
Copyright (C) 2003, 2004, 2005 Intel Corporation.  All rights reserved.   
   
Intel Corporation assumes no responsibility for errors or omissions in this    
document.  Nor does Intel make any commitment to update the information    
contained herein.   
   
* Other product and corporate names may be trademarks of other companies and   
are used only for explanation and to the owners' benefit, without intent to    
infringe.   
   
======================================================================
