Download
Current version: 1.0.8, September 25, 2019 (changes).Here is the source code of spatch. It requires OCaml and optionally python 2.5 to 2.7 or python 3. If you plan to modify the SmPL grammar or you do a "make distclean", thus removing all generated files, then you will also need to install menhir.
The source code of the various releases is also available at github.
We also provide pre-compiled versions of spatch in various formats:
- Without Python binding
- Native code dynamically linked.
- OCaml bytecode, which requires an OCaml runtime. The bytecode was generated using OCaml 4.08.0, but may work with other versions of OCaml.
- Slackware, thanks to Dimitris Zlatanidis
- Debian, thanks to Eugeniy Meshcheryakov
- Ubuntu See also the Ubuntu package on PPA, which contains a more recent version of Coccincelle.
- Fedora, thanks to Richard W.M. Jones and Michal Schmidt
- OpenSUSE
- Arch Linux, thanks to Sylvain HENRY
- NetBSD, thanks to Thomas Klausner
- FreeBSD
- OpenBSD
- Gentoo
Finally, Francois Berenger has packaged Coccinelle for Opam, a widely available package manager for OCaml. Once Opam has been installed, coccinelle can be installed with the following commands:
opam update opam install coccinelle
Example invocation:
./spatch -cocci_file foo.cocci foo.c
.
The output is in the file /tmp/foo.c
which will contain
the result of applying the semantic patch foo.cocci
to the C file foo.c modulo a set of isomorphisms
contained in standard.iso (standard.iso is by default located in
/usr/local/share/coccinelle/standard.iso).
It is also possible to apply spatch to all of the C files in a directory:
./spatch -cocci_file foo.cocci -dir foodir
. If the
semantic patch is not working as expected, it can be useful to use the
option -debug
to get a
trace of the metavariable bindings used for each rule.
We also provide our current set of isomorphisms: standard.iso (colorized HTML version).
Some of our semantic patches and test files are also available, in various formats: coccinelle-tests.tgz (240 MB), coccinelle-tests.tlz (87 MB) or coccinelle-tests.txz (67 MB).
Alexander Færøy has made a vim mode for use with Coccinelle semantic patches.