jvmti-bindings 2.2.0

Complete JNI and JVMTI bindings for Rust with zero dependencies by default. Build JVM agents in pure Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# Dynamic Attach (Agent_OnAttach)

This crate supports dynamic attach via the `Agent_OnAttach` entry point.
Implement `Agent::on_attach` and use `export_agent!` — the macro generates
the correct native entry points automatically.

## Minimal Example

```rust,ignore
use jvmti_bindings::prelude::*;

#[derive(Default)]
struct AttachLogger;

impl Agent for AttachLogger {
    fn on_attach(&self, vm: *mut jni::JavaVM, options: &str) -> jni::jint {
        println!("[AttachLogger] attached with options: {}", options);
        let _jvmti = Jvmti::new(vm).expect("get JVMTI");
        jni::JNI_OK
    }
}

export_agent!(AttachLogger);
```

## Notes

- `on_attach` is called when the agent is loaded via the JVM Attach API.
- You can request capabilities and enable JVMTI events inside `on_attach`.
- Thread and JNI safety rules still apply (see `docs/SAFETY.md`).