MATH.DOMAIN : Floating Point Domain Error

JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

If you access the manual through the hub's Web GUI, the functionality will not be suppressed because the hub is a web server.
Alternatively, your browser may allow you to explicitly disable the security setting that suppresses functionality. See the CodeSonar FAQ for more information.

An attempt to call a floating point function on a value that is outside its domain, when no other MATH.DOMAIN.* warning class is appropriate.

Class Name

Floating Point Domain Error

Significance

style

Mnemonic

MATH.DOMAIN

Categories

MisraC2023	MisraC2023:D.4.1	Run-time failures shall be minimized
	MisraC2023:D.4.11	The validity of values passed to library functions shall be checked
Misra2012	Misra2012:D.4.1	Run-time failures shall be minimized
	Misra2012:D.4.11	The validity of values passed to library functions shall be checked
Misra2004	Misra2004:20.3	The validity of values passed to library functions shall be checked
AUTOSARC++14	AUTOSARC++14:A0-4-4	Range, domain and pole errors shall be checked when using math functions.
CWE	CWE:628	Function Call with Incorrectly Specified Arguments
	CWE:687	Function Call With Incorrectly Specified Argument Value
	CWE:688	Function Call With Incorrect Variable or Reference as Argument
CERT-C	CERT-C:FLP32-C	Prevent or detect domain and range errors in math functions

Availability

Available for C and C++.

Enabling

Checks for this warning class are enabled by default. To disable them, add the following WARNING_FILTER rule to the project configuration file.

WARNING_FILTER += discard class="Floating Point Domain Error"

CodeSonar ships with library models that allow it to recognize functions such as libm yn() that are not applicable to all floating point numbers. If one of these functions is called with a floating point argument that is outside its domain, a warning will be issued.

If you have created a custom library model for some function f() in terms of one of these existing models, calls to f() will also be capable of triggering Floating Point Domain Error warnings.

#include <math.h>

double call_yn(double ind){
    double a = yn(1,5);                     /* ok */
    double b = yn(-1,5);  /* 'Floating Point Domain Error' warning issued here */
    double c = yn(ind,5); /* EVIDENCED ONLY: 'Floating Point Domain Error' warning issued here
                           * if CodeSonar has evidence that call_yn() is called on a value ≤-1. */
    return a+b+c;
}

The following configuration file parameters affect checks for this warning class.

MATH.DOMAIN : Floating Point Domain Error

Summary

Properties

Triggers

Example

Relevant Configuration File Parameters