MPI Data-Type Tools v3.00 Beta 2

Main Page URL : http://www.nist.gov/itl/div895/savg/auto/

--------------------

In this directory, you will find the source file  for the release of :
AutoLink 3.00 [beta 2]

--------------------

Program information :
 AutoMap / AutoLink 3.00 [beta 2]

   Version 1.1 (January 1997) :
     Eric Baland (AutoMap) & Koen Vrielink AutoLink)
   Version 2.0 (July 1997) :
     Jasper Peeters (AutoLink)
   Version 2.1 (July 1998)
     Martial MICHEL (AutoMap & AutoLink : Concept & Programming)
     & Delphine GOUJON (AutoLink : Concept)
   Version 2.11 (November 1998)
     Martial MICHEL
     & Thibaut ROUFFINEAU (Testing)
   Version 2.11.1 (January 1999)
     Martial MICHEL
   Version 2.11.2 (February 1999)
     Martial MICHEL
   Version 2.20 (June 1999)
     Martial MICHEL
   Version 3.00 [beta 1] (April 2000)
     Martial MICHEL
     & Olivier NICOLAS (Testing & AutoMap : Concept)
   Version 3.00 [beta 2] (August 2000)
     Martial MICHEL
     & Olivier NICOLAS (Stress Testing)

--------------------

Basic Description of the files :
-----
 o al_common.h
   File that  allow  the user  to  set  all the  internal  settings of
AutoLink.

 o al_internals.c
   Define all the internal data-types used by AutoLink algorithm.

 o al_internals.h
   Define the prototypes for the internal  data-types used by AutoLink
algorithm.

 o autolink.inc
   Contains  the  internal     definitions  of  the   functions    and
sub-functions defining the AutoLink user available functions.

 o Makefile.base
   Is a template Makefile for  users to adapt to their  use to be able
to use AutoMap and AutoLink easily.

 o README
   The file you are reading right now :)

--------------------

Detailed description of some file use:

 o al_common.h
   In this file you  will be able to find  some "#define" that you may
want to adapt to your particular use :
   - AL_HASH_TABLE_PRIME_NUMBER is the prime number used to define the
internal number of  cells   available to  one of  AutoLink's  internal
data-type.  Some rules  to the setting of  this variable are specified
before the definition of  this value. This  number is used to dispatch
efficiently already  traversed  addresses, so  the more  links you may
have to traverse, the largest distribution possible is advised.
   - AL_SARRAY_SIZE is the size  of one another of AutoLink's internal
data-type.  This  set the minimum size  of  a dynamically extended two
dimensional array, used  to store addresses  of traversed or  restored
elements.
   -  AL_DEFAULTMAXPACKET   is  the   maximal  size (and/or   minimal,
depending of the size  of the data-type) of  the packet to be sent for
each data-type.    Its influence  on  the  efficiency of  AutoLink  is
related to the implementation of MPI  that you are  using. The size is
defined in bytes.

   In  this file is also defined  trace generation entries  to see the
way AutoLink  behaves. This is  done by setting  (uncommenting mostly)
the   define  "_AL_DEBUG_".  Once  this  done,   you may want  to  set
"_AL_DBG_LVL" with an "|" (or) combination of the following values :
   - _AL_NODEBUG   : Basic level that should always be set
   - _AL_DBG_FNAME : Print the function name entered
   - _AL_DBG_FINT :  Tell  the basic  functions done  by  the function
entered
   - _AL_DBG_DATA  : Tell the status of the processed data
   - _AL_DBG_STEP  : Follow the step of some "for" functions
   And also should  debug mode be set, you  may want to set (uncomment
and set) the define "_AL_DEBUG_FILENAME"  to a file name for  AutoLink
to output its trace into a "filename.nodenumber" file.
   - _AL_DBG_BENCH :  For  AutoLink to   generate its  own  benchmarks
(required if  using  the al_bench.pl  script  in any  other mode  than
"user")
   -  _AL_DBG_UBENCH : For user   to make AutoLink  generate their log
entry, adding  Time  stamp  and   Packet size  (required  to  use  the
al_bench.pl script in "user" mode)
   - _AL_DBG_REQUEST  :  To follow all  MPI_Request operations. Mostly
useful  for deadlock debugging, this option  is added as a convenience
for bug reports.
