cudf-sys 0.3.1

Native build script for linking against NVIDIA libcudf
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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! Build script for cudf-sys.
//!
//! Locates and links against the pre-built libcudf shared library.
//! Supports two discovery methods:
//!
//! 1. `CUDF_ROOT` environment variable (highest priority)
//! 2. `CONDA_PREFIX` environment variable (conda environment)
//! 3. pkg-config fallback
//!
//! # Required Libraries
//! - libcudf.so (main library)
//! - libcudart.so (CUDA runtime)

use std::env;
use std::path::PathBuf;

fn main() {
    // docs.rs doesn't have libcudf/CUDA installed; skip native linking
    if std::env::var("DOCS_RS").is_ok() {
        return;
    }

    println!("cargo:rerun-if-env-changed=CUDF_ROOT");
    println!("cargo:rerun-if-env-changed=CONDA_PREFIX");
    println!("cargo:rerun-if-env-changed=CUDA_PATH");

    if let Ok(root) = env::var("CUDF_ROOT") {
        link_from_prefix(&root);
        return;
    }

    if let Ok(prefix) = env::var("CONDA_PREFIX") {
        link_from_prefix(&prefix);
        return;
    }

    // Fallback: try pkg-config
    if pkg_config::Config::new()
        .atleast_version("24.0")
        .probe("cudf")
        .is_ok()
    {
        return;
    }

    eprintln!(
        "error: Could not find libcudf. Please set one of:\n\
         - CUDF_ROOT: path to libcudf installation prefix\n\
         - CONDA_PREFIX: path to conda environment with libcudf installed\n\
         - Ensure pkg-config can find cudf"
    );
    std::process::exit(1);
}

fn link_from_prefix(prefix: &str) {
    let prefix = PathBuf::from(prefix);
    let lib_dir = prefix.join("lib");
    let lib64_dir = prefix.join("lib64");
    let include_dir = prefix.join("include");

    // Library search paths
    if lib_dir.exists() {
        println!("cargo:rustc-link-search=native={}", lib_dir.display());
    }
    if lib64_dir.exists() {
        println!("cargo:rustc-link-search=native={}", lib64_dir.display());
    }

    // Link libraries
    println!("cargo:rustc-link-lib=dylib=cudf");

    // RMM (sibling package for pip installations)
    if let Some(parent) = prefix.parent() {
        let rmm_lib = parent.join("librmm").join("lib64");
        if rmm_lib.exists() {
            println!("cargo:rustc-link-search=native={}", rmm_lib.display());
        }
    }

    // CUDA runtime
    if let Ok(cuda_path) = env::var("CUDA_PATH") {
        let cuda_lib = PathBuf::from(&cuda_path).join("lib64");
        if cuda_lib.exists() {
            println!("cargo:rustc-link-search=native={}", cuda_lib.display());
        }
    }
    println!("cargo:rustc-link-lib=dylib=cudart");

    // Export include path for downstream crates
    if include_dir.exists() {
        println!("cargo:include={}", include_dir.display());
    }

    // Export root for downstream
    println!("cargo:root={}", prefix.display());
}