Skip to content

docs(guide): warn that the default NvvmArch fails silently on pre-Turing GPUs #411

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
helenkwok wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(guide): warn that the default NvvmArch fails silently on pre-Turing GPUs #411

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions guide/src/guide/getting_started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -198,6 +198,13 @@ The compile target determines which GPU features are available. See the [Compute
Gating](./compute_capabilities.md) guide for details on writing code that adapts to different GPU
capabilities.

> **Note:** `CudaBuilder`'s default target is `NvvmArch::Compute75` (Turing and later). If your
> GPU is older than Turing (Maxwell, Pascal, or Volta — e.g. a GTX 10-series card), the PTX
> produced by the default will fail to load at runtime with a generic `InvalidPtx` error and no
> indication that the architecture is the problem. Set `.arch(...)` explicitly to match your GPU,
> e.g. `.arch(cuda_builder::NvvmArch::Compute61)` for a GTX 1070. You can find your GPU's compute
> capability with `nvidia-smi --query-gpu=compute_cap --format=csv`.

### `src/main.rs`

The final file contains `main`, which ties everything together.
Expand Down