libffi

libffi is a foreign function interface library. It provides a C programming language interface for calling natively compiled functions given information about the target function at run time instead of compile time. It also implements the opposite functionality: libffi can produce a pointer to a function that can accept and decode any combination of arguments defined at run time.

libffi
Developer(s)Anthony Green
Initial releaseOctober 7, 1996 (1996-10-07)
Stable release
3.4.4 / October 23, 2022 (2022-10-23)
Repository
Written inC, Assembly language
Operating systemUnix-like, Microsoft Windows, OS X, iOS, bare metal
TypeRuntime library
LicenseMIT License[1]
Websitesourceware.org/libffi/ Edit this on Wikidata

libffi is most often used as a bridging technology between compiled and interpreted language implementations. libffi may also be used to implement plug-ins, where the plug-in's function signatures are not known at the time of creating the host application.

Notable users include Python, Haskell, Dalvik, F-Script, PyPy, PyObjC, RubyCocoa, JRuby, Rubinius, MacRuby, gcj, GNU Smalltalk, IcedTea, Cycript, Pawn, Squeak, Java Native Access, Common Lisp (via CFFI), Racket,[2] Embeddable Common Lisp and Mozilla.[3]

On Mac OS X, libffi is commonly used with BridgeSupport, which provides programming language neutral descriptions of framework interfaces, and Nu which binds direct Objective-C access from Lisp.

libffi has been widely ported and is released under a MIT license.

Background

Although the C programming language is ubiquitous among platforms, the ways function calls are implemented in machine code – the calling convention – vary. When one wants to load a subroutine dynamically at run-time, a knowledge of these conventions is required.

libffi has knowledge of the calling convention on many platforms (processor–OS combinations). Its C API, which is shared on all builds of libffi regardless of platform, abstracts over the complexity of loading code on different platforms. In addition to regular functions, it also supports C-style variadic functions.

The C calling convention is not only used by the C language: due to the amount of existing code written in C, most newer compiled languages also allow writing and calling functions in such a convention. As a result, libffi is able to interact with some functions written in these languages too.

History

libffi, originally developed by Anthony Green, was inspired by the Gencall library from Silicon Graphics. Gencall was developed by Gianni Mariani, then employed by SGI, for the purpose of allowing calls to functions by address and creating a call frame for the particular calling convention (MIPS O32). Anthony Green refined the idea and extended it to other architectures and calling conventions and open sourcing libffi.

Adoption

The libffi library is useful in building a bridge between interpreted and natively compiled code. Some notable users include:

D
libffi-d
Bindings to the libffi library for D. Primarily used for the MCI (Managed Compiler Infrastructure).

F-Script
F-Script
Dynamically generates Cocoa classes written in F-Script.

Guile
GNU Guile
libffi is used in Guile 1.9.8 and onwards

Haskell
GHC
libffi has been used for the majority of the FFI performed by the GHC since late 2009.

Java
OpenJDK
The open-source implementation of the Java Platform Standard Edition uses libffi to bridge between the interpreter and native code for Zero-Assembly port.
Dalvik
Dalvik is the virtual machine which runs the Java platform on Android mobile devices. libffi is used on Android ports for which no custom bridging code has been written.
Java Native Access (JNA)
The JNI-free way to call native code from Java.
gcj
The runtime library for the GNU Compiler for the Java Programming Language uses libffi to handle calls back and forth between interpreted and natively compiled code. gcj is part of the GCC, the GNU Compiler Collection.

JavaScript
JSCocoa
Call Objective-C code from javascript on Mac OS X and the iPhone (via the libffi-iphone port).
Mozilla
libffi is used in the js-ctypes library (previously known as ctypes.jsm) to call C functions within JavaScript code (available in XULRunner applications, Firefox extensions etc).[4]
node-ffi
A Node.js addon for loading and calling dynamic libraries from JavaScript.

Lisp
cffi-libffi
The standard foreign function interface library for Common Lisp CFFI includes the cffi-libffi system to include support for passing and returning structure arguments by value.
pixie
pixie (a Clojure inspired Lisp dialect) uses libffi as the default foreign function interface mechanism.

Perl
FFI::Raw
A thin wrapper around libffi.
FFI::Platypus
Newer, more convenient wrapper around libffi.

Python
CPython
The default, most-widely used implementation of the Python programming language uses libffi in the standard ctypes library.
PyObjC
Call Objective-C code from Python on Mac OS X.

Racket
Racket
Call C code from this popular Scheme implementation (also used as the implementation platform for Paul Graham's new Lisp, Arc).

Ruby
Fiddle
A libffi wrapper in the Ruby Standard Library
Ruby-FFI
A Foreign Function Interface extension for Ruby.
RubyCocoa
Call Objective-C code from Ruby on Mac OS X.

References
  1. "Status". GitHub. 25 April 2022.
  2. "Archived copy" (PDF). Archived from the original (PDF) on 2009-09-02. Retrieved 2009-08-02.{{cite web}}: CS1 maint: archived copy as title (link)
  3. "Mozilla-central @ 2dc00d4b379a files manifest".
  4. https://developer.mozilla.org/en/js-ctypes, js-ctypes reference
This article is issued from Wikipedia. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.