19 or visit www.oracle.com if you need additional information or have any
  20 questions.
  21 
  22 
  23 
  24 DESCRIPTION
  25 
  26 The purpose of this library is gathering diagnostic information on test
  27 failures and timeouts. The library runs platform specific tools, which are
  28 configured in the way described below. The collected data will be available
  29 in HTML format next to JTR files.
  30 
  31 The library uses JTHarness Observer and jtreg TimeoutHandler extensions points.
  32 
  33 DEPENDENCES
  34 
  35 The library requires jtreg 4b13+ and JDK 7+.
  36 
  37 BUILDING
  38 
  39 To build a library, one should simply run make with 'JTREG_HOME' and
  40 'JAVA_HOME' environment variables set. 'JAVA_HOME' should contain path to JDK,
  41 'JTREG_HOME' -- path to jtreg.
  42 
  43 'image/lib/jtregFailureHandler.jar' is created on successful build.
  44 
  45 CONFIGURATION
  46 
  47 Properties files are used to configure the library. They define which actions
  48 to be performed in case of individual test failure or timeout. Each platform
  49 family uses its own property file (named '<platform>.properties'). For platform
  50 independent actions, 'common.properties' is used.
  51 
  52 Actions to be performed on each failure are listed in 'environment' property.
  53 Extra actions for timeouts are listed in 'onTimeout'.
  54 
  55 Each action is defined via the following parameters:
  56  - 'javaOnly' -- run the action only for java applications, false by default
  57  - 'app' -- an application to run, mandatory parameter
  58  - 'args' -- application command line arguments, none by default
  59  - 'params' -- a structure which defines how an application should be run,
  60  described below
  61 
  62 Actions listed in 'onTimeout' are "patterned" actions. Besides the parameters
  63 listed above, they also have 'pattern' parameter -- a string which will be

  19 or visit www.oracle.com if you need additional information or have any
  20 questions.
  21 
  22 
  23 
  24 DESCRIPTION
  25 
  26 The purpose of this library is gathering diagnostic information on test
  27 failures and timeouts. The library runs platform specific tools, which are
  28 configured in the way described below. The collected data will be available
  29 in HTML format next to JTR files.
  30 
  31 The library uses JTHarness Observer and jtreg TimeoutHandler extensions points.
  32 
  33 DEPENDENCES
  34 
  35 The library requires jtreg 4b13+ and JDK 7+.
  36 
  37 BUILDING
  38 
  39 The library is built using the top level build-test-failure-handler target and
  40 is automatically included in the test image and picked up by hotspot and jdk
  41 test makefiles.


  42 
  43 CONFIGURATION
  44 
  45 Properties files are used to configure the library. They define which actions
  46 to be performed in case of individual test failure or timeout. Each platform
  47 family uses its own property file (named '<platform>.properties'). For platform
  48 independent actions, 'common.properties' is used.
  49 
  50 Actions to be performed on each failure are listed in 'environment' property.
  51 Extra actions for timeouts are listed in 'onTimeout'.
  52 
  53 Each action is defined via the following parameters:
  54  - 'javaOnly' -- run the action only for java applications, false by default
  55  - 'app' -- an application to run, mandatory parameter
  56  - 'args' -- application command line arguments, none by default
  57  - 'params' -- a structure which defines how an application should be run,
  58  described below
  59 
  60 Actions listed in 'onTimeout' are "patterned" actions. Besides the parameters
  61 listed above, they also have 'pattern' parameter -- a string which will be