PUBLIC_API_REPORT.md

Public API Report

(Generated by scripts/public_api_report.sh)

This report summarizes the intended public surface of jvmti-bindings.

Top-Level Exports

1. Agent trait
2. export_agent! macro
3. get_default_callbacks
4. jni re-export (crate::sys::jni)
5. Modules: env, sys, classfile, prelude, advanced (feature-gated)

env Module

Public types:

1. Jvmti
2. JniEnv
3. LocalRef
4. GlobalRef
5. ThreadInfo
6. ThreadGroupInfo
7. MonitorUsage
8. StackInfo
9. ExtensionParamInfo
10. ExtensionFunctionInfo
11. ExtensionEventInfo
12. LocalVariableEntry

sys Module

1. sys::jni - Raw JNI types, constants, and function tables.
2. sys::jvmti - Raw JVMTI types, constants, and function tables.

Note: sys mirrors JNI/JVMTI headers and may grow with new JDK versions.

classfile Module

1. ClassFile and supporting structs/enums for all standard Java 8-27 attributes.
2. ClassFile::parse(bytes) entry point.

prelude Module

Recommended imports for agent authors:

1. Agent, export_agent!, get_default_callbacks
2. env::{Jvmti, JniEnv, LocalRef, GlobalRef}
3. sys::{jni, jvmti}

advanced Module

Feature-gated helpers (disabled by default):

1. advanced::heap_graph (heap-graph feature)

Stability Notes

1. env and top-level exports are intended to be stable.
2. sys is a low-level mirror of JNI/JVMTI C headers.
3. advanced is explicitly allowed to change more rapidly.