nvptx 0.2.3

Rust to PTX compiler using LLVM/NVPTX target
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

nvptx toolchain
======

[![Crate](http://meritbadge.herokuapp.com/nvptx)](https://crates.io/crates/nvptx)
[![docs.rs](https://docs.rs/nvptx/badge.svg)](https://docs.rs/nvptx)
[![CircleCI](https://circleci.com/gh/rust-accel/nvptx.svg?style=shield)](https://circleci.com/gh/rust-accel/nvptx)

Compile Rust into PTX/cubin

Install
-----------

### nvptx command

`nvptx` is a CLI tool to

- Build Rust crate into a PTX/cubin file
- install `accel-nvptx` toolchain (for rustup)

```
cargo install nvptx
```

### accel-nvptx toolchain

`accel-nvptx` is a toolchain name for rustup. It contains `rustc` and runtime libraries with `nvptx64-nvidia-cuda` target.

```
nvptx install
```

This installs `accel-nvptx` toolchain to `rustup` like:

```
$ rustup toolchain list
stable-x86_64-unknown-linux-gnu
nightly-x86_64-unknown-linux-gnu (default)
accel-nvptx
```

This toolchain is built from
  - [rust-accel/rust](https://github.com/rust-accel/rust)
  - [rust-accel/libc](https://github.com/rust-accel/libc)

Build
------

You can build your crate using `accel-nvptx` toolchain into a PTX file

```
nvptx build
```

This consists of following three steps:

- Compile Rust into LLVM bitcode. This step corresponds to the following command:

```
cargo +accel-nvptx build --target nvptx64-nvidia-cuda
```

- Link rlib into a LLVM bitcode using `llvm-link`
- Drop unused bitcode using `opt`
- Compile LLVM bitcode into PTX using `llc`
- (Optional) Convert PTX to cubin using `nvcc`