   The following is a list of dependency-related issues encountered when
installing the GscApi library and Plx drivers on various linux distributions.

Dependency Issues
=================


Ubuntu and Mint
===========

        Several additional packages must be installed after installing Ubuntu
from the standard Live CD. Firstly, the Gnu C++ tools are not installed. This
will cause the autoconf configure to fail. Secondly, the ncurses library is not
present, so the Plx makefiles and sample applications will not work. Finally,
the default system shell on Ubuntu 7.10 is dash rather than bash. This breaks
the Plx makefiles. To install the required packages, run the following commands
from a terminal window:

        sudo apt-get install g++
        sudo apt-get install libncurses5-dev

To make bash the default system shell, run the following command from a
terminal window:

        sudo dpkg-reconfigure dash

Follow the instructions to change the default shell to bash.


Suse
=========

	In the Suse 10.1 distribution, the symbolic links libcurses.a and
libcurses.sa are not present, resulting in linking failures for all the Plx
sample applications. The way to resolve this problem is to firstly install
the package ncurses-devel, if it is not already installed. After installing
the ncurses-devel package, create the missing symbolic links with the
following commands:

	cd /usr/lib
	ls -s libncurses.a libcurses.a
	ln -s libncurses.so libcurses.so

After creating the symbolic links, the Plx sample applications should link
without errors.

	To build the Plx driver, the linux kernel headers must be
installed. The kernel headers are in the kernel-sources package. This package
is not installed by default in Suse 10.1. Install the appropriate
kernel-sources package using YaST as follows:

	1. Invoke YaST from the Gnome interface: Applications->System->YaST
	2. From the left pane of the YaST Control Center application, select
	   "Software"
	3. Click on the "Software Management" icon
	4. Select the kernel-sources package for installation and click
	5. Close YaST
	6. cd to the kernel source directory: cd /usr/src/linux
	7. type make cloneconfig && make prepare-all



Fedora
=========

	In the Fedora Core 5 distribution, the kernel headers are not installed
by default. Without the kernel headers, the SIO4 driver cannot be built and
installed. To correct this problem, install the appropriate kernel header
package. The kernel header package must match the version of the running
kernel, or the driver may not load. For the kernel distributed with FC5, the
following command will install the correct kernel header files:

	yum -y install kernel-devel-2.6.15-1.2054

If the kernel has been upgraded to a newer version, then install the kernel
header files for that version of the kernel. The version of the linux
kernel being run can be determined by issuing the command 'uname -r' from
a shell prompt.

        In newer versions of the Fedora Core distrubution, the kernel header
files are included in the default installation. Fedora Core 8, for instance,
does install the kernel header files package by default, so the package will
not have to be downloaded and installed manually as described here.


GenToo 2006.0
=============

	To build the Plx driver, the linux kernel headers must be
installed. The kernel headers are in the gentoo-sources package. This package
is not installed by default in GenToo 2006.0. Install the appropriate
package using the following steps:

	1. Type "emerge -a gentoo-sources"
	2. The emerge package manager will prompt for confirmation that the
	   package should be installed. Make sure the version of the
	   kernel sources matches the version of your running kernel. You can
	   check the version of your running kernel by typing "uname -r". If
	   the versions match, proceed with the installation.
	3. cd to the kernel source directory: cd /usr/src/linux
	4. type "make oldconfig"
	5. type "make modules_install"

