Sam James <s...@gentoo.org> writes:
> Explain that 'bootstrap-ubsan' won't abort on errors by default and how
> to override that by setting UBSAN_OPTIONS.
>
> gcc/ChangeLog:
> PR other/116948
>
> * doc/install.texi (Building a native compiler): Document UBSAN_OPTIONS.
> ---
> gcc/doc/install.texi | 4 +++-
> 1 file changed, 3 insertions(+), 1 deletion(-)
>
> diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
> index 85896721a0ac..188ce4ba964a 100644
> --- a/gcc/doc/install.texi
> +++ b/gcc/doc/install.texi
> @@ -3153,7 +3153,9 @@ systems that are running Linux kernel version 5.4 or
> later.
>
> @item @samp{bootstrap-ubsan}
> Compiles GCC itself using Undefined Behavior Sanitization in order to catch
> -undefined behavior within the GCC code.
> +undefined behavior within the GCC code. Note that it does not abort on
> errors
> +by default. @code{UBSAN_OPTIONS} can be set to change this, like
> +@samp{UBSAN_OPTIONS='abort_on_error=1:print_summary=1:print_stacktrace=1'}.
After discussion with Filip, he found that halt_on_error=1 is needed as
well, and abort_on_error tweaks the behaviour (exit vs abort) when that
is set, but it doesn't work by itself. I've added halt_on_error=1 on top
locally.
>
> @end table
