LFC Performance Tests
Caitriana Nicholson
16/03/2005
=====================

- The LFC performance tests come in 2 parts: the C code and the Perl 
scripts which wrap them. The C programs can be called from the command 
line or the Perl scripts modified to suit the user's requirements.

C code
------

- Program is called with the number of operations and any other arguments 
specified on the command line. To see what a particular test does and what 
the possible arguments are, check the comments at the top of each file. 

Example: create_files.c
create_files [-d dir] [-f number_of_files] [-t number_of_threads]
             [-n nesting_level] [-r use relative path]
             [-x use transactions] [-c number of inserts per transaction]
If no arguments are given, defaults are set for each of these. The 
default directory, however, will probably not exist in most LFC instances.

Perl scripts
------------

- These call the C program a number of times with various arguments and 
output the (processed) results to a file, e.g. calling create_files with 
an increasing number of client threads, or number of files. Other users 
will need to modify the given filenames and paths, as well as modifying 
the arguments used, to suit themselves.

List of Tests
-------------
Here is a list of the C programs and their matching Perl scripts:

create_files.c		--->  insert_times.pl
create_files_rate.c	--->  insert_rate.pl
delete_files.c		--->  delete_times.pl
delete_files_rate.c	--->  delete_rate.pl
query_files.c		--->  query_files.pl
query_files_rate.c	--->  query_rate.pl
read_files.c		--->  read_files.pl
symlinks.c		--->  symlinks.pl
nested_symlinks.c	--->  nested_symlinks.pl
stat_replicas.c		--->  stat_replicas.pl
