C and C++


MATH.DOMAIN.TOOLOW : Argument Too Low

Summary

A math function is called with an argument that is less than -1, but the lowest suitable value for the corresponding parameter is -1.

Properties

Class Name Argument Too Low
Significance reliability
Mnemonic MATH.DOMAIN.TOOLOW
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="Argument Too Low"

Triggers

CodeSonar ships with library models that allow it to recognize functions such as libm acos() that have a parameter whose value should not be less than -1. If one of these functions is called with a value less than -1 in the relevant 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 Argument Too Low warnings.

Example

#include <math.h>

double call_asin(double ind){
    double a = asin(-1);                         /* ok */
    double b = asin(-2);   /* 'Argument Too Low' warning issued here */
    double c = asin(ind);  /* EVIDENCED ONLY: 'Argument Too Low' warning issued here
                            * if CodeSonar has evidence that call_asin() is called on a value <-1. */

    return a+b+c;
}

Relevant Configuration File Parameters

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