rustup-check

Check for all updates

$ rustup check

rustup check [OPTIONS]

-h, --help
    Display help information and usage details for the rustup check command.

-v, --verbose
    Enable verbose output, providing more detailed information about the update check process and results.

-q, --quiet
    Suppress non-essential messages and warnings, resulting in a quieter output during the check.

--version
    Print the version information of the rustup-check utility being used.

--no-self-update
    A global rustup option that prevents rustup from attempting to update itself before executing the check command.

rustup check is a subcommand of the rustup toolchain manager, which is the official and recommended way to install and manage Rust toolchains on various operating systems. This command systematically scans all installed Rust toolchains (e.g., stable, beta, nightly) and their associated components (such as rustc, cargo, rust-std, and rust-docs) to determine if newer versions or updates are available. It provides a concise summary of pending updates for both the toolchains themselves and for the rustup utility.

It is important to note that rustup check is purely informational. It identifies and reports available updates but does not automatically perform any installations or upgrades. To apply the detected updates, users typically need to explicitly run the rustup update command. This informational capability makes rustup check an invaluable tool for Rust developers to stay informed about the latest releases and available patches without committing to an immediate system-wide upgrade.

1. Internet Connection Required: This command requires an active internet connection to query official Rust update servers for the latest toolchain and component versions.

2. Informational Only: It only reports available updates and does not perform any actual installations or upgrades. To apply updates, you must explicitly run rustup update.

3. Command Invocation: While the prompt explicitly mentions "rustup-check", the standard and common user-facing invocation is typically "rustup check" as a subcommand of the main rustup utility.

rustup fetches update information from official Rust project servers, primarily static.rust-lang.org, ensuring reliable and secure update data.

This command is safe to run frequently as it only reads update availability information and does not alter the existing Rust installation, making it ideal for regular monitoring without side effects.

rustup was developed to simplify and standardize the installation and management of Rust toolchains (stable, beta, nightly releases) across various operating systems, quickly becoming the official installer for Rust. The check subcommand was introduced as a non-intrusive mechanism to allow Rust developers to monitor for available updates. This functionality empowers users to stay informed about new Rust releases and component updates without immediately triggering an upgrade, giving them control over when to perform actual updates. Its continuous development is tightly integrated with the broader Rust project's release cycle.

rustup(1), rustup-update(1), rustup-show(1), cargo(1), rustc(1)