Testing Scope

1. What's in scope

Testing scope: hotspot jimage calls defined in the Hotspot header jimage.hpp.

2. What's out of scope

Tests Inventory

1. Existing tests

• jdk/test/jdk/internal/jimage/JImageReadTest.java - Unit test for libjimage JIMAGE_Open/Read/Close

2. New tests

• Various positive test scenarios with basic functionality checking
• Various negative test scenarios with incorrect/corrapted/non-existent data (both jimage file and income parameters)

See Feature Cases, Tests and Test Cases section.

3. Deprecated tests

• Previous implementation tests (see https://bugs.openjdk.java.net/browse/JDK-8077725) - already removed.

Feature Cases, Tests and Test Cases

TBD

• JIMAGE_Open
  • positive: multiple open of the same jimage file
  • negative: open non-existing jimage file
  • negative: open empty jimage file
  • negative: open corrupted (incorrect magic) jimage file
• JIMAGE_Close
  • positive: multiple closes with one image handle
  • negative: close with wrong handle
• JIMAGE_PackageToModule
  • positive: non-existing package
  • negative: null package value
  • negative: incorrect/null handle value
• JIMAGE_FindResource
  • negative: corrupted/null handle
  • negative: wrong/null module name
  • negative: wrong/null class/resource name
  • negative: incorrect/null version
  • negative: null instead of size array
• JIMAGE_GetResource
  • negative: corrupted/null handle
  • negative: corrupted/null location ref
  • negative: insufficient size of data buffer (zero bytes, non-zero less than resource size, null)
  • negative: wrong size value (negative, zero, positive but less than real size)
• JIMAGE_ResourceIterator
  • negative: call JIMAGE_Resources with corrupted/null handle
  • negative: call JIMAGE_Resources with null array for names
  • NOTE: class ImageNativeSubstrate.java does not provide more access to iterator

Success criteria

Describe criteria which would be used to consider the testing successful. Some examples are provided below. Please note that these are only examples of success metrics. Pick what's applicable, add other ones which apply better. Update "result" column at the end of test development for future reference

Dependencies

No dependencies.

Risks

No risks.