[thirdparty/kernel/linux.git] / scripts / rust_is_available.sh

#!/bin/sh
# SPDX-License-Identifier: GPL-2.0
#
# Tests whether a suitable Rust toolchain is available.

set -e

min_tool_version=$(dirname $0)/min-tool-version.sh

# Convert the version string x.y.z to a canonical up-to-7-digits form.
#
# Note that this function uses one more digit (compared to other
# instances in other version scripts) to give a bit more space to
# `rustc` since it will reach 1.100.0 in late 2026.
get_canonical_version()
{
	IFS=.
	set -- $1
	echo $((100000 * $1 + 100 * $2 + $3))
}

# Print a reference to the Quick Start guide in the documentation.
print_docs_reference()
{
	echo >&2 "***"
	echo >&2 "*** Please see Documentation/rust/quick-start.rst for details"
	echo >&2 "*** on how to set up the Rust support."
	echo >&2 "***"
}

# Print an explanation about the fact that the script is meant to be called from Kbuild.
print_kbuild_explanation()
{
	echo >&2 "***"
	echo >&2 "*** This script is intended to be called from Kbuild."
	echo >&2 "*** Please use the 'rustavailable' target to call it instead."
	echo >&2 "*** Otherwise, the results may not be meaningful."
	exit 1
}

# If the script fails for any reason, or if there was any warning, then
# print a reference to the documentation on exit.
warning=0
trap 'if [ $? -ne 0 ] || [ $warning -ne 0 ]; then print_docs_reference; fi' EXIT

# Check that the expected environment variables are set.
if [ -z "${RUSTC+x}" ]; then
	echo >&2 "***"
	echo >&2 "*** Environment variable 'RUSTC' is not set."
	print_kbuild_explanation
fi

if [ -z "${BINDGEN+x}" ]; then
	echo >&2 "***"
	echo >&2 "*** Environment variable 'BINDGEN' is not set."
	print_kbuild_explanation
fi

if [ -z "${CC+x}" ]; then
	echo >&2 "***"
	echo >&2 "*** Environment variable 'CC' is not set."
	print_kbuild_explanation
fi

# Check that the Rust compiler exists.
if ! command -v "$RUSTC" >/dev/null; then
	echo >&2 "***"
	echo >&2 "*** Rust compiler '$RUSTC' could not be found."
	echo >&2 "***"
	exit 1
fi

# Check that the Rust bindings generator exists.
if ! command -v "$BINDGEN" >/dev/null; then
	echo >&2 "***"
	echo >&2 "*** Rust bindings generator '$BINDGEN' could not be found."
	echo >&2 "***"
	exit 1
fi

# Check that the Rust compiler version is suitable.
#
# Non-stable and distributions' versions may have a version suffix, e.g. `-dev`.
rust_compiler_output=$( \
	LC_ALL=C "$RUSTC" --version 2>/dev/null
) || rust_compiler_code=$?
if [ -n "$rust_compiler_code" ]; then
	echo >&2 "***"
	echo >&2 "*** Running '$RUSTC' to check the Rust compiler version failed with"
	echo >&2 "*** code $rust_compiler_code. See output and docs below for details:"
	echo >&2 "***"
	echo >&2 "$rust_compiler_output"
	echo >&2 "***"
	exit 1
fi
rust_compiler_version=$( \
	echo "$rust_compiler_output" \
		| sed -nE '1s:.*rustc ([0-9]+\.[0-9]+\.[0-9]+).*:\1:p'
)
if [ -z "$rust_compiler_version" ]; then
	echo >&2 "***"
	echo >&2 "*** Running '$RUSTC' to check the Rust compiler version did not return"
	echo >&2 "*** an expected output. See output and docs below for details:"
	echo >&2 "***"
	echo >&2 "$rust_compiler_output"
	echo >&2 "***"
	exit 1
fi
rust_compiler_min_version=$($min_tool_version rustc)
rust_compiler_cversion=$(get_canonical_version $rust_compiler_version)
rust_compiler_min_cversion=$(get_canonical_version $rust_compiler_min_version)
if [ "$rust_compiler_cversion" -lt "$rust_compiler_min_cversion" ]; then
	echo >&2 "***"
	echo >&2 "*** Rust compiler '$RUSTC' is too old."
	echo >&2 "***   Your version:    $rust_compiler_version"
	echo >&2 "***   Minimum version: $rust_compiler_min_version"
	echo >&2 "***"
	exit 1
fi
if [ "$rust_compiler_cversion" -gt "$rust_compiler_min_cversion" ]; then
	echo >&2 "***"
	echo >&2 "*** Rust compiler '$RUSTC' is too new. This may or may not work."
	echo >&2 "***   Your version:     $rust_compiler_version"
	echo >&2 "***   Expected version: $rust_compiler_min_version"
	echo >&2 "***"
	warning=1
fi

# Check that the Rust bindings generator is suitable.
#
# Non-stable and distributions' versions may have a version suffix, e.g. `-dev`.
rust_bindings_generator_output=$( \
	LC_ALL=C "$BINDGEN" --version 2>/dev/null
) || rust_bindings_generator_code=$?
if [ -n "$rust_bindings_generator_code" ]; then
	echo >&2 "***"
	echo >&2 "*** Running '$BINDGEN' to check the Rust bindings generator version failed with"
	echo >&2 "*** code $rust_bindings_generator_code. See output and docs below for details:"
	echo >&2 "***"
	echo >&2 "$rust_bindings_generator_output"
	echo >&2 "***"
	exit 1
fi
rust_bindings_generator_version=$( \
	echo "$rust_bindings_generator_output" \
		| sed -nE '1s:.*bindgen ([0-9]+\.[0-9]+\.[0-9]+).*:\1:p'
)
if [ -z "$rust_bindings_generator_version" ]; then
	echo >&2 "***"
	echo >&2 "*** Running '$BINDGEN' to check the bindings generator version did not return"
	echo >&2 "*** an expected output. See output and docs below for details:"
	echo >&2 "***"
	echo >&2 "$rust_bindings_generator_output"
	echo >&2 "***"
	exit 1
fi
rust_bindings_generator_min_version=$($min_tool_version bindgen)
rust_bindings_generator_cversion=$(get_canonical_version $rust_bindings_generator_version)
rust_bindings_generator_min_cversion=$(get_canonical_version $rust_bindings_generator_min_version)
if [ "$rust_bindings_generator_cversion" -lt "$rust_bindings_generator_min_cversion" ]; then
	echo >&2 "***"
	echo >&2 "*** Rust bindings generator '$BINDGEN' is too old."
	echo >&2 "***   Your version:    $rust_bindings_generator_version"
	echo >&2 "***   Minimum version: $rust_bindings_generator_min_version"
	echo >&2 "***"
	exit 1
fi
if [ "$rust_bindings_generator_cversion" -gt "$rust_bindings_generator_min_cversion" ]; then
	echo >&2 "***"
	echo >&2 "*** Rust bindings generator '$BINDGEN' is too new. This may or may not work."
	echo >&2 "***   Your version:     $rust_bindings_generator_version"
	echo >&2 "***   Expected version: $rust_bindings_generator_min_version"
	echo >&2 "***"
	warning=1
fi

# Check that the `libclang` used by the Rust bindings generator is suitable.
#
# In order to do that, first invoke `bindgen` to get the `libclang` version
# found by `bindgen`. This step may already fail if, for instance, `libclang`
# is not found, thus inform the user in such a case.
bindgen_libclang_output=$( \
	LC_ALL=C "$BINDGEN" $(dirname $0)/rust_is_available_bindgen_libclang.h 2>&1 >/dev/null
) || bindgen_libclang_code=$?
if [ -n "$bindgen_libclang_code" ]; then
	echo >&2 "***"
	echo >&2 "*** Running '$BINDGEN' to check the libclang version (used by the Rust"
	echo >&2 "*** bindings generator) failed with code $bindgen_libclang_code. This may be caused by"
	echo >&2 "*** a failure to locate libclang. See output and docs below for details:"
	echo >&2 "***"
	echo >&2 "$bindgen_libclang_output"
	echo >&2 "***"
	exit 1
fi

# `bindgen` returned successfully, thus use the output to check that the version
# of the `libclang` found by the Rust bindings generator is suitable.
#
# Unlike other version checks, note that this one does not necessarily appear
# in the first line of the output, thus no `sed` address is provided.
bindgen_libclang_version=$( \
	echo "$bindgen_libclang_output" \
		| sed -nE 's:.*clang version ([0-9]+\.[0-9]+\.[0-9]+).*:\1:p'
)
if [ -z "$bindgen_libclang_version" ]; then
	echo >&2 "***"
	echo >&2 "*** Running '$BINDGEN' to check the libclang version (used by the Rust"
	echo >&2 "*** bindings generator) did not return an expected output. See output"
	echo >&2 "*** and docs below for details:"
	echo >&2 "***"
	echo >&2 "$bindgen_libclang_output"
	echo >&2 "***"
	exit 1
fi
bindgen_libclang_min_version=$($min_tool_version llvm)
bindgen_libclang_cversion=$(get_canonical_version $bindgen_libclang_version)
bindgen_libclang_min_cversion=$(get_canonical_version $bindgen_libclang_min_version)
if [ "$bindgen_libclang_cversion" -lt "$bindgen_libclang_min_cversion" ]; then
	echo >&2 "***"
	echo >&2 "*** libclang (used by the Rust bindings generator '$BINDGEN') is too old."
	echo >&2 "***   Your version:    $bindgen_libclang_version"
	echo >&2 "***   Minimum version: $bindgen_libclang_min_version"
	echo >&2 "***"
	exit 1
fi

# If the C compiler is Clang, then we can also check whether its version
# matches the `libclang` version used by the Rust bindings generator.
#
# In the future, we might be able to perform a full version check, see
# https://github.com/rust-lang/rust-bindgen/issues/2138.
cc_name=$($(dirname $0)/cc-version.sh $CC | cut -f1 -d' ')
if [ "$cc_name" = Clang ]; then
	clang_version=$( \
		LC_ALL=C $CC --version 2>/dev/null \
			| sed -nE '1s:.*version ([0-9]+\.[0-9]+\.[0-9]+).*:\1:p'
	)
	if [ "$clang_version" != "$bindgen_libclang_version" ]; then
		echo >&2 "***"
		echo >&2 "*** libclang (used by the Rust bindings generator '$BINDGEN')"
		echo >&2 "*** version does not match Clang's. This may be a problem."
		echo >&2 "***   libclang version: $bindgen_libclang_version"
		echo >&2 "***   Clang version:    $clang_version"
		echo >&2 "***"
		warning=1
	fi
fi

# Check that the source code for the `core` standard library exists.
#
# `$KRUSTFLAGS` is passed in case the user added `--sysroot`.
rustc_sysroot=$("$RUSTC" $KRUSTFLAGS --print sysroot)
rustc_src=${RUST_LIB_SRC:-"$rustc_sysroot/lib/rustlib/src/rust/library"}
rustc_src_core="$rustc_src/core/src/lib.rs"
if [ ! -e "$rustc_src_core" ]; then
	echo >&2 "***"
	echo >&2 "*** Source code for the 'core' standard library could not be found"
	echo >&2 "*** at '$rustc_src_core'."
	echo >&2 "***"
	exit 1
fi
Commit	Line	Data
78521f33 MO	1	#!/bin/sh
	2	# SPDX-License-Identifier: GPL-2.0
	3	#
	4	# Tests whether a suitable Rust toolchain is available.
78521f33 MO	5
	6	set -e
	7
	8	min_tool_version=$(dirname $0)/min-tool-version.sh
	9
	10	# Convert the version string x.y.z to a canonical up-to-7-digits form.
	11	#
	12	# Note that this function uses one more digit (compared to other
	13	# instances in other version scripts) to give a bit more space to
	14	# `rustc` since it will reach 1.100.0 in late 2026.
	15	get_canonical_version()
	16	{
	17	IFS=.
	18	set -- $1
	19	echo $((100000 * $1 + 100 * $2 + $3))
	20	}
	21
aac284b1 MO	22	# Print a reference to the Quick Start guide in the documentation.
	23	print_docs_reference()
	24	{
	25	echo >&2 "***"
	26	echo >&2 "*** Please see Documentation/rust/quick-start.rst for details"
	27	echo >&2 "*** on how to set up the Rust support."
	28	echo >&2 "***"
	29	}
	30
e90db552 MO	31	# Print an explanation about the fact that the script is meant to be called from Kbuild.
	32	print_kbuild_explanation()
	33	{
	34	echo >&2 "***"
	35	echo >&2 "*** This script is intended to be called from Kbuild."
	36	echo >&2 "*** Please use the 'rustavailable' target to call it instead."
	37	echo >&2 "*** Otherwise, the results may not be meaningful."
	38	exit 1
	39	}
	40
aac284b1 MO	41	# If the script fails for any reason, or if there was any warning, then
	42	# print a reference to the documentation on exit.
	43	warning=0
	44	trap 'if [ $? -ne 0 ] \|\| [ $warning -ne 0 ]; then print_docs_reference; fi' EXIT
	45
e90db552 MO	46	# Check that the expected environment variables are set.
	47	if [ -z "${RUSTC+x}" ]; then
	48	echo >&2 "***"
	49	echo >&2 "*** Environment variable 'RUSTC' is not set."
	50	print_kbuild_explanation
	51	fi
	52
	53	if [ -z "${BINDGEN+x}" ]; then
	54	echo >&2 "***"
	55	echo >&2 "*** Environment variable 'BINDGEN' is not set."
	56	print_kbuild_explanation
	57	fi
	58
	59	if [ -z "${CC+x}" ]; then
	60	echo >&2 "***"
	61	echo >&2 "*** Environment variable 'CC' is not set."
	62	print_kbuild_explanation
	63	fi
	64
78521f33 MO	65	# Check that the Rust compiler exists.
78521f33 MO	66	if ! command -v "$RUSTC" >/dev/null; then
d824d2f9 MY	67	echo >&2 "***"
	68	echo >&2 "*** Rust compiler '$RUSTC' could not be found."
	69	echo >&2 "***"
78521f33 MO	70	exit 1
	71	fi
	72
	73	# Check that the Rust bindings generator exists.
	74	if ! command -v "$BINDGEN" >/dev/null; then
d824d2f9 MY	75	echo >&2 "***"
	76	echo >&2 "*** Rust bindings generator '$BINDGEN' could not be found."
	77	echo >&2 "***"
78521f33 MO	78	exit 1
	79	fi
	80
	81	# Check that the Rust compiler version is suitable.
	82	#
	83	# Non-stable and distributions' versions may have a version suffix, e.g. `-dev`.
f2955228 MO	84	rust_compiler_output=$( \
	85	LC_ALL=C "$RUSTC" --version 2>/dev/null
	86	) \|\| rust_compiler_code=$?
	87	if [ -n "$rust_compiler_code" ]; then
	88	echo >&2 "***"
	89	echo >&2 "*** Running '$RUSTC' to check the Rust compiler version failed with"
	90	echo >&2 "*** code $rust_compiler_code. See output and docs below for details:"
	91	echo >&2 "***"
	92	echo >&2 "$rust_compiler_output"
	93	echo >&2 "***"
	94	exit 1
	95	fi
78521f33	96	rust_compiler_version=$( \
f2955228	97	echo "$rust_compiler_output" \
7cd6a3e1	98	\| sed -nE '1s:.rustc ([0-9]+\.[0-9]+\.[0-9]+).:\1:p'
78521f33	99	)
bc60c930 MO	100	if [ -z "$rust_compiler_version" ]; then
	101	echo >&2 "***"
	102	echo >&2 "*** Running '$RUSTC' to check the Rust compiler version did not return"
	103	echo >&2 "*** an expected output. See output and docs below for details:"
	104	echo >&2 "***"
	105	echo >&2 "$rust_compiler_output"
	106	echo >&2 "***"
	107	exit 1
	108	fi
78521f33 MO	109	rust_compiler_min_version=$($min_tool_version rustc)
	110	rust_compiler_cversion=$(get_canonical_version $rust_compiler_version)
	111	rust_compiler_min_cversion=$(get_canonical_version $rust_compiler_min_version)
	112	if [ "$rust_compiler_cversion" -lt "$rust_compiler_min_cversion" ]; then
d824d2f9 MY	113	echo >&2 "***"
	114	echo >&2 "*** Rust compiler '$RUSTC' is too old."
	115	echo >&2 "*** Your version: $rust_compiler_version"
	116	echo >&2 "*** Minimum version: $rust_compiler_min_version"
	117	echo >&2 "***"
78521f33 MO	118	exit 1
78521f33 MO	119	fi
d824d2f9	120	if [ "$rust_compiler_cversion" -gt "$rust_compiler_min_cversion" ]; then
78521f33 MO	121	echo >&2 "***"
	122	echo >&2 "*** Rust compiler '$RUSTC' is too new. This may or may not work."
	123	echo >&2 "*** Your version: $rust_compiler_version"
	124	echo >&2 "*** Expected version: $rust_compiler_min_version"
	125	echo >&2 "***"
aac284b1	126	warning=1
78521f33 MO	127	fi
	128
	129	# Check that the Rust bindings generator is suitable.
	130	#
	131	# Non-stable and distributions' versions may have a version suffix, e.g. `-dev`.
f2955228 MO	132	rust_bindings_generator_output=$( \
	133	LC_ALL=C "$BINDGEN" --version 2>/dev/null
	134	) \|\| rust_bindings_generator_code=$?
	135	if [ -n "$rust_bindings_generator_code" ]; then
	136	echo >&2 "***"
	137	echo >&2 "*** Running '$BINDGEN' to check the Rust bindings generator version failed with"
	138	echo >&2 "*** code $rust_bindings_generator_code. See output and docs below for details:"
	139	echo >&2 "***"
	140	echo >&2 "$rust_bindings_generator_output"
	141	echo >&2 "***"
	142	exit 1
	143	fi
78521f33	144	rust_bindings_generator_version=$( \
f2955228	145	echo "$rust_bindings_generator_output" \
7cd6a3e1	146	\| sed -nE '1s:.bindgen ([0-9]+\.[0-9]+\.[0-9]+).:\1:p'
78521f33	147	)
bc60c930 MO	148	if [ -z "$rust_bindings_generator_version" ]; then
	149	echo >&2 "***"
	150	echo >&2 "*** Running '$BINDGEN' to check the bindings generator version did not return"
	151	echo >&2 "*** an expected output. See output and docs below for details:"
	152	echo >&2 "***"
	153	echo >&2 "$rust_bindings_generator_output"
	154	echo >&2 "***"
	155	exit 1
	156	fi
78521f33 MO	157	rust_bindings_generator_min_version=$($min_tool_version bindgen)
	158	rust_bindings_generator_cversion=$(get_canonical_version $rust_bindings_generator_version)
	159	rust_bindings_generator_min_cversion=$(get_canonical_version $rust_bindings_generator_min_version)
	160	if [ "$rust_bindings_generator_cversion" -lt "$rust_bindings_generator_min_cversion" ]; then
d824d2f9 MY	161	echo >&2 "***"
	162	echo >&2 "*** Rust bindings generator '$BINDGEN' is too old."
	163	echo >&2 "*** Your version: $rust_bindings_generator_version"
	164	echo >&2 "*** Minimum version: $rust_bindings_generator_min_version"
	165	echo >&2 "***"
78521f33 MO	166	exit 1
78521f33 MO	167	fi
d824d2f9	168	if [ "$rust_bindings_generator_cversion" -gt "$rust_bindings_generator_min_cversion" ]; then
78521f33 MO	169	echo >&2 "***"
	170	echo >&2 "*** Rust bindings generator '$BINDGEN' is too new. This may or may not work."
	171	echo >&2 "*** Your version: $rust_bindings_generator_version"
	172	echo >&2 "*** Expected version: $rust_bindings_generator_min_version"
	173	echo >&2 "***"
aac284b1	174	warning=1
78521f33 MO	175	fi
	176
	177	# Check that the `libclang` used by the Rust bindings generator is suitable.
52cae7f2 MO	178	#
	179	# In order to do that, first invoke `bindgen` to get the `libclang` version
	180	# found by `bindgen`. This step may already fail if, for instance, `libclang`
	181	# is not found, thus inform the user in such a case.
	182	bindgen_libclang_output=$( \
	183	LC_ALL=C "$BINDGEN" $(dirname $0)/rust_is_available_bindgen_libclang.h 2>&1 >/dev/null
	184	) \|\| bindgen_libclang_code=$?
	185	if [ -n "$bindgen_libclang_code" ]; then
	186	echo >&2 "***"
	187	echo >&2 "*** Running '$BINDGEN' to check the libclang version (used by the Rust"
	188	echo >&2 "*** bindings generator) failed with code $bindgen_libclang_code. This may be caused by"
	189	echo >&2 "*** a failure to locate libclang. See output and docs below for details:"
	190	echo >&2 "***"
	191	echo >&2 "$bindgen_libclang_output"
	192	echo >&2 "***"
	193	exit 1
	194	fi
	195
	196	# `bindgen` returned successfully, thus use the output to check that the version
	197	# of the `libclang` found by the Rust bindings generator is suitable.
7cd6a3e1 MO	198	#
	199	# Unlike other version checks, note that this one does not necessarily appear
	200	# in the first line of the output, thus no `sed` address is provided.
78521f33	201	bindgen_libclang_version=$( \
52cae7f2	202	echo "$bindgen_libclang_output" \
9eb7e20e	203	\| sed -nE 's:.clang version ([0-9]+\.[0-9]+\.[0-9]+).:\1:p'
78521f33	204	)
bc60c930 MO	205	if [ -z "$bindgen_libclang_version" ]; then
	206	echo >&2 "***"
	207	echo >&2 "*** Running '$BINDGEN' to check the libclang version (used by the Rust"
	208	echo >&2 "*** bindings generator) did not return an expected output. See output"
	209	echo >&2 "*** and docs below for details:"
	210	echo >&2 "***"
	211	echo >&2 "$bindgen_libclang_output"
	212	echo >&2 "***"
	213	exit 1
	214	fi
78521f33 MO	215	bindgen_libclang_min_version=$($min_tool_version llvm)
	216	bindgen_libclang_cversion=$(get_canonical_version $bindgen_libclang_version)
	217	bindgen_libclang_min_cversion=$(get_canonical_version $bindgen_libclang_min_version)
	218	if [ "$bindgen_libclang_cversion" -lt "$bindgen_libclang_min_cversion" ]; then
d824d2f9 MY	219	echo >&2 "***"
	220	echo >&2 "*** libclang (used by the Rust bindings generator '$BINDGEN') is too old."
	221	echo >&2 "*** Your version: $bindgen_libclang_version"
	222	echo >&2 "*** Minimum version: $bindgen_libclang_min_version"
	223	echo >&2 "***"
78521f33 MO	224	exit 1
	225	fi
	226
	227	# If the C compiler is Clang, then we can also check whether its version
	228	# matches the `libclang` version used by the Rust bindings generator.
	229	#
	230	# In the future, we might be able to perform a full version check, see
	231	# https://github.com/rust-lang/rust-bindgen/issues/2138.
dee3a6b8	232	cc_name=$($(dirname $0)/cc-version.sh $CC \| cut -f1 -d' ')
d824d2f9 MY	233	if [ "$cc_name" = Clang ]; then
d824d2f9 MY	234	clang_version=$( \
dee3a6b8	235	LC_ALL=C $CC --version 2>/dev/null \
d824d2f9 MY	236	\| sed -nE '1s:.version ([0-9]+\.[0-9]+\.[0-9]+).:\1:p'
	237	)
	238	if [ "$clang_version" != "$bindgen_libclang_version" ]; then
	239	echo >&2 "***"
	240	echo >&2 "*** libclang (used by the Rust bindings generator '$BINDGEN')"
	241	echo >&2 "*** version does not match Clang's. This may be a problem."
	242	echo >&2 "*** libclang version: $bindgen_libclang_version"
	243	echo >&2 "*** Clang version: $clang_version"
	244	echo >&2 "***"
aac284b1	245	warning=1
78521f33 MO	246	fi
	247	fi
	248
	249	# Check that the source code for the `core` standard library exists.
	250	#
	251	# `$KRUSTFLAGS` is passed in case the user added `--sysroot`.
	252	rustc_sysroot=$("$RUSTC" $KRUSTFLAGS --print sysroot)
	253	rustc_src=${RUST_LIB_SRC:-"$rustc_sysroot/lib/rustlib/src/rust/library"}
	254	rustc_src_core="$rustc_src/core/src/lib.rs"
	255	if [ ! -e "$rustc_src_core" ]; then
d824d2f9 MY	256	echo >&2 "***"
	257	echo >&2 "*** Source code for the 'core' standard library could not be found"
	258	echo >&2 "*** at '$rustc_src_core'."
	259	echo >&2 "***"
78521f33 MO	260	exit 1
78521f33 MO	261	fi