Linux Audio

Check our new training course

Loading...
Note: File does not exist in v3.15.
  1#!/bin/sh
  2# SPDX-License-Identifier: GPL-2.0
  3#
  4# Tests whether a suitable Rust toolchain is available.
  5#
  6# Pass `-v` for human output and more checks (as warnings).
  7
  8set -e
  9
 10min_tool_version=$(dirname $0)/min-tool-version.sh
 11
 12# Convert the version string x.y.z to a canonical up-to-7-digits form.
 13#
 14# Note that this function uses one more digit (compared to other
 15# instances in other version scripts) to give a bit more space to
 16# `rustc` since it will reach 1.100.0 in late 2026.
 17get_canonical_version()
 18{
 19	IFS=.
 20	set -- $1
 21	echo $((100000 * $1 + 100 * $2 + $3))
 22}
 23
 24# Check that the Rust compiler exists.
 25if ! command -v "$RUSTC" >/dev/null; then
 26	if [ "$1" = -v ]; then
 27		echo >&2 "***"
 28		echo >&2 "*** Rust compiler '$RUSTC' could not be found."
 29		echo >&2 "***"
 30	fi
 31	exit 1
 32fi
 33
 34# Check that the Rust bindings generator exists.
 35if ! command -v "$BINDGEN" >/dev/null; then
 36	if [ "$1" = -v ]; then
 37		echo >&2 "***"
 38		echo >&2 "*** Rust bindings generator '$BINDGEN' could not be found."
 39		echo >&2 "***"
 40	fi
 41	exit 1
 42fi
 43
 44# Check that the Rust compiler version is suitable.
 45#
 46# Non-stable and distributions' versions may have a version suffix, e.g. `-dev`.
 47rust_compiler_version=$( \
 48	LC_ALL=C "$RUSTC" --version 2>/dev/null \
 49		| head -n 1 \
 50		| grep -oE '[0-9]+\.[0-9]+\.[0-9]+' \
 51)
 52rust_compiler_min_version=$($min_tool_version rustc)
 53rust_compiler_cversion=$(get_canonical_version $rust_compiler_version)
 54rust_compiler_min_cversion=$(get_canonical_version $rust_compiler_min_version)
 55if [ "$rust_compiler_cversion" -lt "$rust_compiler_min_cversion" ]; then
 56	if [ "$1" = -v ]; then
 57		echo >&2 "***"
 58		echo >&2 "*** Rust compiler '$RUSTC' is too old."
 59		echo >&2 "***   Your version:    $rust_compiler_version"
 60		echo >&2 "***   Minimum version: $rust_compiler_min_version"
 61		echo >&2 "***"
 62	fi
 63	exit 1
 64fi
 65if [ "$1" = -v ] && [ "$rust_compiler_cversion" -gt "$rust_compiler_min_cversion" ]; then
 66	echo >&2 "***"
 67	echo >&2 "*** Rust compiler '$RUSTC' is too new. This may or may not work."
 68	echo >&2 "***   Your version:     $rust_compiler_version"
 69	echo >&2 "***   Expected version: $rust_compiler_min_version"
 70	echo >&2 "***"
 71fi
 72
 73# Check that the Rust bindings generator is suitable.
 74#
 75# Non-stable and distributions' versions may have a version suffix, e.g. `-dev`.
 76rust_bindings_generator_version=$( \
 77	LC_ALL=C "$BINDGEN" --version 2>/dev/null \
 78		| head -n 1 \
 79		| grep -oE '[0-9]+\.[0-9]+\.[0-9]+' \
 80)
 81rust_bindings_generator_min_version=$($min_tool_version bindgen)
 82rust_bindings_generator_cversion=$(get_canonical_version $rust_bindings_generator_version)
 83rust_bindings_generator_min_cversion=$(get_canonical_version $rust_bindings_generator_min_version)
 84if [ "$rust_bindings_generator_cversion" -lt "$rust_bindings_generator_min_cversion" ]; then
 85	if [ "$1" = -v ]; then
 86		echo >&2 "***"
 87		echo >&2 "*** Rust bindings generator '$BINDGEN' is too old."
 88		echo >&2 "***   Your version:    $rust_bindings_generator_version"
 89		echo >&2 "***   Minimum version: $rust_bindings_generator_min_version"
 90		echo >&2 "***"
 91	fi
 92	exit 1
 93fi
 94if [ "$1" = -v ] && [ "$rust_bindings_generator_cversion" -gt "$rust_bindings_generator_min_cversion" ]; then
 95	echo >&2 "***"
 96	echo >&2 "*** Rust bindings generator '$BINDGEN' is too new. This may or may not work."
 97	echo >&2 "***   Your version:     $rust_bindings_generator_version"
 98	echo >&2 "***   Expected version: $rust_bindings_generator_min_version"
 99	echo >&2 "***"
100fi
101
102# Check that the `libclang` used by the Rust bindings generator is suitable.
103bindgen_libclang_version=$( \
104	LC_ALL=C "$BINDGEN" $(dirname $0)/rust_is_available_bindgen_libclang.h 2>&1 >/dev/null \
105		| grep -F 'clang version ' \
106		| grep -oE '[0-9]+\.[0-9]+\.[0-9]+' \
107		| head -n 1 \
108)
109bindgen_libclang_min_version=$($min_tool_version llvm)
110bindgen_libclang_cversion=$(get_canonical_version $bindgen_libclang_version)
111bindgen_libclang_min_cversion=$(get_canonical_version $bindgen_libclang_min_version)
112if [ "$bindgen_libclang_cversion" -lt "$bindgen_libclang_min_cversion" ]; then
113	if [ "$1" = -v ]; then
114		echo >&2 "***"
115		echo >&2 "*** libclang (used by the Rust bindings generator '$BINDGEN') is too old."
116		echo >&2 "***   Your version:    $bindgen_libclang_version"
117		echo >&2 "***   Minimum version: $bindgen_libclang_min_version"
118		echo >&2 "***"
119	fi
120	exit 1
121fi
122
123# If the C compiler is Clang, then we can also check whether its version
124# matches the `libclang` version used by the Rust bindings generator.
125#
126# In the future, we might be able to perform a full version check, see
127# https://github.com/rust-lang/rust-bindgen/issues/2138.
128if [ "$1" = -v ]; then
129	cc_name=$($(dirname $0)/cc-version.sh "$CC" | cut -f1 -d' ')
130	if [ "$cc_name" = Clang ]; then
131		clang_version=$( \
132			LC_ALL=C "$CC" --version 2>/dev/null \
133				| sed -nE '1s:.*version ([0-9]+\.[0-9]+\.[0-9]+).*:\1:p'
134		)
135		if [ "$clang_version" != "$bindgen_libclang_version" ]; then
136			echo >&2 "***"
137			echo >&2 "*** libclang (used by the Rust bindings generator '$BINDGEN')"
138			echo >&2 "*** version does not match Clang's. This may be a problem."
139			echo >&2 "***   libclang version: $bindgen_libclang_version"
140			echo >&2 "***   Clang version:    $clang_version"
141			echo >&2 "***"
142		fi
143	fi
144fi
145
146# Check that the source code for the `core` standard library exists.
147#
148# `$KRUSTFLAGS` is passed in case the user added `--sysroot`.
149rustc_sysroot=$("$RUSTC" $KRUSTFLAGS --print sysroot)
150rustc_src=${RUST_LIB_SRC:-"$rustc_sysroot/lib/rustlib/src/rust/library"}
151rustc_src_core="$rustc_src/core/src/lib.rs"
152if [ ! -e "$rustc_src_core" ]; then
153	if [ "$1" = -v ]; then
154		echo >&2 "***"
155		echo >&2 "*** Source code for the 'core' standard library could not be found"
156		echo >&2 "*** at '$rustc_src_core'."
157		echo >&2 "***"
158	fi
159	exit 1
160fi