NetSolve Tutorials
==================

This directory contains several tutorials which should demonstrate the use of
NetSolve. It should be a starting point for new users to write their own
programs and also shows how to enhance the capabilities of NetSolve by adding
own functions to the repository. The tutorials do not depend on each other and
can be performed in any order. However, if you are completly new to NetSolve
it is recommended to perform the tutorials in the order described below, since
some explanations are given in more detail in the first sections.

The first three examples include code sections for blocking and non-blocking
calls as well as the task-farming feature. The last example (sparse)
demonstrates how to include an existing application into NetSolve and uses only
blocking codes, although it should be easy with the information from the
previous tutorials to build non-blocking and farming calls too.

If some additional software is required to build the example a link to the
sources is provided. The examples are designed that they can be performed in
userspace (this includes the additional software that may be necessary).

Before you start a tutorial make sure that NetSolve is properply installed by
running C_test and farm_test. If these functions do not work consult the
NetSolve User Guide and fix the issue.


The following tutorials are included:

basic - demonstrates the use of the following basic data types: int, double,
        char; includes server library, PDF and client program

file - demonstrates the way of sending files with NetSolve to remotely execute
       programs; includes server library, PDF and client program

matrix - demonstrates the handling of matrices and vectors when performing a
         matrix - vector multiplication; includes client program

sparse - demonstrates how to include your own software library on the basis of
         an example which uses a solver for sparse linear systems, ie it uses
         the sparse matrix format; includes server library, PDF and client
         program


Last modified: March 3rd, 2003
Christoph L. Fabianek, fabianek@cs.utk.edu
