windows-elf-loader 0.1.2

Be capable of loading the elf dynamic library on Windows.
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
40
41
42

# windows-elf-loader

Be capable of loading the elf dynamic library on Windows. This crate is implemented based on [rust-elfloader](https://github.com/weizhiao/rust-elfloader). The dynamic library used in example is also derived from [rust-elfloader](https://github.com/weizhiao/rust-elfloader).

# Example

```
$ cargo run -r --example load 
```
```rust
use std::ffi::CStr;
use elf_loader::image::{SyntheticSymbol, SyntheticModule};
use windows_elf_loader::WinElfLoader;

fn main() {
    extern "sysv64" fn print(s: *const i8) {
        let s = unsafe { CStr::from_ptr(s).to_str().unwrap() };
        println!("{}", s);
    }
    // Symbols required by dynamic library liba.so
    let host = SyntheticModule::new(
        "__host",
        [SyntheticSymbol::function("print", print as *const ())],
    );
    let mut loader: WinElfLoader = WinElfLoader::new();
    // Load and relocate dynamic library liba.so
    let liba = loader
        .load_file(r".\crates\windows-elf-loader\example_dylib\liba.so")
        .unwrap()
        .relocator()
        .scope([host])
        .relocate()
        .unwrap();
    // Call function a in liba.so
    let f = unsafe { liba.get::<extern "sysv64" fn() -> i32>("a").unwrap() };
    println!("{}", f());
}
```

# Note

Here are the translated notes:
* You need to manually handle the ELF dynamic library dependencies.
* Do not directly use syscalls within ELF dynamic libraries.
* ABI conversion is required at the calling boundary between ELF dynamic libraries and Windows programs, as demonstrated in the example.