/*
 * @(#)README.html 1.1 00/10/16
 *
 * Copyright 1994-2000 Sun Microsystems, Inc. All Rights Reserved.
 *
 * This software is the proprietary information of Sun Microsystems, Inc.
 * Use is subject to license terms.
 *
 */

 Test Harness Layout

Directory Structure:


                  Top Directory  :  GenerationGCTest
                  Sub Directories:  Class, Csrc, Include, and Jsrc
                  Files                 :  Makefile, README.html, RULES, RULES.tcl, build.sh, clean.sh,  results.sh.
                                               run.sh, and run.tcl

Subdirectory Structure:


                  Jsrc     :  Contains Java(test) src files
                  Csrc    :  Each java test file will have a corresponding C src file, which lives in this directory
                  Include:  Each C src file will have a corresponding Header file,which lives in this directory
                  Class   :  Contains compiled java classes(.class files)
 

Building and Running The Tests

The tests should be built from the toplevel directory(GenerationGCTest). This builds the special CVM for GenerationGCTest with a flag called  CVM_TEST_GENERATION_GC set to true. By default the following flags are set:
CVM_TARGET=solaris
CVM_DEBUG=false
CVM_OPTIMIZED=false
CVM_PRELOAD_LIB=false
CVM_SYMBOLS=$(CVM_DEBUG)
J2ME_CLASSLIB=cdc
CVM_TEST_GENERATION_GC=true
 
Following are the three ways to build the test. Before building or running the test tornado vars should be sourced in.

source  /micro/tornado2/host/sun4-solaris2/bin/torVars.sh  (or)
source /micro/tornado2/host/sun4-solaris2/bin/torVars.csh
 

For Debug Build:
make CVM_TARGET=solaris/vxworks/linux CVM_DEBUG=true build

For Optimized Build:
make CVM_TARGET=solaris/vxworks/linux CVM_OPTIMIZED=true CVM_SYMBOLS=true build

For DebugMaxRomized Build:
make CVM_TARGET=solaris/vxwork/linux CVM_DEBUG=true  CVM_PRELOAD_LIB=true build
 

But before running the test the following should be done.
  • Source "torvars" depending on which shell is being used
  • Create RULES and RULES.tcl using RULES.sample and RULES.tcl.sample
  • For  vxWorks the target server for the target should've been launched.
  • To run all the tests execute the following command
    make CVM_TARGET=solaris run     --->   For Solaris
    make CVM_TARGET=vxworks run --->   For VxWorks
    make CVM_TARGET=linux run         --->   For Linux
    To summarize the results execute the following command:
    make CVM_TARGET=solaris results     --->   For Solaris
    make CVM_TARGET=vxworks results --->   For VxWorks
    make CVM_TARGET=linux results         --->   For Linux
     

    Logging The Output


                The tests are automatically logged in 3 different log files when run using "make". The log files are:

                      build.log
                      run.log
                      results.log

                build.log:    Will have the compilation log of each test
                run.log:       Will have the run log of each test run.
                results.log: Will have a summary of the number of passes and failures