# Copyright Princeton University 1992
#
# ICKP Public code
# Jim Plank
# Princeton University
# 
# $Source: /mahogany/homes/plank/ickp/pub/examples/hpart/RCS/README,v $
# $Revision: 1.0.1.0 $
# $Date: 1992/09/30 13:31:45 $


This directory contains the following files:

hpart.c -- An host program which coordinates the nodes running `part',
           as well as recovers from checkpoints.

part.c -- An iPSC/2 and iPSC/860 program for finding the best 
          partition of a bunch of floating point numbers.

mkpar.c -- A program for creating the input file for part.c.

makefile -- The makefile for part.c.  If you set LIBDIR to be the
            directory containing the ickp libraries/etc, 
            then the makefile can be used as follows:

	make depend
		This tweaks the end of the makefile so that .c files
		have the correct dependencies to the proper .h files.

	make cxckp
		This will make the checkpointable iPSC/2 executable "part" 
		from part.c and the proper files from LIBDIR.
            
	make rxckp
		This will make the checkpointable iPSC/860 executable "part" 
		from part.c and the proper files from LIBDIR/860.
            
	make clean
		This will remove all .o files, and "part".

To see checkpointing in progress:

Try 

  hpart in500 out500 x

where on in iPSC/2, x = 20000, and on an iPSC/860, x = 2000

After eight seconds, the program will checkpoint.  When this is
over, type CNTL-C to kill the host program, and then "killcube"
to kill the node program.  There should be a file .part.cntl, 
which denotes that there is a saved checkpoint of the program.
Retype 

  hpart in500 out500 x

and hpart should restart the program from the checkpoint and 
continue.  After the next checkpoint, the program should finish
normally, and all checkpoints/checkpointing information should be
deleted.

