ffi 1.0.0 → 1.17.1

data/History.txt

@@ -1,109 +0,0 @@
-== 1.0.0 / 2010-11-30
-* Major improvements
-  * Better handling of non-ruby thread callbacks
-  * Support for releasing the GIL during C function calls
-* Minor improvements
-  * code cleanups
-
-== 0.5.0 / 2009-10-06
-
-* Major improvements
-  * New Function class
-  * Structs can be passed and returned by value
-  * Implement a custom trampoline for x86_64, resulting in roughly 30% speedup
-  * Improve dispatch of functions which take (0..6) char/short/int/long/pointer arguments by between 50% and 200% on x86_64
-  * Callbacks are now approximately 100% faster on x86_64
-* Minor improvements
-  * Add support for MacOSX Snow Leopard
-  * Improve support for Windows releasing fat binaries on rubyforge
-  * Better introspection in structs:
-    * Add StructLayout::Field#type, size, offset, alignment and name 
-      methods
-    * Add StructLayout#fields which returns an array of 
-      StructLayout::Field objects
-  * Add automagic deducing of library name from module name. 
-    Idea and prototype implementation from Matt Hulse
-  * Callback fields in structs can now be both read and written
-  * Add a bunch of new benchmarks
-  * Lots of refactoring
-* Experimental features
-  * blocking functions (i.e. native code that blocks the thread) support
-* Bug fixes
-  * Fix RUBY-FFI_43 (rake gem dependency)
-
-== 0.4.0 / 2009-08-05
-
-* Major improvements
-  * Add support for boolean types
-  * Add support for methods as callbacks
-  * Add FFI::IO.read as described in JRUBY-3636
-* Minor improvements
-  * Add Pointer::NULL constant
-  * Add AbstractMemory#get_array_of_string()
-  * Implement Pointer.new(address) and Pointer.new(:type, address)
-* Bug fixes
-  * Fix RUBY_FFI-38
-  * Fix issues related to 1.9.1 build
-  * Fix issues related to OSX build
-  * Fix issues related to FreeBSD build
-  * Fix issues related to OpenSolaris build
-
-== 0.3.5 / 2009-05-08
-
-* Bug fixes
-  * Fix RUBY_FFI-17
-  * Fix RUBY_FFI-21
-
-== 0.3.4 / 2009-05-01
-
-* Minor improvements
-  * Add return statements to functions that call rb_raise(), in case
-    rb_raise is not declared noreturn, to avoid gcc warnings.
-
-== 0.3.3 / 2009-04-27
-
-* Minor improvements
-  * Implement RUBY_FFI-16 - Add support for anonymous callbacks
-  * Add support for callback parameters in callbacks
-  * Add support for function pointer return values
-  * Callbacks can now coerce proc objects into function pointers for
-    return values.
-  * Implement FFI::Type and FFI::Type::Builtin
-  * Add support for enumerations
-* Bug fixes
-  * Fix RUBY_FFI-19
-  * Fix RUBY_FFI-15
-
-== 0.3.2 / 2009-05-01
-
-* Bug fixes
-  * Fix JRUBY-3527 by passing RTLD_GLOBAL instead of RTLD_LOCAL
-
-== 0.3.1 / 2009-03-23
-
-* Bug fixes
-  * Correctly save errno/GetLastError after each call.
-
-== 0.3.0 / 2009-03-19
-
-* Switch compilation to rake-compiler
-  * Makes cross-compilation from linux -> win32 super easy
-  * win32 support is available now, but highly experimental
-* Performance improvements
-  * struct field access approx 3x faster than 0.2.0
-  * function invocation approx 20% faster than 0.2.0
-* A bunch of minor improvements
-  * Struct instances can now be passed as :pointer parameters without calling
-    Struct#pointer
-  * Support for array struct members
-  * Structs are now padded correctly to the alignment of the struct's  
-    largest field
-  * Global library variables
-  * Callbacks in global library variables
-  * Strings passed in as :string arguments are scrubbed to avoid 
-    poison-null-byte attacks.
-  * Union support
-  * nil can be passed as a :string argument (passed as NULL)
-  * Structs can now be fields inside another struct
-  * Lots of internal cleanups and refactorings.
- 

data/README.rdoc

@@ -1,70 +0,0 @@
-ruby-ffi
-    by Wayne Meissner
-    http://wiki.github.com/ffi/ffi
-
-== 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 should you write your next extension
-using Ruby-FFI here[http://wiki.github.com/ffi/ffi/why-use-ffi].
-
-== FEATURES/PROBLEMS:
-
-* It has a very intuitive DSL
-* It supports all C native types
-* It supports C structs (also nested), enums and global variables
-* It supports callbacks
-* It has smart methods to handle memory management of pointers and structs
-
-== SYNOPSIS:
-
-  require 'ffi'
-
-  module MyLib
-    extend FFI::Library
-    ffi_lib 'c'
-    attach_function :puts, [ :string ], :int
-  end
-
-  MyLib.puts 'Hello boys using libc!'
-
-For less minimalistic and more sane examples you may look at:
-
-* the samples/ folder
-* the examples on the wiki[http://wiki.github.com/ffi/ffi]
-* the projects using FFI listed on this page[http://wiki.github.com/ffi/ffi/projects-using-ffi]
-
-== REQUIREMENTS:
-
-* You need a sane building environment in order to compile the extension.
-
-== DOWNLOAD/INSTALL:
-
-From rubyforge:
-
-  [sudo] gem install ffi
-
-or from the git repository on github:
-
-  git clone git://github.com/ffi/ffi.git
-  cd ffi
-  rake gem:install
-
-== CREDITS:
-
-Special thanks to:
-
-* Yehuda Katz
-* Luc Heinrich
-* Andrea Fazzi
-* Mike Dalessio
-* Hongli Lai
-* Evan Phoenix
-* Aman Gupta
-* Beoran
-
-== LICENSE:
-
-See LICENSE file.

data/ext/ffi_c/DataConverter.c

@@ -1,62 +0,0 @@
-
-#include <ruby.h>
-
-#include <ffi.h>
-#include "rbffi.h"
-
-#include "Type.h"
-#include "MappedType.h"
-
-
-VALUE rbffi_DataConverterClass = Qnil;
-static ID id_native_type_ivar;
-
-static VALUE
-conv_native_type(int argc, VALUE* argv, VALUE self)
-{
-    if (argc == 0) {
-        if (!rb_ivar_defined(self, id_native_type_ivar)) {
-            rb_raise(rb_eNotImpError, "native_type method not overridden and no native_type set");
-        }
-
-        return rb_ivar_get(self, id_native_type_ivar);
-
-    } else if (argc == 1) {
-        VALUE type = rbffi_Type_Find(argv[0]);
-
-        rb_ivar_set(self, id_native_type_ivar, type);
-
-        return type;
-
-    } else {
-        rb_raise(rb_eArgError, "incorrect arguments");
-    }
-}
-
-static VALUE
-conv_to_native(VALUE self, VALUE value, VALUE ctx)
-{
-    return value;
-}
-
-static VALUE
-conv_from_native(VALUE self, VALUE value, VALUE ctx)
-{
-    return value;
-}
-
-
-
-void
-rbffi_DataConverter_Init(VALUE moduleFFI)
-{
-    rbffi_DataConverterClass = rb_define_module_under(moduleFFI, "DataConverter");
-
-    rb_define_method(rbffi_DataConverterClass, "native_type", conv_native_type, -1);
-    rb_define_method(rbffi_DataConverterClass, "to_native", conv_to_native, 2);
-    rb_define_method(rbffi_DataConverterClass, "from_native", conv_from_native, 2);
-
-    id_native_type_ivar = rb_intern("@native_type");
-}
-
-

data/ext/ffi_c/StructByReference.c

@@ -1,150 +0,0 @@
-/*
- * Copyright (c) 2010, Wayne Meissner
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * * Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- * * Redistributions in binary form must reproduce the above copyright notice
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- * * The name of the author or authors may not be used to endorse or promote
- *   products derived from this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-#include <sys/param.h>
-#include <sys/types.h>
-#include <stdio.h>
-#include <stdint.h>
-#include <stdbool.h>
-#include <errno.h>
-#include <ruby.h>
-
-#include <ffi.h>
-#include "rbffi.h"
-#include "compat.h"
-
-#include "Pointer.h"
-#include "Struct.h"
-#include "StructByReference.h"
-
-
-#define FFI_ALIGN(v, a)  (((((size_t) (v))-1) | ((a)-1))+1)
-
-static VALUE sbr_allocate(VALUE);
-static VALUE sbr_initialize(VALUE, VALUE);
-static void sbr_mark(StructByReference *);
-
-VALUE rbffi_StructByReferenceClass = Qnil;
-
-static VALUE
-sbr_allocate(VALUE klass)
-{
-    StructByReference* sbr;
-
-    VALUE obj = Data_Make_Struct(klass, StructByReference, sbr_mark, -1, sbr);
-
-    sbr->rbStructClass = Qnil;
-
-    return obj;
-}
-
-static VALUE
-sbr_initialize(VALUE self, VALUE rbStructClass)
-{
-    StructByReference* sbr = NULL;
-    
-    if (!rb_class_inherited_p(rbStructClass, rbffi_StructClass)) {
-        rb_raise(rb_eTypeError, "wrong type (expected subclass of FFI::Struct)");
-    }
-
-    Data_Get_Struct(self, StructByReference, sbr);
-    sbr->rbStructClass = rbStructClass;
-    
-    return self;
-}
-
-static void
-sbr_mark(StructByReference *sbr)
-{
-    rb_gc_mark(sbr->rbStructClass);
-}
-
-
-static VALUE
-sbr_struct_class(VALUE self)
-{
-    StructByReference* sbr;
-
-    Data_Get_Struct(self, StructByReference, sbr);
-
-    return sbr->rbStructClass;
-}
-
-static VALUE
-sbr_native_type(VALUE self)
-{
-    return rb_const_get(rbffi_TypeClass, rb_intern("POINTER"));
-}
-
-static VALUE
-sbr_to_native(VALUE self, VALUE value, VALUE ctx)
-{
-    StructByReference* sbr;
-    Struct* s;
-
-    if (unlikely(value == Qnil)) {
-        return rbffi_NullPointerSingleton;
-    }
-
-    Data_Get_Struct(self, StructByReference, sbr);
-    if (!rb_obj_is_kind_of(value, sbr->rbStructClass)) {
-        rb_raise(rb_eTypeError, "wrong argument type %s (expected %s)",
-                rb_obj_classname(value),
-                RSTRING_PTR(rb_class_name(sbr->rbStructClass)));
-    }
-
-    Data_Get_Struct(value, Struct, s);
-
-    return s->rbPointer;
-}
-
-static VALUE
-sbr_from_native(VALUE self, VALUE value, VALUE ctx)
-{
-    StructByReference* sbr;
-
-    Data_Get_Struct(self, StructByReference, sbr);
-
-    return rb_class_new_instance(1, &value, sbr->rbStructClass);
-}
-
-
-void
-rbffi_StructByReference_Init(VALUE moduleFFI)
-{
-    rbffi_StructByReferenceClass = rb_define_class_under(moduleFFI, "StructByReference", rb_cObject);
-    rb_global_variable(&rbffi_StructByReferenceClass);
-    rb_include_module(rbffi_StructByReferenceClass, rb_const_get(moduleFFI, rb_intern("DataConverter")));
-    
-    rb_define_alloc_func(rbffi_StructByReferenceClass, sbr_allocate);
-    rb_define_method(rbffi_StructByReferenceClass, "initialize", sbr_initialize, 1);
-    rb_define_method(rbffi_StructByReferenceClass, "struct_class", sbr_struct_class, 0);
-    rb_define_method(rbffi_StructByReferenceClass, "native_type", sbr_native_type, 0);
-    rb_define_method(rbffi_StructByReferenceClass, "to_native", sbr_to_native, 2);
-    rb_define_method(rbffi_StructByReferenceClass, "from_native", sbr_from_native, 2);
-}
-

data/ext/ffi_c/StructByReference.h

@@ -1,50 +0,0 @@
-/*
- * Copyright (c) 2009, Wayne Meissner
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * * Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- * * Redistributions in binary form must reproduce the above copyright notice
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- * * The name of the author or authors may not be used to endorse or promote
- *   products derived from this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-#ifndef RBFFI_STRUCTBYREFERENCE_H
-#define	RBFFI_STRUCTBYREFERENCE_H
-
-#include <ruby.h>
-
-#ifdef	__cplusplus
-extern "C" {
-#endif
-
-typedef struct StructByReference_ {
-    VALUE rbStructClass;
-} StructByReference;
-
-void rbffi_StructByReference_Init(VALUE moduleFFI);
-
-extern VALUE rbffi_StructByReferenceClass;
-
-#ifdef	__cplusplus
-}
-#endif
-
-#endif	/* RBFFI_STRUCTBYREFERENCE_H */
-