https://github.com/stardust-enterprises/jvmti-rs
(WIP) Interact with the JVM Tooling Interface with idiomatic Rust.
https://github.com/stardust-enterprises/jvmti-rs
java jvmti rust
Last synced: 30 days ago
JSON representation
(WIP) Interact with the JVM Tooling Interface with idiomatic Rust.
- Host: GitHub
- URL: https://github.com/stardust-enterprises/jvmti-rs
- Owner: stardust-enterprises
- License: isc
- Created: 2022-05-28T09:35:28.000Z (about 3 years ago)
- Default Branch: trunk
- Last Pushed: 2022-06-10T13:56:51.000Z (about 3 years ago)
- Last Synced: 2025-02-17T16:52:30.439Z (4 months ago)
- Topics: java, jvmti, rust
- Language: Rust
- Homepage:
- Size: 8.79 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# jvmti-rs
Interact with the JVM Tooling Interface with idiomatic Rust.
## why?
This work is based on [x4e's jvm-rs][jvm-rs] project, which is feature-rich but
doesn't offer the greatest syntax for idiomatic Rust programming.
### comparaisons
With jvm-rs
```rs
#[no_mangle]
pub unsafe extern "system" fn JNI_OnLoad(jvm: *mut JavaVM, _res: &mut c_void) -> c_int {
// Getting jvmti instance
let mut ptr: *mut c_void = null_mut();
let result = (*(*jvm)).GetEnv.unwrap()(jvm, &mut ptr, JVMTI_VERSION_1_2 as jint);
if result != JNI_OK as jint {
panic!("Couldn't get JVMTI!");
}
let jvmti = ptr.cast::();
// Getting loaded classes
let mut class_count: jint = 0;
let mut classes_ptr: *mut jclass = null_mut();
let error = (*(*jvmti)).GetLoadedClasses.unwrap()(jvmti, &mut class_count, &mut classes_ptr);
if error != jvmtiError_JVMTI_ERROR_NONE {
panic!("Cound't get classes!");
}
// transform classes_ptr to array
// actually do stuff...
}
```
With jvmti-rs
```rs
#[no_mangle]
pub unsafe extern "system" fn JNI_OnLoad(jvm: *mut JavaVM, _res: &mut c_void) -> c_int {
// Getting jvmti instance
let jvmti = JvmtiInterface::from_vm(jvm, JVMTI_VERSION_1_2);
// Getting loaded classes
let result = jvmti.get_loaded_classes();
match result {
Ok(classes) => {
for class in classes {
// Do stuff
}
},
Err(e) => panic!(e);
}
}
```
## how to use
Everything revolves around the `jvmti_rs::JvmtiInterface` struct;
you'd need a reference to a `jvm_rs::jni::JavaVM` to construct it:
```rs
let mut java_vm: JavaVM = get_current_vm();
let jvmti = JvmtiInterface::from_vm(&mut java_vm);
```
From there you have access to all the JVMTI calls that are available from
[jvm-rs][jvm-rs] without the verbose syntax.
## license
This project is licensed under the [ISC License][blob-license]
[jvm-rs]: https://github.com/x4e/jvm-rs "jvm-rs github page"
[blob-license]: https://github.com/stardust-enterprises/jvmti-rs/blob/trunk/LICENSE