1. About This Guide

GNAT Pro for Rust is a toolchain for developing software in the Rust programming language. The product provides professional support for a specified version of the Rust toolset; it is not a fork of the Rust programming language or the Rust tools. For more information, see Getting Started with GNAT Pro for Rust.

This guide documents how to install the product and how to build, run, and debug both native and cross-compiled applications. It also shows how to build mixed-language programs (Rust and Ada), which is supported if you have subscriptions to both GNAT Pro for Rust and GNAT Pro for Ada.

GNAT Pro for Rust 26.0w implements version 1.77.2 of the Rust toolchain, for the 2021 edition of the Rust language.

1.1. What This Guide Contains

This guide contains the following chapters:

• Getting Started with GNAT Pro for Rust describes what the product includes, which platform configurations are supported, how to install the product, and how to verify that the installation was successful.

• Developing Mixed Language Projects describes how to build programs that contain code in both Rust and Ada.

Appendices cover additional topics:

• Platform-Specific Information describes product details and program build/debug characteristics that are specific to the various native and embedded target configurations.

• Apache License contains the license for this document.

1.2. What You Should Know before Reading This Guide

This guide assumes a basic familiarity with the Rust language and toolset.

1.3. Related Information

For references to on-line resources for the Rust language and tools, please see Documentation.

1.4. Conventions

• Commands that are entered by the user are shown as preceded by a prompt string comprising the $ character followed by a space.

• Regardless of whether the host platform is Linux or Windows, paths are shown with the / character as the directory separator; e.g., my_package/src/main.rst.