https://github.com/pharo-project/threadedffi-plugin

A Threaded FFI plugin for Pharo. It extends the Cog VM with non blocking queue based FFI.
https://github.com/pharo-project/threadedffi-plugin

pharo

Last synced: about 2 months ago
JSON representation

A Threaded FFI plugin for Pharo. It extends the Cog VM with non blocking queue based FFI.

• Host: GitHub
• URL: https://github.com/pharo-project/threadedffi-plugin
• Owner: pharo-project
• License: mit
• Archived: true
• Created: 2019-08-14T12:19:37.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2021-07-20T13:55:06.000Z (over 3 years ago)
• Last Synced: 2024-09-25T21:24:03.530Z (about 2 months ago)
• Topics: pharo
• Language: Smalltalk
• Size: 601 KB
• Stars: 7
• Watchers: 9
• Forks: 6
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ThreadedFFI-Plugin

A Threaded FFI plugin for Pharo. It extends the Cog VM with non blocking queue based FFI.

This plugin has two main parts: a VM plugin written in C, and a Pharo library to access it.

## Installation

If you're running a headless VM, you very probably have the threaded FFI plugin with it.

### Installing the Pharo library

You can then load this project importing it through Iceberg, or by executing the following metacello expression:

```smalltalk

Metacello new

		baseline: 'ThreadedFFI';

		repository: 'github://pharo-project/threadedFFI-Plugin';

		onConflictUseLoaded;

		load.

```

If you're missing the plugin, update your headless VM or compile one from sources.

### Using with UFFI

This new FFI implementation is fully compatible with UFFI. 

It implements a new UFFI backend that can be used as an alternative to the one implemented using SqueakFFI plugin. 

To use it please refer to [this page](https://github.com/pharo-project/threadedFFI-Plugin/wiki/Using-with-UFFI).

### Compiling the plugin from sources

```bash

cmake .

make install

make test

make package

```

The build results can be found in `build/packages/*`

#### Compilation in OS X Catalina and Newer

Since some changes in the compilation toolchain of XCode, it is needed to give some hints to the build of libFFI. 

LibFFI is built during the building of the plugin.

To run the build correctly, the environment variable CPATH should be set: 

```

export CPATH=`xcrun --show-sdk-path`/usr/include

```

### Running the tests

Running the tests requires an external library with defined functions and types.

To obtain the test library, you need to compile it from sources.

Then copy it close to your image or your VM.