Coccinelle (software) explained

Coccinelle
Latest Release Version:1.1.0[1]
Programming Language:OCaml and Python
Genre:Static program analysis
License:GPLv2

Coccinelle (Italian for ladybugs) is an open-source utility for matching and transforming the source code of programs written in the C programming language.

Utility

Coccinelle was initially used to aid the evolution of the Linux kernel, providing support for changes to library application programming interfaces (APIs) such as renaming a function, adding a function argument whose value is somehow context-dependent, and reorganizing a data structure.

It can also be used to find defective programming patterns in code (i.e., pieces of code that are erroneous with high probability such as possible NULL pointer dereference) without transforming them. Therefore coccinelles role is close to that of static analysis tools. Examples of such use are provided by the applications of the herodotos tool, which keeps track of warnings generated by coccinelle.[2] [3]

Support for Coccinelle is provided by IRILL. Funding for the development has been provided by the Agence Nationale de la Recherche (France), the Danish Research Council for Technology and Production Sciences, and INRIA.

The source code of Coccinelle is licensed under the terms of version 2 of the GNU General Public License (GPL).

Semantic Patch Language

The source code to be matched or replaced is specified using a "semantic patch" syntax based on the patch syntax.[4] The Semantic Patch Language (SmPL) pattern resembles a unified diff with C-like declarations.[5] [6]

Example

@@expression lock, flags;expression urb;@@

spin_lock_irqsave(lock, flags); <...- usb_submit_urb(urb)+ usb_submit_urb(urb, GFP_ATOMIC) ...> spin_unlock_irqrestore(lock, flags);

@@expression urb;@@

- usb_submit_urb(urb)+ usb_submit_urb(urb, GFP_KERNEL)

External links

Notes and References

  1. Web site: Coccinelle: A Program Matching and Transformation Tool for Systems Code . 2021-03-09 . coccinelle.gitlabpages.inria.fr.
  2. Book: Palix . Nicolas . Lawall . Julia. Julia Lawall . Muller . Gilles . Proceedings of the 9th International Conference on Aspect-Oriented Software Development . Tracking code patterns over multiple software versions with Herodotos . 2010 . 169–180 . https://coccinelle.gitlabpages.inria.fr/website/papers/aosd10.pdf . ACM . 10.1145/1739230.1739250. 9781605589589 . 1082611 .
  3. Web site: Nicolas Palix: Herodotos. Nicolas Palix.
  4. Web site: Yoann . Padioleau . Julia . Lawall. Julia Lawall . Gilles . Muller . Semantic Patches, Documenting and Automating Collateral Evolutions in Linux Device Drivers . 2007 . 2020-08-29 . coccinelle.gitlabpages.inria.fr .
  5. Web site: Semantic patching with Coccinelle . Valerie Henson . 2009-01-20 . . 2011-04-25.
  6. Web site: Evolutionary development of a semantic patch using Coccinelle. Linux Weekly News. Wolfram Sang. 2010-03-30. 2011-04-25.