How to Update Your Rust Project for the New NVPTX Baseline in Rust 1.97

Introduction

Starting with Rust 1.97 (expected July 9, 2026), the NVPTX target for NVIDIA GPUs raises its minimum supported PTX ISA version to 7.0 and GPU architecture to SM 7.0. This change improves correctness and performance but drops support for older CUDA drivers (pre-CUDA 11) and pre-Volta GPUs (e.g., Maxwell, Pascal). This guide walks you through adapting your Rust projects to the new baseline.

What You Need

• A Rust environment with rustc 1.97 or later (or a nightly build after the change)
• A CUDA driver version 11.0 or newer (for PTX ISA 7.0 compatibility)
• An NVIDIA GPU with compute capability 7.0 (Volta) or higher
• Access to your project’s Cargo.toml or build configuration files
• Basic familiarity with Rust's --target and -C target-cpu flags

Step-by-Step How-To Guide

Step 1: Check Your Current Rust Version and Target Setup

Run rustc --version to confirm you are on Rust 1.97 or later. If not, update using rustup update stable (or the appropriate channel). Then verify your project uses the nvptx64-nvidia-cuda target either via cargo build --target nvptx64-nvidia-cuda or by setting it in .cargo/config.toml.

Step 2: Identify Your GPU Architecture and CUDA Driver

Determine your GPU’s compute capability (e.g., SM 6.0 for Pascal) using nvidia-smi or the CUDA sample deviceQuery. Check your CUDA driver version with nvidia-smi --query-gpu=driver_version --format=csv,noheader. For the new baseline, you need driver >= 11.0 and SM >= 7.0.

Step 3: Adjust the target-cpu Flag

If you previously specified -C target-cpu=sm_60 (or older), you must update it. Options:
• Remove the flag entirely — Rust 1.97 defaults to sm_70.
• Explicitly set -C target-cpu=sm_70 or newer, e.g., sm_75 for Turing, sm_80 for Ampere.
• If you already use sm_70 or higher, no change is needed.

Step 4: Test Build Compatibility

Run a clean build: cargo build --target nvptx64-nvidia-cuda. Ensure no errors related to PTX ISA version or unsupported architecture appear. If your CUDA driver is older than 11.0, you will get a PTX load error; in that case, upgrade the driver or stick with an older Rust version.

Step 5: Update Host Tooling and Runner Scripts

If you use tools like ptxas (NVIDIA CUDA Compiler) or have scripts that invoke nvcc, make sure they are compatible with PTX ISA 7.0. For example, when compiling PTX to cubin, use ptxas -arch=sm_70 or higher. Also, if your application dynamically loads PTX via the CUDA driver API, ensure the driver version meets the new requirement.

Tips for a Smooth Migration

• Verify GPU compatibility: Use cuda-samples or deviceQuery to confirm your GPU supports compute capability 7.0+.
• Test with a simple kernel before updating your full codebase.
• Use rustup component add rust-src to inspect the NVPTX backend source if you encounter unexpected errors.
• Consider pinning an older Rust version temporarily if your deployment requires pre-Volta GPUs or CUDA 10 drivers.
• Monitor NVIDIA’s documentation for any driver updates that might affect PTX ISA 7.0 support.
• If you need to support both old and new hardware, maintain separate release branches with different Rust toolchains.

For more details, see the official Rust platform support documentation.