Skip to content

Latest commit

 

History

History
347 lines (211 loc) · 20.4 KB

Changelog.md

File metadata and controls

347 lines (211 loc) · 20.4 KB
Raw

Version 1.2.0

A lot has happened in the years since 1.1.0 so these are just the highlights.

Checkers

Languages

  • New Erlang frontend. You can analyse Erlang code compiling with erlc, rebar3 or buck2.

  • New Hack frontend, based on hackc.

  • New "Textual" intermediate frontend. Textual is a new input format that frontend writers may use to emit SIL, either in text form or from OCaml directly. It is currently used by the Hack frontend. Textual can also be used to write analysis models, i.e. stubs for certain functions that will be used during the analysis as if they were these functions' implementations.

Build System Integrations

  • Clang upgraded to version 18.

  • buck2 support.

Backend

  • Incremental mode much improved, see the new --incremental-analysis flag in the updated workflow for CI document.

Command Line Interface

  • infer report now generates the report files (eg infer-out/report.json) afresh from the stored analysis summaries on disk. The command doesn't dump the summaries to the console anymore, you can use infer debug --procedures --procedures-summary to do so.

  • New option to dump a SARIF report of the issues found by infer: --sarif.

Version 1.1.0

Frontends

Build System Integrations

  • Clang upgraded to version 11.0

Checkers

  • Liveness: properly handle exceptional control flow
  • Pulse:
  • NEW checker Topl(early alpha): An experimental checker framework: write your own analysis as a state machine representing a temporal property over multiple memory objects at once, eg to write a taint analysis. Topl is based on Pulse.
  • Miscellaneous improvements to cost, inferbo, nullsafe, racerd, starvation

Version 1.0.0

Checkers

AL is now deprecated and may be removed in future versions.

Annotation Reachability

  • reporting format improvements (the trace is no longer included in the report text, only as metadata)

Biabduction

  • disable some less-used bug types

Eradicate

  • remove "Field not mutable" check

RacerD

  • Now defaults to "angelic" ownership: an unknown function is assumed to return owned objects.
  • No more reports on races on paths rooted on temporary or local variables, as these are unreliably modelled.

Litho Required Properties: new Java checker to check that all non-optional @Props have been specified when constructing Litho components. Self in Block: new Objective-C checker to detect when an Objective-C block incorrectly captures self Starvation

  • New experimental "global" analysis mode. Enable with --starvation-whole-program

Miscellaneous improvements to most checkers, in particular Annotation Reachability, Cost Analysis, Eradicate, Inefficient Keyset Iterator, InferBO, Pulse, RacerD, Starvation, and Uninitialized Value.

Build System Integrations

  • The Gradle integration now captures Java files in parallel
  • New Buck integration for Java, enable with --buck-java-flavor
  • Clang upgraded to version 9.0

Command Line Interface

  • New subcommand infer help to display information about checkers and issue types.
  • New subcommand infer debug that replaces the uses of infer explore not related to reported issues.
  • --debug no longer disables filtering, you have to pass -g -F to get the previous behaviour back.
  • All disk artefacts (except the Java type environment) are now stored in the SQLite database in infer-out/results.db. The contents of the database can be explored with infer debug.
  • Changed how to select the Buck integration. The old command line interface is still supported but is now deprecated.
    • clang via "flavors", activated with --flavors, now with --buck-clang
    • clang via "compilation DB", activated with --buck-compilation-database, unchanged
    • Java via "genrule", activated with --genrule-master-mode, now with --buck-java
    • Java "without genrules", used to be activated by not specifying any other Buck mode, deleted
    • In addition, there is a new Java integration, activated with --buck-java-flavor
  • The textual version of the report infer-out/bugs.txt has moved to infer-out/report.txt. The bugs.txt file is still created with dummy contents to allow for a smooth transition.
  • Removed the --report-hook option.
  • Properly terminate on Control-C instead of sometimes leaving around zombie processes.
  • Spec files (summaries) are now stored in the database. Explore with infer debug --procedures --procedures-summary.

Documentation

Internal Changes

  • Folded the facebook-clang-plugins sub-repo inside the infer repository; there is no more git submodule for it.
  • Improve internal documentation of OCaml source code.
  • Build with OCaml 4.11.1 and dune 2.7.1
  • Migrated our Python 2 code to OCaml
  • Split the infer OCaml source code into individual dune libraries.
  • Better defaults for SQLite, and a write daemon to reduce contention.
  • New analysis schedulers that speed up the analysis phase. Enable with --scheduler callgraph or --scheduler restart.
  • Infer no longer builds by default in "opt" mode (optimised, using OCaml’s flambda pass). The default is now "dev", which does not include as many optimisations (hence builds faster) and turns warnings into errors.
  • The starvation checker is now based on SIL instead of HIL.

Version 0.17.0

  • There's a new --inefficient-keyset-iterator checker for finding inefficient uses of Java's keyset iterators that retrieve both key and value (on by default).
  • Complete the set of Android thread annotations and Java nullability annotations. Updated artifacts are available on Maven Central.
  • --starvation is now on by default. This analysis catches problems with threads not being able to make progress due to locking issues, incorrect scheduling priorities, etc. For instance, on Android calling Future.get from a UiThread without a sensible timeout will be flagged as a starvation issue.
  • New Objective-C linter for calls to @optional methods: UNSAFE_CALL_TO_OPTIONAL_METHOD, enabled by default.
  • A new call-graph scheduler (--call-graph-schedule) improves performance of the analysis phase of Infer, especially when the number of files to analyze is less than available CPUs.
  • A new flag --oom-threshold allows to throttle the analysis when the amount of free memory is below the provided threshold.
  • New genrule based Buck/Java integration is much faster than the previous one, use with --genrule-master-mode.
  • Infer's internal clang is now in version 8.0.0.
  • Update to javalib 3.1 provides better compatibility with Java 9 and Java 11. Refer to their change log for more details.
  • Infer can now be built and run on MacOS Mojave without fiddling with SDKROOT (although you still might need it with non-standard toolchain setup).
  • [β] Pulse is a new experimental lifetime analysis for C++, give it a try with --pulse. Beware that it doesn't report much yet.
  • --ownership checker was superseded by Pulse and removed.

Version 0.16.0

Backend analyses:

  • A brand new analysis to compute the runtime cost of methods and functions: passing --cost (off by default) to Infer will output a costs-report.json file describing, among others, the computational complexity of each function in the code using the big-O notation, eg O(1), O(list.length), ...
  • The deadlock detection analysis has been ported to C++ and Objective-C and mainly focuses on self-deadlocks (taking a mutex twice). Activate with --starvation (off by default).
  • The data race detector RacerD has been ported to Objective-C and detects races on fields protected by a C++ mutex. It reports "Thread Safety Violation" and "GuardedBy Violation" errors on Java and "Lock Consistency Violation" on C++ and Objective-C. Activate with --racerd (on by default).
  • A progress bar is displayed while the analysis is running
  • Countless improvements and tweaks, in particular in RacerD and in analyses for C++.

Frontends:

  • Infer now ships with clang version 7.0.1
  • Support for Java up to version 11

Version 0.15.0

  • switch infer license to MIT
  • publish binaries
  • [clang] lots of improvements to the frontend

Version 0.14.0

  • New checker: --ownership detects a subset of use-after-free issues due to bad manual memory management. This is a rough prototype of Rust-style borrow checker for C++. (enabled by default, C++)
  • New checker: --uninit detects uses of uninitialized values (enabled by default, C/C++/Objective-C)
  • New checker: --racerd now also detects inconsistent lock usage in C++. Also improved the lock domain to reduce false positives for all languages.
  • Improved C++ support: destructors are now properly translated; addresses and pointers are handled more precisely
  • Improved retain cycles detection (Objective-C)
  • Upgraded the internal clang to clang 7
  • [internal] SQLite is being used to store some of infer's analysis artefacts instead of storing them in files on disk. This improves analysis speed and reduces load on the OS.

Version 0.13.1

This is a fix for the 0.13.0 release, whose build broke due to changes in opam.

Version 0.13.0

  • Infer now runs multiple checkers at the same time by default, including the biabduction analysis that was the previous and only default. In particular, we are pleased to introduce RacerD for race detection in Java. The following checkers are activated by default: annotation reachability (Java), biabduction (C/C++/ObjC, Java), fragment retains view (Java), immutable cast (Java), liveness (C/C++/ObjC), printf args (Java), quandary (C/C++/ObjC, Java), RacerD (C/C++/ObjC, Java), SIOF (C/C++/ObjC). Each checker may report several issue types.
  • Upgraded to clang 5.0
  • Richer DSL for writing linters (AL), and a new default linter for const pointers in Objective-C
  • Lots of perf improvements and bug fixes, and improved logging

Please note the following breaking changes:

  • -a eradicate is now simply --eradicate and can run alongside other checkers
  • inferTraceBugs is now the explore subcommand: infer explore --help
  • infer now depends on sqlite

Version 0.12.1

Hotfix release to update infer's opam dependencies to cope with upgrades of cppo in opam (in particular, #718).

Version 0.12.0

  • introduces subcommands and man pages for all subcommands
  • This release introduces AL, a language for writing linters against the clang AST. AL lets you check syntactic properties of source code by traversing the AST of the program. Using the included domain-specific language (DSL), you can write your own set of checks.

Version 0.11.0

  • [Java] ThreadSafety analyzer is now on by default; run it with infer -a checkers .... This checker will try and detect races (unprotected concurrent accesses with at least one write) in classes bearing the @ThreadSafe annotation.
  • Infer now builds using OCaml 4.04.0.

Version 0.10.0

  • [Clang] C++ support.
  • [Clang] Improved support for cmake and Xcode compilation databases. Use with infer --compilation-database compile_commands.json (for cmake and Buck), or with infer --compilation-database-escaped compile_commands.json (for xcbuild and xcpretty).
  • [C++] New SIOF Checker.
  • [iOS] New linter for target SDK version. Use with infer --iphoneos-target-sdk-version <min version you support> ... or with infer -a linters --iphoneos-target-sdk-version <min version you support> ....
  • [Java] New Thread Safety Checker.
  • [Java] Smarter analysis of dynamic dispatch.
  • [Java] Improved Maven integration.
  • [Java] @SuppressWarnings support removed. Use @SuppressLint instead. android.annotation.SuppressLint is only available on Android, but do let us know if that is an issue for you.

Version 0.9.5

fix for #577

Version 0.9.4.1

hotfix: https://github.com/facebook/infer/commit/9393c4f533c153e4c6f984c0752d1b08a4fa1e50

Version 0.9.4

  • [Java] preliminary support for Java 8: infer no longer skips methods containing Java 8 code
  • [clang] support for clang compilation databases
  • [Xcode] more robust integration using the compilation database (requires xcpretty)
  • [iOS] added checks for some of the ComponentKit best practices
  • lots of under-the-hood improvements, including perf improvements and bug fixes

Version 0.9.3

  • Fix issues with using Infer with Clang 4.0 and Xcode 8
  • Various fixes and performance improvements

Version 0.9.2

No changelog.

Version 0.9.1

  • enable packaging via Homebrew
  • fix an issue with locales

Version 0.9.0

  • lots of perf improvements and fixes across all analyses (thanks to everyone who reported issues and made pull requests!)
  • [experimental] C++ language support. See --cxx in infer --help. This is still in heavy development and only includes a few bug types. Feedback welcome!

Version 0.8.1

  • [Objective-C and C] upgrade clang to version 3.8.0
  • [all] bugfixes

Version 0.8.0

  • New --reactive mode to rapidly analyze the effects of a code change. Be sure to check out the documentation of the new workflow. As a result, the incremental mode (--incremental) is now deprecated.
  • New XML output, compatible with output from other static analyzers, eg PMD. To use it, pass the --pmd-xml flag to Infer (see infer --help).
  • Use @SuppressWarnings("infer") in your Java projects to annotate methods or classes where Infer shouldn't report.
  • This release incorporates a number of contributions (#284 #289 #300 #301) and addresses a number of issues (#279 #281 #283 #288 #291 #294).

Version 0.7.0

  • addresses a number of bugs, eg #270 #274 #275 #276
  • [all] add summary of the analysis results at the end of the console output
  • [android] new "Fragment retains View" checker

Version 0.6.0

  • [android] fixed intermittent infinite loop
  • [iOS] new check for capturing a C++ reference in an Objective-C block

Version 0.5.0

  • [android] detection of context leaks
  • [android] support for @PerformanceCritical and @Expensive method annotations. Infer will check that an expensive method is never called during the execution of a performance critical method (run it with infer -a checkers -- ...).
  • [iOS] new check to catch strong delegate properties, likely to create retain cycles
  • [iOS] new check to catch direct accesses to atomic properties, which can cause race conditions
  • [all] performance improvements all-around

Version 0.4.0

No changelog.

Version 0.3.0

No changelog.

Version 0.2.0

  • [java] analyze class files with $$ in the name (closes #3 more)
  • [java] don't fail on compilation warnings (closes #18)
  • [clang] support __nullable et al. (closes #4)
  • add an Infer:Checkers for printf arguments

Version 0.1.1

  • [java] no more crash on class names containing "$$" (closes #3)
  • [java] model for assert (closes #68)
  • [objective-c] support for @import (closes #2)
  • [c family] Infer now always reports on the right line numbers (closes #31)
  • [c family] fix c++ compilation errors (closes #37)

Version 0.1.0

Initial release