Dylink

Overview

Dylink is a framework for lazily evaluating shared libraries such as .dll files for windows and .so files for unix. When functions are loaded they are evaluated through a thunk for first time calls, which loads the function from it's respective library. Proceeding calls after initialization have no overhead or additional branching checks, as the thunk is replaced by the loaded function.

Supported platforms

Dylink has been implemented for all major platforms, but has only been locally tested on Windows and Linux.

| Win64 | Linux | MacOS | Unix(other) | |:-----:|:-----:|:--------:|:-----------:| | YES | YES | Untested | Untested |

Usage

Add this to your Cargo.toml

toml [dependencies] dylink = "0.2"

Example

Below is a basic working example on how to use the macro. For windows, the .dll file extension is optional, but still recommended.

```rust use dylink::dylink;

[dylink(name = "Kernel32.dll")]

extern "stdcall" { fn GetLastError() -> u32; fn SetLastError(_: u32); }

fn main() { unsafe { SetLastError(52); println!("{}", GetLastError()); } } ```

Output:

text 52

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.