realm_hook 0.1.5

Realm's flexible hooks.
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
31
32
33
34
35
36
37
38
39

//! Pre-connect hook.

use once_cell::unsync::OnceCell;
use libloading::Library;

use super::call_ffi;

static mut DYLIB: OnceCell<Library> = OnceCell::new();

/// Load a dynamic library.
///
/// This is not thread-safe and must be called before interacting with FFI.
pub fn load_dylib(path: &str) {
    unsafe { DYLIB.set(Library::new(path).unwrap()).unwrap() }
}

/// Check if the dynamic library is loaded.
pub fn is_loaded() -> bool {
    unsafe { DYLIB.get().is_some() }
}

/// Get the required length of first packet.
pub fn first_pkt_len() -> u32 {
    call_ffi!(DYLIB, b"realm_first_pkt_len" => unsafe extern "C" fn() -> u32)
}

/// Get the index of the selected remote peer.
///
/// Remote peers are defined in `remote`(default) and `extra_remotes`(extended),
/// where there should be at least 1 remote peer whose idx is 0.
///
/// idx < 0 means **ban**.
/// idx = 0 means **default**.
pub fn decide_remote_idx(idx: i32, buf: *const u8) -> i32 {
    call_ffi!(
        DYLIB, b"realm_decide_remote_idx" => unsafe extern "C" fn(i32, *const u8) -> i32,
        idx, buf
    )
}