LANG.STRUCT.UUMACRO : Unused Macro

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 preprocessor macro is defined but not instantiated within the scope of the definition.

Class Name

Unused Macro

Significance

style

Mnemonic

LANG.STRUCT.UUMACRO

Categories

MisraC2023	MisraC2023:2.5	A project should not contain unused macro declarations
Misra2012	Misra2012:2.5	A project should not contain unused macro declarations
CWE	CWE:561	Dead Code
CERT-C	CERT-C:MSC12-C	Detect and remove code that has no effect or is never executed
DISA-3r10	DISA-3r10:V-6149	The designer will ensure the application does not contain source code that is never invoked during operation, except for software components and libraries from approved third-party products.

Availability

Available for C and C++.

Enabling

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

WARNING_FILTER += allow class="Unused Macro"

Suppose the analyzed project has a single source file, fileA.c.

#define macro1 1  /* 'Unused Macro' warning issued here */   
#define macro2 1                               /* used in body of myfunc() */  

int myfunc(void){return macro2;}

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

LANG.STRUCT.UUMACRO : Unused Macro

Summary

Properties

Example

Relevant Configuration File Parameters