Macro cargo_emit::rustc_link_search

macro_rules! rustc_link_search {
    (to : $stream : expr, $path : expr $(,) ?) => { ... };
    (to : $stream : expr, $path : expr => $kind : expr $(,) ?) => { ... };
    (to : $stream : expr, $($path : expr $(=> $kind : expr) ?), + $(,) ?) => { ... };
    ($path : expr $(,) ?) => { ... };
    ($path : expr => $kind : expr $(,) ?) => { ... };
    ($($path : expr $(=> $kind : expr) ?), + $(,) ?) => { ... };
}

Tells Cargo to pass $path to the compiler as a -L flag.

This is equivalent to:

println!("cargo:rustc-link-search=[$kind=]$path");

Examples

Useful for telling the linker where a path can be found.

cargo_emit::rustc_link_search!(
    "path/to/ssl/lib/", // same as `=> "all"`
    "path/to/ruby/lib/" => "native",
);

or, in case you want it to emit to a custom stream:

let mut stdout = std::io::stdout();
cargo_emit::rustc_link_search!(
    to: stdout,
    "path/to/ssl/lib/", // same as `=> "all"`
    "path/to/ruby/lib/" => "native",
);