pmpx-plugin 0.3.0

Defines the pmpx plugin contract and the C ABI that carries it across dlopen.
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

//! Inject the compile-time rustc version and target triple for `pmpx_plugin::abi` to fill into
//! `PmpxPluginV1`.
//!
//! `rustc --version` is not something that can be asked at runtime, so ask once at compile time
//! and pin the answer into the binary. These constants get linked into every plugin, so a plugin
//! does not need a build.rs of its own.

use std::process::Command;

fn main() {
    println!("cargo:rerun-if-changed=build.rs");
    // Switching toolchains has to re-run this, otherwise the previous toolchain's version number
    // gets pinned.
    println!("cargo:rerun-if-env-changed=RUSTC");

    let rustc = std::env::var("RUSTC").unwrap_or_else(|_| "rustc".to_string());

    // Write "unknown" when it cannot be asked -- this field is only for diagnostics, and failing
    // to get it should not break the build. The tests accept that value for the same reason, so
    // "the build tolerated it" and "the test suite passes" cannot disagree.
    let version = Command::new(&rustc)
        .arg("--version")
        .output()
        .ok()
        .and_then(|out| String::from_utf8(out.stdout).ok())
        // Only the first line: `rustc --version` prints one, and a second line would be cut in
        // half by the `cargo:rustc-env` line format and never noticed.
        .and_then(|s| s.lines().next().map(str::to_string))
        .map(|s| s.trim().to_string())
        .filter(|s| !s.is_empty())
        .unwrap_or_else(|| "unknown".to_string());

    let target = std::env::var("TARGET").unwrap_or_else(|_| "unknown".to_string());

    println!("cargo:rustc-env=PMPX_BUILD_RUSTC={version}");
    println!("cargo:rustc-env=PMPX_BUILD_TARGET={target}");
}