Chapter 1. Rust Toolset
1.1. About Rust Toolset
Rust Toolset is a Red Hat offering for developers on the Red Hat Enterprise Linux platform. It provides the Rust programming language compiler rustc, the cargo build tool and dependency manager, the cargo-vendor plug-in, the rustfmt tool, and required libraries.
Rust Toolset is distributed as a part of Red Hat Developer Tools for Red Hat Enterprise Linux 7 and is available as a module in Red Hat Enterprise Linux 8.
The following components are available as a part of Rust Toolset:
| Package | Version | Description |
|---|---|---|
| rust | 1.31.1 | A Rust compiler front-end for LLVM. |
| cargo | 1.31.0 | A build system and dependency manager for Rust. |
| cargo-vendor | 0.1.22 | A cargo subcommand to vendor crates.io dependencies. |
| rustfmt | 1.0.0 | A tool for automatic formatting of Rust code. |
1.2. Compatibility
Rust Toolset is available for Red Hat Enterprise Linux 7 and Red Hat Enterprise Linux 8 on the following architectures:
- The 64-bit Intel and AMD architectures
- The 64-bit ARM architecture
- The IBM Power Systems architecture
- The little-endian variant of IBM Power Systems architecture
- The IBM Z Systems architecture
1.3. Getting Access to Rust Toolset on Red Hat Enterprise Linux 7
Rust Toolset is an offering that is distributed as a part of the Red Hat Developer Tools content set, which is available to customers with deployments of Red Hat Enterprise Linux 7. In order to install Rust Toolset, enable the Red Hat Developer Tools and Red Hat Software Collections repositories by using the Red Hat Subscription Management and add the Red Hat Developer Tools GPG key to your system.
Enable the
rhel-7-variant-devtools-rpmsrepository:# subscription-manager repos --enable rhel-7-variant-devtools-rpmsReplace variant with the Red Hat Enterprise Linux system variant (
serverorworkstation).NoteWe recommend developers to use Red Hat Enterprise Linux Server for access to the widest range of development tools.
Enable the
rhel-variant-rhscl-7-rpmsrepository:# subscription-manager repos --enable rhel-variant-rhscl-7-rpmsReplace variant with the Red Hat Enterprise Linux system variant (
serverorworkstation).Add the Red Hat Developer Tools key to your system:
# cd /etc/pki/rpm-gpg # wget -O RPM-GPG-KEY-redhat-devel https://www.redhat.com/security/data/a5787476.txt # rpm --import RPM-GPG-KEY-redhat-devel
Once the subscription is attached to the system and repositories enabled, you can install Red Hat Rust Toolset as described in Section 1.4, “Installing Rust Toolset”.
Additional Resources
- For more information on how to register your system using Red Hat Subscription Management and associate it with subscriptions, see the Red Hat Subscription Management collection of guides.
- For detailed instructions on subscription to Red Hat Software Collections, see the Red Hat Developer Toolset User Guide, Section 1.4. Getting Access to Red Hat Developer Toolset.
1.4. Installing Rust Toolset
Rust Toolset is distributed as a collection of RPM packages that can be installed, updated, uninstalled, and inspected by using the standard package management tools that are included in Red Hat Enterprise Linux. Note that a valid subscription that provides access to the Red Hat Developer Tools content set is required in order to install Rust Toolset on a Red Hat Enterprise Linux 7 system. For detailed instructions on how to associate your Red Hat Enterprise Linux 7 system with an appropriate subscription and get access to Rust Toolset, see Section 1.3, “Getting Access to Rust Toolset on Red Hat Enterprise Linux 7”.
Before installing Rust Toolset, install all available Red Hat Enterprise Linux updates.
Install all of the components included in Rust Toolset for your operating system:
On Red Hat Enterprise Linux 7, install the rust-toolset-1.31 package:
# yum install rust-toolset-1.31
On Red Hat Enterprise Linux 8, install the rust-toolset module:
# yum module install rust-toolset
This installs all development and debugging tools, and other dependent packages to the system. Notably, Rust Toolset has a dependency on Clang and LLVM Toolset.
1.5. Additional Resources
A detailed description of the Rust programming language and all its features is beyond the scope of this book. For more information, see the resources listed below.
Installed Documentation
-
The package rust-toolset-1.31-rust-doc installs the The Rust Programming Language book and API documentation in HTML format to
/opt/rh/rust-toolset-1.31/root/usr/share/doc/rust/html/index.html.
Online Documentation
- Rust documentation — The upstream Rust documentation.
- Rust documentation overview — An extended overview of documentation related to Rust.
