Rust PTX Builder

Build Status Build status Current Version Docs

New Release: 0.5 🎉

Say goodbye to proxy crate approach.

This allows us to use single-source CUDA in binary-only crates (ones without lib.rs). New approach might seem a bit hacky with overriding Cargo behavior and enforcing --crate-type dylib, but in the end, development workflow became much more convinient.

Development breaking changes

The crate does not provide a default panic_handler anymore. From now on, it either up to a user, or other crates (e.g. coming soon ptx-support crate).

Next workaround should work in common cases, although it doesn't provide any panic details in runtime: ``` rust

![feature(core_intrinsics)]

[panic_handler]

unsafe fn breakpointpanichandler(: &::core::panic::PanicInfo) -> ! { core::intrinsics::breakpoint(); core::hint::unreachableunchecked(); } ```

API Breaking Changes - less boilerplate code

build.rs script was never so compact and clear before: ``` rust use ptxbuilder::error::Result; use ptxbuilder::prelude::*;

fn main() -> Result<()> { CargoAdapter::withenvvar("KERNELPTXPATH").build(Builder::new(".")?); } ```

Documentation improvements

This release comes with a significant documentation improvement! Check on docs.rs :)

Purpose

The library should facilitate CUDA development with Rust. It can be used in a cargo build script of a host crate, and take responsibility for building device crates.

Features

  1. Obviously, device crates building.
  2. Announcing device crates sources to cargo, so it can automatically rebuild after changes.
  3. Reporting about missing tools, for example: [PTX] Unable to get target details [PTX] [PTX] caused by: [PTX] Command not found in PATH: 'ptx-linker'. You can install it with: 'cargo install ptx-linker'.

Prerequirements

The library depends on ptx-linker and xargo. Both can be installed from crates.io: cargo install xargo cargo install ptx-linker

Windows users!

Unfortunately, due to rustc-llvm-proxy#1 MSVS targets are not supported yet.

You might face similar errors: Unable to find symbol 'LLVMContextCreate' in the LLVM shared lib

For now the only solution is to use GNU targets.

Usage

First, you need to specify a build script in host crate's Cargo.toml and declare the library as a build-dependency: toml [build-dependencies] ptx-builder = "0.5"

Then, typical build.rs might look like: ``` rust use ptxbuilder::error::Result; use ptxbuilder::prelude::*;

fn main() -> Result<()> { CargoAdapter::withenvvar("KERNELPTXPATH").build(Builder::new(".")?); } ```