nyansen/nicojensen.de
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nicojensen.de/vendor/bundle/gems/ffi-1.10.0
History
Nico Jensen b59a203dbb Init 
Init commit
2019-03-12 13:49:49 +01:00
..
ext/ffi_c Init 2019-03-12 13:49:49 +01:00
lib Init 2019-03-12 13:49:49 +01:00
samples Init 2019-03-12 13:49:49 +01:00
.gitignore Init 2019-03-12 13:49:49 +01:00
.gitmodules Init 2019-03-12 13:49:49 +01:00
.travis.yml Init 2019-03-12 13:49:49 +01:00
.yardopts Init 2019-03-12 13:49:49 +01:00
appveyor.yml Init 2019-03-12 13:49:49 +01:00
CHANGELOG.md Init 2019-03-12 13:49:49 +01:00
COPYING Init 2019-03-12 13:49:49 +01:00
ffi.gemspec Init 2019-03-12 13:49:49 +01:00
Gemfile Init 2019-03-12 13:49:49 +01:00
LICENSE Init 2019-03-12 13:49:49 +01:00
LICENSE.SPECS Init 2019-03-12 13:49:49 +01:00
Rakefile Init 2019-03-12 13:49:49 +01:00
README.md Init 2019-03-12 13:49:49 +01:00

README.md

ruby-ffi https://wiki.github.com/ffi/ffi Build Status Build status Windows

Description

Ruby-FFI is a ruby extension for programmatically loading dynamic libraries, binding functions within them, and calling those functions from Ruby code. Moreover, a Ruby-FFI extension works without changes on Ruby and JRuby. Discover why you should write your next extension using Ruby-FFI.

Features/problems

  • Intuitive DSL
  • Supports all C native types
  • C structs (also nested), enums and global variables
  • Callbacks from C to ruby
  • Automatic garbage collection of native memory

Synopsis

require 'ffi'

module MyLib
  extend FFI::Library
  ffi_lib 'c'
  attach_function :puts, [ :string ], :int
end

MyLib.puts 'Hello, World using libc!'

For less minimalistic and more sane examples you may look at:

Requirements

You need a sane building environment in order to compile the extension. At a minimum, you will need:

  • A C compiler (e.g. Xcode on OSX, gcc on everything else)
  • libffi development library - this is commonly in the libffi-dev or libffi-devel

On Linux systems running with PaX (Gentoo, Alpine, etc.) FFI may trigger mprotect errors. You may need to disable mprotect for ruby (paxctl -m [/path/to/ruby]) for the time being until a solution is found.

Installation

From rubygems:

[sudo] gem install ffi

or from the git repository on github:

git clone git://github.com/ffi/ffi.git
git submodule update --init --recursive
cd ffi
rake install

License

The ffi library is covered by the BSD license, also see the LICENSE file. The specs are shared with Rubyspec and are licensed by the same license as Rubyspec, see the LICENSE.SPECS file.

Credits

The following people have submitted code, bug reports, or otherwise contributed to the success of this project: