Open main menu

HOWTO-Static Analysis Tools

Revision as of 20:13, 24 July 2022 by Md5 (talk | contribs) (→‎Codacy: Fix typo)

We use Static Analysis tools at ScummVM.

Here is some guidance on their usage

Coverity

Our major tool that is located at this URL.

To get access, you must be a member of the ScummVM Team and issue a request on that page. Ping sev for getting your request approved.

Some guidances:

  1. The analysis runs every Monday night EU time and completes at around 3 am. Ping sev if you want to have it re-analysed. But due to the size of our project, the limitation is to run an analysis every 24 hours.
  2. Use "Components -> All in Project" for viewing defects in your engine or subsystem (use the hamburger menu for navigation)
  3. Once you have fixed a bug, specify its classification and severity. Action should be "Fixed, tested & documented" and assign an owner to yourself (autocompletion works there)
  4. Address all possible issues. If you clearly see that it is a false positive, which is rare but happens, feel free to specify "False Positive" or "Ignore" but still assign it to yourself
  5. Be super vigilant regarding High Impact issues such as memory leaks, use-after-free and other things
  6. Regarding the TAINTED SCALAR issues, we have tons of those that we used to dismiss. Yes, it may lead to an issue when manually crafted game data might lead to a crash or some memory overflow exploits, but once we have the data integrity subsystem implemented, those will be eliminated.


Codacy

We use it on GitHub.

In sev's opinion it is mostly useless. It is an AI-based tool that seemingly runs by pattern matching. As a result, it produces tons of strange complaints about somebody's code formatting standards, etc.

Use at your discretion.


cppcheck

You may run it manually. Some team members periodically run it and fix the most outstanding issues.