AutosarC++17_03-A15.5.2

Program shall not be abruptly terminated. In particular, an implicit or explicit invocation of std::abort(), std::quick_exit(), std::_Exit(), std::terminate() shall not be done

Required inputs: IR, StaticSemanticAnalysis

Possible Messages

Key	Text	Severity	Disabled
exception_escaping_constructor	Escaping exception from constructor.	None	False
exception_escaping_destructor	Escaping exception from destructor.	None	False
exception_escaping_initialization	Uncaught exception raised in initialization or finalization	None	False
exception_escaping_main	Uncaught exception escaping from main or additional entry point	None	False
exception_specification_violation	Exception violates function’s exception-specification.	None	False
exception_specification_violation_from_call	Exceptions propagated from this call violate function’s exception-specification.	None	False
forbidden_libfunc_call	Call to forbidden function.	None	False

Options

• This rule shares the following common options: exclude_in_macros, exclude_messages_in_system_headers, excludes, extend_exclude_to_macro_invocations, includes, justification_checker, languages, post_processing, provider, report_at, severity

• The following places define options that affect this rule: Stylechecks, Analysis-GlobalOptions

allowed_exceptions

allowed_exceptions : set[str] = {'bad_alloc', 'bad_cast', 'failure', 'runtime_error', 'system_error'}

Exceptions that are allowed to escape from destructors.

 

blacklist

blacklist

Type: dict[bauhaus.analysis.config.FileGlobPattern, list[bauhaus.analysis.config.GlobPattern]]

Default:

{
   '*abort.h': ['abort'],
   '*stdlib.h': ['abort', 'quick_exit', '_Exit'],
   '*terminate.h': ['terminate'],
   'exception': ['terminate']
}

Dictionary of header globbing to (list of) function name globbing(s) of forbidden functions.

 

constructors

constructors : bool = False

Whether to consider constructors.

 

destructors

destructors : bool = True

Whether to consider destructors.

 

exclude_exception_base_classes

exclude_exception_base_classes : set[bauhaus.analysis.config.QualifiedName] = set()

Exclude issues for the exception types mentioned in this set of qualified names. Also excludes classes derived from those class names as well as pointers or references to any of these class types.

 

generate_violation_path

generate_violation_path : bool = True

Whether to compute a trace for the exception. This improves the usability of the violation description, but requires additional computing which might slow down the rule.

 

ignore_constructor_destructor

ignore_constructor_destructor : bool = False

Whether to ignore escaping exceptions from constructors and destructors.

 

ignore_unknown_routines

ignore_unknown_routines : bool = False

Whether to ignore extern or only declared routines.

 

inspect_at_exit_handlers

inspect_at_exit_handlers : bool = True

Whether to also inspect at_exit() handlers-functions.

 

inspect_atexit_entry_points

inspect_atexit_entry_points : bool = False

Whether to inspect routines set by the atexit/std::atexit function.

 

inspect_thread_main

inspect_thread_main : bool = True

Whether to also inspect thread main functions.

 

report_at_call

report_at_call : bool = False

If set to true, the error is reported at the call-sites of routines throwing exceptions rather than at the throw.

 

report_only_one_exception_per_function

report_only_one_exception_per_function : bool = False

Report at most one uncaught exception per function. This suppresses issues at sites where an uncaught exception is thrown to get a faster execution of the check. Setting this parameter to True will result in false negatives: Real issues may not be detected anymore.