Software

Introduction

For the purpose of these instructions, we assume that the ELDK distribution
used to build the tests is located at /opt/tmp/eldk-tst, the target
filesystem used for testing (mounted as NFS root on the targst) is at
/opt/tmp/eldk-tst/ppc_8xx, and the tests are run on a ppc_8xx target system.
The ELDK testsuite is based on the test scripts provided by the "crosstool"
package.

The testsuite uses the "crosstool" build area under the
/opt/tmp/eldk-tst/usr/src/denx/BUILD/crosstool-0.35 directory and the
crosstool libraries and binaries that have been installed by the build
process under the /opt/tmp/eldk-tst/var/tmp directory.

If you set-up is different in the above aspects, you will need to make
obvious adjustments to the commands shown below.

It should be noted that ELDK distribution mentioned above may be
any PowerPC ELDK version: to build the testsuite, only the rpmbuild utility
from the ELDK distribution is used, and tests running on the target do not
require any of the target-based libraries and binaries. The entire testuite
filesystem is created by the test scripts at run-time in the home directory
of a special "test" user. During the testing, this created at run-time
filesystem becomes the "root" directory for all the tests running on the
target (i.e. the test suite "changes root" to that newly created filesystem).

Prerequisites to Run the Test Suite

Make necessary preparations on the host.

Set the TCP protocol management option "tcp_tw_recycle" to 1:

bash$ echo 1>/proc/sys/net/ipv4/tcp_tw_recycle

That adjustment is required to allow for many short-living RSH connections to
be established in a limited period of time, as it is done by the test script.

Set up the testing area on the target filesystem, as shown below (in
particular, you need to add the "test" user and setup the "/home/test"
directory):

To enable "rsh" and "rlogin" access to the target,
edit the /etc/xinetd.d/rsh
and /etc/xinetd.d/rlogin files on the target filesystem and change the record
"disable = yes" to "disable = no" . Also, add the following record to
/etc/xinetd.d/rsh :

"cps = 200 5"

To disable the password protection for the "rsh" and "rlogin" access to the
target, execute the following commands while in the root directory on the
target filesystem, replacing the <userid> with the actual name of the user
who will be starting the test scripts on the host:

The result of the above commands will be the build area of GCC and glibc,
and the toolchain and the libraries installed under
"/opt/tmp/eldk-tst/var/tmp/crosstool-0.35-root".
This build area will be used
for building the test applications.

After the crosstool build is complete, change directory to the
"crosstool" build area and install the "chrootshell" auxiliary program,
which was created during the building of the "crosstool" package,
to the target filesystem:

The "runtests.sh" script will set up the necessary variables and run the main
"crosstest.sh" script, which is a part of the "crosstool" source RPM.
The "crosstool.sh" script, in its turn, will prepare the test environment
on the target filesystem ("chroot jail"), build the tests, transfer them to
the target using the "rsh" command, and run them remotely.

The "sum" file contains the record of the every test run and
(for the GCC and binutils tests) the testing summary in the form of
"NN tests passed/YY tests failed" at the end of the file.
For the glibc tests, no testing summary
is provided.
For failed glibc tests, the logged error output has the form of
"Error n", where "n" is the decimal error code.
The following commands can be
used to get the summary of the glibc test results: