MATH.RANGE.LOG : Logarithm on Zero

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.

A logarithm function is called with an argument that evaluates to zero.

Class Name

Logarithm on Zero

Significance

reliability

Mnemonic

MATH.RANGE.LOG

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="Logarithm on Zero"

CodeSonar ships with library models that allow it to recognize functions such as libm log2() that compute a logarithm. If one of these functions is called with zero in the input parameter position, 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 Logarithm on Zero warnings.

#include <math.h>

double call_log(double ind){
    double a = log(1);                          /* ok */
    double b = log(0);    /* 'Logarithm on Zero' warning issued here */
    double c = log(ind);  /* EVIDENCED ONLY: 'Logarithm on Zero' warning issued here
                           * if CodeSonar has evidence that zero is passed to call_log(). */
    return a+b+c;
}

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

MATH.RANGE.LOG : Logarithm on Zero

Summary

Properties

Triggers

Example

Relevant Configuration File Parameters