slyrus / cffi Goto Github PK

CFFI, the Common Foreign Function Interface, purports to be a portable foreign function interface for Common Lisp. The CFFI library is composed of a Lisp-implementation-specific backend in the CFFI-SYS package, and a portable frontend in the CFFI package.

The CFFI-SYS backend package defines a low-level interface to the native FFI support in the Lisp implementation. It offers operators for allocating and dereferencing foreign memory, calling foreign functions, and loading shared libraries.

The CFFI frontend provides a declarative interface for defining foreign functions, structures, typedefs, enumerated types, etc. It is implemented in portable ANSI CL making use of the low-level operators exported by CFFI-SYS.

CFFI/C2FFI is an ASDF-integrated mechanism to automatically generate a complete CFFI binding for a C project using the JSON output of c2ffi. c2ffi generates its output by using LLVM/Clang as a library to parse any C project. Until CFFI/C2FFI is properly documented, please see these projects as examples: here, here, here, and here.

Please consult the manual for further details, including installation instructions.

Please visit Launchpad for bug reports and feature suggestions.