rbdc 0.8.0

data/dyncall/dyncall/README.txt

@@ -0,0 +1,65 @@
+Library Design
+
+Overview:
+1. Call Kernel
+2. Utilities (memory and static sized vectors)
+3. Call State Machine
+4. Application Programming Interface
+5. extension: high-level formatted C API (ellipsis style)
+
+
+1. Call Kernel 
+
+Assembly Implementation:
+
+  gcc front-end: dyncall_call.S
+    uses the C preprocessor
+    will include the apropriate assembly source
+
+  architecture/tool specific sources:
+    dyncall_call_<ARCH>_<ASMTOOL>.[s|asm]
+
+
+2. Utilities (memory and static sized vectors)
+
+2.1 Memory Management
+
+C Interface: dyncall_alloc.h
+
+
+2.2 Static-sized Vector
+
+C Interface: dyncall_vector.h
+
+C Implementation: dyncall_vector.c
+
+
+3. Call State Machine
+
+C Implementation:
+  Top-level: dynall_callvm.c
+  Sub-levels: 
+    dyncall_callvm_<ARCH>.c
+
+
+4. Application Programming Interface
+
+C Header:
+  Top-level: dyncall.h
+  Sub-level headers: 
+    dyncall_macros.h 
+    dyncall_config.h 
+    dyncall_types.h 
+C Implementation: dyncall_api.c
+
+
+5. Extension: High-level C API (ellipsis style)
+
+C Header:
+  Top-level: dyncall_callf.h
+  Sub-level headers:
+    dyncall_value.h
+    dyncall_signature.h
+C Implementation: dyncall_callf.c
+
+

data/dyncall/dyncall/TODO

@@ -0,0 +1,9 @@
+- implement structure passing for all calling conventinos and platforms
+- make sure that struct support for ellipsis calls are not forgotten (copy everything by value)
+
+- merge arm32_thumb_{gas/apple} and include thumb support for portasm
+- check dyncall_call_x64_traditional_cpp.S / try-sync with win64 masm
+- remove dyncall_call_x86_apple.s
+- x64 port cleanup: all x64 calling conventions on all platforms
+- remove dyncall_call_x86_masm.asm dyncall_call_x64_masm.asm
+- x64 verification: return values are passed via RAX and RDX, and XMM0 and XMM1.

data/dyncall/dyncall/dynMakefile

@@ -0,0 +1,4 @@
+all: ./../buildsys/dynmake/dynmake.bat
+	$(?:/=\\) all $(MAKE) && exit || sh $(?:bat=sh) all $(MAKE)
+clean: ./../buildsys/dynmake/dynmake.bat
+	$(?:/=\\) clean $(MAKE) && exit || sh $(?:bat=sh) clean $(MAKE)

data/dyncall/dyncall/dyncall.3

@@ -0,0 +1,189 @@
+.\" Copyright (c) 2007-2013 Daniel Adler <dadler AT uni-goettingen DOT de>, 
+.\"                         Tassilo Philipp <tphilipp AT potion-studios DOT com>
+.\" 
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate$
+.Dt dyncall 3
+.Os
+
+.Sh NAME
+.Nm dyncall
+.Nd encapsulation of architecture-, OS- and compiler-specific function call
+semantics 
+.Sh SYNOPSIS
+.In dyncall.h
+.Ft DCCallVM *
+.Fn dcNewCallVM "DCsize size"
+.Ft void
+.Fn dcFree "DCCallVM * vm"
+.Ft void
+.Fn dcMode "DCCallVM * vm" "DCint mode"
+.Ft void
+.Fn dcReset "DCCallVM * vm"
+.Ft void
+.Fn dcArgBool "DCCallVM * vm" "DCbool arg"
+.Ft void
+.Fn dcArgChar "DCCallVM * vm" "DCchar arg"
+.Ft void
+.Fn dcArgShort "DCCallVM * vm" "DCshort arg"
+.Ft void
+.Fn dcArgInt "DCCallVM * vm" "DCint arg"
+.Ft void
+.Fn dcArgLong "DCCallVM * vm" "DClong arg"
+.Ft void
+.Fn dcArgLongLong "DCCallVM * vm" "DClonglong arg"
+.Ft void
+.Fn dcArgFloat "DCCallVM * vm" "DCfloat arg"
+.Ft void
+.Fn dcArgDouble "DCCallVM * vm" "DCdouble arg"
+.Ft void
+.Fn dcArgPointer "DCCallVM * vm" "DCpointer arg"
+.Ft DCvoid
+.Fn dcCallVoid "DCCallVM * vm" "DCpointer funcptr"
+.Ft DCbool
+.Fn dcCallBool "DCCallVM * vm" "DCpointer funcptr"
+.Ft DCchar
+.Fn dcCallChar "DCCallVM * vm" "DCpointer funcptr"
+.Ft DCshort
+.Fn dcCallShort "DCCallVM * vm" "DCpointer funcptr"
+.Ft DCint
+.Fn dcCallInt "DCCallVM * vm" "DCpointer funcptr"
+.Ft DClong
+.Fn dcCallLong "DCCallVM * vm" "DCpointer funcptr"
+.Ft DClonglong
+.Fn dcCallLongLong "DCCallVM * vm" "DCpointer funcptr"
+.Ft DCfloat
+.Fn dcCallFloat "DCCallVM * vm" "DCpointer funcptr"
+.Ft DCdouble
+.Fn dcCallDouble "DCCallVM * vm" "DCpointer funcptr"
+.Ft DCpointer
+.Fn dcCallPointer "DCCallVM * vm" "DCpointer funcptr"
+.Ft void
+.Fn dcCallF "DCCallVM * vm" "DCValue * result" "DCpointer funcptr" "const DCsigchar * signature" "..."
+.Ft void
+.Fn dcVCallF "DCCallVM * vm" "DCValue * result" "DCpointer funcptr" "const DCsigchar * signature" "va_list args"
+.Sh DESCRIPTION
+The
+.Nm
+library encapsulates architecture-, OS- and compiler-specific function call
+semantics in a virtual "bind argument parameters from left to right and then
+call" interface allowing programmers to call C functions in a completely
+dynamic manner.
+.Pp
+In other words, instead of calling a function directly, the
+.Nm
+library provides a mechanism to push the function parameters manually and to
+issue the call afterwards.
+.Pp
+Since the idea behind this concept is similar to call dispatching mechanisms
+of virtual machines, the object that can be dynamically loaded with arguments,
+and then used to actually invoke the call, is called CallVM. It is possible to
+change the calling convention used by the CallVM at run-time. Due to the fact
+that nearly every platform comes with one or more distinct calling conventions, the
+.Nm
+library project intends to be a portable and open-source approach to the variety of
+compiler-specific binary interfaces, platform specific subtleties, and so on...
+.Pp
+.Fn dcNewCallVM
+creates a new CallVM object, where
+.Ar size
+specifies the max size of the internal stack that will be allocated and used to
+bind the arguments to. Use
+.Fn dcFree
+to destroy the CallVM object.
+.Pp
+.Fn dcMode
+sets the calling convention to use. See dyncall.h for a list of
+available modes. Note that some mode/platform combinations don't make any
+sense (e.g. using a PowerPC calling convention on a MIPS platform) and are
+silently ignored.
+.Pp
+.Fn dcReset
+resets the internal stack of arguments and prepares it for the selected mode.
+This function should be called after setting the call mode (using dcMode), but
+prior to binding arguments to the CallVM. Use it also when reusing a CallVM, as
+arguments don't get flushed automatically after a function call invocation.
+.Pp
+.Fn dcArgBool ,
+.Fn dcArgChar ,
+.Fn dcArgShort ,
+.Fn dcArgInt ,
+.Fn dcArgLong ,
+.Fn dcArgLongLong ,
+.Fn dcArgFloat ,
+.Fn dcArgDouble
+and
+.Fn dcArgPointer
+are used to bind arguments of the named types to the CallVM object. Arguments should
+be bound in
+.Em "left to right"
+order regarding the C function prototype.
+.Pp
+.Fn dcCallVoid ,
+.Fn dcCallBool ,
+.Fn dcCallChar ,
+.Fn dcCallShort ,
+.Fn dcCallInt ,
+.Fn dcCallLong ,
+.Fn dcCallLongLong ,
+.Fn dcCallFloat ,
+.Fn dcCallDouble
+and
+.Fn dcCallPointer
+call the function with the bound arguments and returning the named type, where
+.Ar funcptr
+is a pointer to the function to call. After the invocation of the function
+call, the argument values are still bound to the CallVM and a second call
+using the same arguments can be issued. Call
+.Fn reset
+to clear the internal argument stack.
+.Pp
+.Fn dcCallF
+and
+.Fn dcVCallF
+can be used to issue a printf-style function call, using a signature
+string encoding the argument types and return type. The return value will be
+stored in
+.Ar result .
+For information about the signature format, refer to the
+.Nm
+manual in PDF format.
+.Sh EXAMPLE
+Let's say, we want to make a call to the function:
+.Bd -literal -offset indent
+	double sqrt(double x); 
+.Ed
+.Pp
+Using the
+.Nm
+library, this function would be called as follows: 
+.Bd -literal -offset indent
+	double r;
+	DCCallVM* vm = dcNewCallVM(4096);
+	dcMode(vm, DC_CALL_C_DEFAULT);
+	dcReset(vm);
+	dcArgDouble(vm, 4.2373);
+	r = dcCallDouble(vm, (DCpointer)&sqrt);
+	dcFree(vm);
+.Ed
+.Sh SEE ALSO
+.Xr dyncallback 3 ,
+.Xr dynload 3
+and the
+.Nm
+manual (available in PDF format) for a way more detailed documentation of this
+library.
+.Sh AUTHORS
+.An "Daniel Adler" Aq dadler@uni-goettingen.de
+.An "Tassilo Philipp" Aq tphilipp@potion-studios.com

data/dyncall/dyncall/dyncall.h

@@ -0,0 +1,135 @@
+/*
+
+ Package: dyncall
+ Library: dyncall
+ File: dyncall/dyncall.h
+ Description: public header for library dyncall
+ License:
+
+   Copyright (c) 2007-2011 Daniel Adler <dadler@uni-goettingen.de>, 
+                           Tassilo Philipp <tphilipp@potion-studios.com>
+
+   Permission to use, copy, modify, and distribute this software for any
+   purpose with or without fee is hereby granted, provided that the above
+   copyright notice and this permission notice appear in all copies.
+
+   THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+   WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+   MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+   ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+*/
+
+
+/*
+
+  dyncall C API
+
+  REVISION
+  2007/12/11 initial
+  
+*/
+
+#ifndef DYNCALL_H
+#define DYNCALL_H
+
+#include "dyncall_types.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif 
+
+typedef struct DCCallVM_    DCCallVM;
+typedef struct DCstruct_    DCstruct;
+
+/* Supported Calling Convention Modes */
+
+#define DC_CALL_C_DEFAULT               0
+#define DC_CALL_C_ELLIPSIS            100
+#define DC_CALL_C_ELLIPSIS_VARARGS    101
+#define DC_CALL_C_X86_CDECL             1
+#define DC_CALL_C_X86_WIN32_STD         2
+#define DC_CALL_C_X86_WIN32_FAST_MS     3
+#define DC_CALL_C_X86_WIN32_FAST_GNU    4
+#define DC_CALL_C_X86_WIN32_THIS_MS     5
+#define DC_CALL_C_X86_WIN32_THIS_GNU    6
+#define DC_CALL_C_X64_WIN64             7
+#define DC_CALL_C_X64_SYSV              8
+#define DC_CALL_C_PPC32_DARWIN          9
+#define DC_CALL_C_PPC32_OSX            DC_CALL_C_PPC32_DARWIN /* alias */
+#define DC_CALL_C_ARM_ARM_EABI         10
+#define DC_CALL_C_ARM_THUMB_EABI       11
+#define DC_CALL_C_ARM_ARMHF            30
+#define DC_CALL_C_MIPS32_EABI          12
+#define DC_CALL_C_MIPS32_PSPSDK        DC_CALL_C_MIPS32_EABI /* alias - deprecated. */
+#define DC_CALL_C_PPC32_SYSV           13
+#define DC_CALL_C_PPC32_LINUX          DC_CALL_C_PPC32_SYSV /* alias */
+#define DC_CALL_C_ARM_ARM              14
+#define DC_CALL_C_ARM_THUMB            15
+#define DC_CALL_C_MIPS32_O32           16
+#define DC_CALL_C_MIPS64_N32           17
+#define DC_CALL_C_MIPS64_N64           18
+#define DC_CALL_C_X86_PLAN9            19
+#define DC_CALL_C_SPARC32              20
+#define DC_CALL_C_SPARC64              21
+#define DC_CALL_SYS_DEFAULT           200
+#define DC_CALL_SYS_X86_INT80H_LINUX  201
+#define DC_CALL_SYS_X86_INT80H_BSD    202
+/* Error codes. */
+
+#define DC_ERROR_NONE                0
+#define DC_ERROR_UNSUPPORTED_MODE   -1
+
+DC_API DCCallVM*  dcNewCallVM     (DCsize size);
+DC_API void       dcFree          (DCCallVM* vm);
+DC_API void       dcReset         (DCCallVM* vm);
+
+DC_API void       dcMode          (DCCallVM* vm, DCint mode);
+
+DC_API void       dcArgBool       (DCCallVM* vm, DCbool     value);
+DC_API void       dcArgChar       (DCCallVM* vm, DCchar     value);
+DC_API void       dcArgShort      (DCCallVM* vm, DCshort    value);
+DC_API void       dcArgInt        (DCCallVM* vm, DCint      value);
+DC_API void       dcArgLong       (DCCallVM* vm, DClong     value);
+DC_API void       dcArgLongLong   (DCCallVM* vm, DClonglong value);
+DC_API void       dcArgFloat      (DCCallVM* vm, DCfloat    value);
+DC_API void       dcArgDouble     (DCCallVM* vm, DCdouble   value);
+DC_API void       dcArgPointer    (DCCallVM* vm, DCpointer  value);
+DC_API void       dcArgStruct     (DCCallVM* vm, DCstruct* s, DCpointer value);
+
+DC_API void       dcCallVoid      (DCCallVM* vm, DCpointer funcptr);
+DC_API DCbool     dcCallBool      (DCCallVM* vm, DCpointer funcptr);
+DC_API DCchar     dcCallChar      (DCCallVM* vm, DCpointer funcptr);
+DC_API DCshort    dcCallShort     (DCCallVM* vm, DCpointer funcptr);
+DC_API DCint      dcCallInt       (DCCallVM* vm, DCpointer funcptr);
+DC_API DClong     dcCallLong      (DCCallVM* vm, DCpointer funcptr);
+DC_API DClonglong dcCallLongLong  (DCCallVM* vm, DCpointer funcptr);
+DC_API DCfloat    dcCallFloat     (DCCallVM* vm, DCpointer funcptr);
+DC_API DCdouble   dcCallDouble    (DCCallVM* vm, DCpointer funcptr);
+DC_API DCpointer  dcCallPointer   (DCCallVM* vm, DCpointer funcptr);
+DC_API void       dcCallStruct    (DCCallVM* vm, DCpointer funcptr, DCstruct* s, DCpointer returnValue);
+
+DC_API DCint      dcGetError      (DCCallVM* vm);
+
+#define DEFAULT_ALIGNMENT 0
+DC_API DCstruct*  dcNewStruct      (DCsize fieldCount, DCint alignment);
+DC_API void       dcStructField    (DCstruct* s, DCint type, DCint alignment, DCsize arrayLength);
+DC_API void       dcSubStruct      (DCstruct* s, DCsize fieldCount, DCint alignment, DCsize arrayLength);  	
+/* Each dcNewStruct or dcSubStruct call must be paired with a dcCloseStruct. */
+DC_API void       dcCloseStruct    (DCstruct* s);  	
+DC_API DCsize     dcStructSize     (DCstruct* s);  	
+DC_API DCsize     dcStructAlignment(DCstruct* s);  	
+DC_API void       dcFreeStruct     (DCstruct* s);
+
+DC_API DCstruct*  dcDefineStruct  (const char* signature);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* DYNCALL_H */
+

data/dyncall/dyncall/dyncall_alloc.h

@@ -0,0 +1,40 @@
+/*
+
+ Package: dyncall
+ Library: dyncall
+ File: dyncall/dyncall_alloc.h
+ Description: heap memory management interface (header only)
+ License:
+
+   Copyright (c) 2007-2011 Daniel Adler <dadler@uni-goettingen.de>, 
+                           Tassilo Philipp <tphilipp@potion-studios.com>
+
+   Permission to use, copy, modify, and distribute this software for any
+   purpose with or without fee is hereby granted, provided that the above
+   copyright notice and this permission notice appear in all copies.
+
+   THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+   WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+   MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+   ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+*/
+
+
+#ifndef DYNCALL_ALLOC_H
+#define DYNCALL_ALLOC_H
+
+#ifndef dcAllocMem
+#include <stdlib.h>
+#define dcAllocMem malloc
+#endif
+
+#ifndef dcFreeMem
+#define dcFreeMem  free
+#endif
+
+#endif /* DYNCALL_ALLOC_H */
+