From cf48d8c4dc0556d165cd369eb5fa4d77fe823e59 Mon Sep 17 00:00:00 2001 From: Martin Liska Date: Thu, 12 May 2016 14:36:16 +0200 Subject: [PATCH] Document ASAN_OPTIONS="halt_on_error" env variable. * doc/invoke.texi: Explain connection between -fsanitize-recover=address and ASAN_OPTIONS="halt_on_error=1". From-SVN: r236172 --- gcc/ChangeLog | 5 +++++ gcc/doc/invoke.texi | 8 ++++++++ 2 files changed, 13 insertions(+) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index d610977bf9e..40f1b6680e0 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,8 @@ +2016-05-12 Martin Liska + + * doc/invoke.texi: Explain connection between -fsanitize-recover=address + and ASAN_OPTIONS="halt_on_error=1". + 2016-05-12 Ilya Enkovich PR tree-optimization/71006 diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index c72ec5b3d5b..1176d1260e9 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -10007,6 +10007,14 @@ for which this feature is experimental. accepted, the former enables recovery for all sanitizers that support it, the latter disables recovery for all sanitizers that support it. +Even if a recovery mode is turned on the compiler side, it needs to be also +enabled on the runtime library side, otherwise the failures are still fatal. +The runtime library defaults to @code{halt_on_error=0} for +ThreadSanitizer and UndefinedBehaviorSanitizer, while default value for +AddressSanitizer is @code{halt_on_error=1}. This can overridden through +the following environment variables: @env{ASAN_OPTIONS}, @env{TSAN_OPTIONS}, +@env{UBSAN_OPTIONS}. + Syntax without explicit @var{opts} parameter is deprecated. It is equivalent to @smallexample -fsanitize-recover=undefined,float-cast-overflow,float-divide-by-zero -- 2.30.2