RIOT/dist/tools/testprogs/README.md

Test Programs
=============

This folder contains a collection of test programs for use by the build system,
e.g. to check for compiler features.

`minimal_linkable.c`
--------------------

This is a minimal C program that is expected to compile and link with all
supported versions of GCC and newlib.

Note: We currently even link with GCC when compilation is done with LLVM. It is
expected to compile and link fine with LLVM as well, but may require more some
additional flags to find the embedded C lib to link against.
build system: Fix linker feature test with newlib 4.3.0 Before the build system used something like echo "int main(){} void _exit(int n) {(void)n;while(1);}" \| LC_ALL=C $(LINK) -xc - -o /dev/null -lc -Wall -Wextra -pedantic <FLAGS_TO_TEST> to check for flags supported by the compiler (used as linker frontend). This however no longer works with newlib 4.3.0, which requires the symbols `_sbrk_r`, `_close_r`, `_lseek_r`, `_read_r`, and `_write_r` to be present. Instead, now a new file `minimal_linkable.c` was added that adds all the missing symbols and is used in the linker feature tests instead. 2023-02-01 15:57:45 +01:00			`Test Programs`
			`=============`

			`This folder contains a collection of test programs for use by the build system,`
			`e.g. to check for compiler features.`

			`minimal_linkable.c`
			`--------------------`

			`This is a minimal C program that is expected to compile and link with all`
			`supported versions of GCC and newlib.`

			`Note: We currently even link with GCC when compilation is done with LLVM. It is`
			`expected to compile and link fine with LLVM as well, but may require more some`
			`additional flags to find the embedded C lib to link against.`