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

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index d610977bf9e3f60b325c8bf8c92516772112e6ef..40f1b6680e0e612467babaa451069e21f3ea7175 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2016-05-12  Martin Liska  <mliska@suse.cz>
+
+       * doc/invoke.texi: Explain connection between -fsanitize-recover=address
+       and ASAN_OPTIONS="halt_on_error=1".
+
 2016-05-12  Ilya Enkovich  <ilya.enkovich@intel.com>
 
        PR tree-optimization/71006

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index c72ec5b3d5b6132ae998bd703368a87a57e779b8..1176d1260e9b68515bedccbbacf39458b7c62f6e 100644 (file)
--- 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