vosen/ZLUDA · error

Failed to open {}: {}

Error message

Failed to open {}: {}

What it means

zluda build-script panic in check_lfs_file: bin/nvcudart_hybrid64.dll could not be opened. This DLL is tracked as a Git LFS object, so the frequent cause is LFS objects not being fetched (leaving a pointer stub or missing file), which would otherwise break the CUDA runtime shim build silently.

Source

Thrown at zluda/build.rs:25

        let dll_path = "bin/nvcudart_hybrid64.dll";
        println!("cargo:rerun-if-changed={}", dll_path);
        check_lfs_file(dll_path);
    }
    let git = Gix::builder().sha(false).build();
    Emitter::default()
        .add_instructions(&git)
        .unwrap()
        .emit()
        .unwrap();
}

fn check_lfs_file(bc_path: &str) {
    use std::fs::File;
    use std::io::Read;

    let mut magic = [0u8; 2];
    File::open(bc_path)
        .unwrap_or_else(|e| panic!("Failed to open {}: {}", bc_path, e))
        .read_exact(&mut magic)
        .unwrap_or_else(|e| panic!("Failed to read {}: {}", bc_path, e));
    assert!(
        &magic == b"MZ",
        "{} is a git lfs stub and not the actual file. Run `git lfs pull` to fetch it",
        bc_path
    );
}

View on GitHub (pinned to 9c8b43f242)

Solutions

  1. Run `git lfs install && git lfs pull` to obtain the real DLL
  2. Confirm zluda/bin/nvcudart_hybrid64.dll exists and is the actual binary (MZ header), not an LFS pointer
  3. Re-clone the repo with LFS support if the object store is broken
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at zluda/build.rs:25 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of vosen/ZLUDA@9c8b43f242 (2026-09-06). Data as JSON: /api/errors/532bf065fa231adb. Report an issue: GitHub.