rbdc 0.8.0

data/dyncall/dyncallback/gen-masm.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+# Uses portasm to generates MASM sources for intel platforms.
+printf "; auto-generated by `basename $0`\r\n" >dyncall_callback_x86_masm.asm
+printf "; auto-generated by `basename $0`\r\n" >dyncall_callback_x64_masm.asm
+gcc -E -P -DGEN_MASM dyncall_callback_x86.S | awk '{printf "%s\r\n", $0}' >> dyncall_callback_x86_masm.asm
+gcc -E -P -DGEN_MASM dyncall_callback_x64.S | awk '{printf "%s\r\n", $0}' >> dyncall_callback_x64_masm.asm
+

data/dyncall/dyncallback/mkfile

@@ -0,0 +1,29 @@
+#//////////////////////////////////////////////////////////////////////////////
+#
+# Copyright (c) 2013 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.
+#
+#//////////////////////////////////////////////////////////////////////////////
+
+
+TOP		= ..
+<$TOP/buildsys/mk/prolog.mk
+
+
+LIBRARY		= dyncallback
+UNITS = $UNITS dyncall_alloc_wx dyncall_args dyncall_callback dyncall_callback_arch dyncall_thunk
+
+
+<$TOP/buildsys/mk/epilog.mk

data/dyncall/dynload/CMakeLists.txt

@@ -0,0 +1,25 @@
+# Package: dyncall
+# File: dynload/CMakeLists.txt
+# Description: DynLoad library cmake files
+# License:
+#
+# Copyright (c) 2010 Daniel Adler <dadler@uni-goettingen.de>
+# 
+# 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.
+#
+
+add_library(dynload_s STATIC dynload.c dynload_syms.c)
+install(TARGETS dynload_s ARCHIVE DESTINATION lib)
+install(FILES dynload.h DESTINATION include)
+
+

data/dyncall/dynload/DynLoadConfig.cmake

@@ -0,0 +1,3 @@
+set(DYNLOAD_INCLUDE_DIRS ${DynCall_SOURCE_DIR}/dynload)
+set(DYNLOAD_LIBRARIES dynload_s)
+

data/dyncall/dynload/Makefile.M

@@ -0,0 +1,10 @@
+#include "../buildsys/dynmake/Makefile.base.M"
+
+all: _L(dynload_s)
+
+_L(dynload_s): _O(dynload) _O(dynload_syms)
+	_(AR) _(ARFLAGS) _(ARFLAG_OUT_PREFIX)_(TARGET) _(PREREQS)
+
+clean:
+        _(RM) _O(*)
+        _(RM) _L(dynload_s)

data/dyncall/dynload/Makefile.embedded

@@ -0,0 +1,22 @@
+MAKEFILE  = Makefile.embedded
+MAKE_CMD  = ${MAKE} -f Makefile.embedded
+TARGET    = libdynload_s.a
+OBJS      = dynload.o dynload_syms.o
+HEADERS	  = dynload.h
+all: ${TARGET}
+libdynload_s.a: ${OBJS}
+	${AR} ${ARFLAGS} $@ ${OBJS}
+clean:
+	rm -f ${OBJS} ${TARGET}
+install: all
+	mkdir -p ${DESTDIR}${PREFIX}/include
+	cp ${HEADERS} ${DESTDIR}${PREFIX}/include
+	mkdir -p ${DESTDIR}${PREFIX}/lib
+	cp ${TARGET} ${DESTDIR}${PREFIX}/lib
+.PHONY: all clean install
+osx-universal:
+	CFLAGS="${CFLAGS} -arch i386 -arch x86_64 -arch ppc" ASFLAGS="${ASFLAGS} -arch i386 -arch x86_64 -arch ppc" AR="libtool" ARFLAGS="-static -o" ${MAKE_CMD} all
+sun-64bit:
+	CFLAGS="${CFLAGS} -m64" ASFLAGS="${ASFLAGS} -m64" ${MAKE_CMD} all
+sun-gcc:
+	CC=gcc CFLAGS="${CFLAGS} -fPIC" ${MAKE_CMD} all

data/dyncall/dynload/Makefile.generic

@@ -0,0 +1,18 @@
+LIBNAME = dynload
+OBJS 	= dynload.o dynload_syms.o
+HEADERS = ${VPATH}/dynload.h 
+
+LIB = lib${LIBNAME}_s.a
+
+.PHONY: all clean install
+
+all: ${LIB}
+${LIB}: ${OBJS}
+	${AR} ${ARFLAGS} ${LIB} ${OBJS}
+clean:
+	rm -f ${OBJS} ${LIB}
+install: all
+	mkdir -p ${PREFIX}/lib
+	mkdir -p ${PREFIX}/include
+	cp ${LIB} ${PREFIX}/lib
+	cp ${HEADERS} ${PREFIX}/include

data/dyncall/dynload/Nmakefile

@@ -0,0 +1,57 @@
+#//////////////////////////////////////////////////////////////////////////////
+#
+# Copyright (c) 2007,2009 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.
+#
+#//////////////////////////////////////////////////////////////////////////////
+
+#///////////////////////////////////////////////////
+#
+#	nmake makefile
+#	Nmakefile
+#
+#///////////////////////////////////////////////////
+
+
+TOP=..
+
+!INCLUDE $(TOP)\buildsys\nmake\prolog.nmake
+
+
+!IF "$(BUILD_OS)" == "windows"
+
+TARGETS = libdynload_s.lib
+OBJS = dynload.obj dynload_syms.obj
+
+$(TARGETS): $(OBJS)
+	echo Creating library $@ ...
+	lib $(ARFLAGS) /OUT:"$@" $(OBJS) > nul
+
+
+!ELSE IF "$(BUILD_OS)" == "nds"
+
+TARGETS = libdynload_s.a
+OBJS = dynload_unix.o
+
+$(TARGETS):# $(OBJS)
+	echo Not building dynload: There is no dynload support on this platform.
+#	echo Creating library $@ ...
+#	$(AR) -rc $(ARFLAGS) "$@" $(OBJS)
+
+!ENDIF
+
+
+!INCLUDE $(TOP)\buildsys\nmake\epilog.nmake
+

data/dyncall/dynload/README.txt

@@ -0,0 +1,113 @@
+dynload / abstraction to run-time shared library services:
+
+- loading/unloading into the current process
+- symbol lookup
+- enumerating symbol tables
+- elf: support for DT_GNU_HASH
+
+
+Todo:
+- a.out format
+- support for different kind of symbols
+  (exports,imports,sections,constants...)
+
+Notes on windows pe format:
+
+File Extension: dll
+
+Implementation:
+
+1. Access to internals
+   The handle returned by LoadLibrary() is a pointer to the PE header 
+   (which is a DOS header).
+
+
+Notes on elf:
+
+File Extension: so
+Variants: Two core classes are defined Elf 32- and 64-bit. 
+Only one model is compiled in the library (the current run-time format).
+
+Dynamic symbol table:
+
+Symbol table layout:
+1. Index 0 in any symbol table is used to represent undefined symbols.
+As such, the first entry in a symbol table (index 0) is always completely
+zeroed (type STT_NOTYPE), and is not used.
+
+2. If the file contains any local symbols, the second entry (index 1)
+the symbol table will be a STT_FILE symbol giving the name of the file.
+
+3. Section symbols.
+
+4. Register symbols.
+
+5. Global symbols that have been reduced to local scope via a mapfile.
+
+6. For each input file that supplied local symbols, a STT_FILE symbol
+   giving the name of the input file is put in the symbol table, 
+   followed by the symbols in question.
+
+7. The global symbols immediately follow the local symbols in the
+   symbol table. Local and global symbols are always kept separate
+   in this manner, and cannot be mixed together.
+
+
+Dynamic symbol table handling seem to be different among platforms.
+Due to System V ABI, one get access to the dynamic symbol table through
+the DT_HASH entry in "DYNAMIC" Program Header.
+
+It does not work on x86 on a x86_64 linux 2.6 machine.
+
+A closer look to the binaries in /usr/lib32 revealed, there are differences:
+
+differences
+ - elf32 has 21 sections
+ - elf64 has (21 + 2) sections
+     ".hash"
+     ".eh_frame_hdr"
+ -       elf64 has  ".rela.*" 
+   while elf32 has  ".rel.*"
+ 
+in common:
+ - both have a ".gnu.hash" section
+
+
+the ".gnu.hash" 
+
+
+Idea: "GNU hash" method ([3])
+
+
+Symbol Versioning:
+
+
+
+OS supported prelinking:
+
+linux has prelink
+irix has quickstart
+solaris has crle
+
+sparc uses STT_REGISTER:
+  STT_REGISTER is
+    The Sparc architecture has a concept known as a "register symbol". These
+    symbols are used to validate symbol/register usage, and can also be
+    used to initialize global registers. Other architectures don't use these.
+
+
+
+
+
+
+
+References:
+[1] Levin, R. John: Linkers & Loader
+[2] System V ABI
+[3] The cost of elf symbol hashing: http://blogs.sun.com/ali/entry/the_cost_of_elf_symbol 
+[4] GNU Hash ELF Section: http://blogs.sun.com/ali/entry/gnu_hash_elf_sections
+[5] http://refspecs.freestandards.org/LSB_3.2.0/LSB-Core-generic/LSB-Core-generic/symversion.html
+[6] elf: http://greek0.net/elf.html
+[7] System V ABI Application Binary Interface - Draft 17 - December 2003 (SCO) : 
+    http://sco.com/developers/gabi/latest/contents.html 
+

data/dyncall/dynload/TODO

@@ -0,0 +1,20 @@
+- RTLD_LAZY in darwin, why not in unix?
+- Failed On Open Solaris 11:
+  
+In file included from dynload_syms.c:28:
+dynload_syms_elf.c:56: error: syntax error before "Elf_Dyn"
+dynload_syms_elf.c:56: warning: data definition has no type or storage class
+dynload_syms_elf.c: In function `dlSymsInit':
+dynload_syms_elf.c:155: error: `pDyn' undeclared (first use in this function)
+dynload_syms_elf.c:155: error: (Each undeclared identifier is reported only once
+dynload_syms_elf.c:155: error: for each function it appears in.)
+dynload_syms_elf.c:155: error: syntax error before ')' token
+dynload_syms_elf.c:160: error: `DT_NULL' undeclared (first use in this function)
+dynload_syms_elf.c:163: error: `DT_STRTAB' undeclared (first use in this function)
+dynload_syms_elf.c:164: error: `DT_SYMTAB' undeclared (first use in this function)
+dynload_syms_elf.c:165: error: `DT_HASH' undeclared (first use in this function)
+make: *** [dynload_syms.o] Error 1
+
+DONE:
+- remove dependencies dyncall_{alloc,macros}.h
+

data/dyncall/dynload/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/dynload/dynload.3

@@ -0,0 +1,64 @@
+.\" Copyright (c) 2007-2014 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 dynload 3
+.Os
+
+.Sh NAME
+.Nm dynload
+.Nd encapsulates dynamic loading mechanisms and
+gives access to functions in foreign dynamic libraries and code modules.
+.Sh SYNOPSIS
+.In dynload.h
+.Ft DLLib *
+.Fn dlLoadLibrary "const char * libpath"
+.Ft void
+.Fn dlFreeLibrary "DLLib * pLib"
+.Ft void *
+.Fn dlFindSymbol "DLLib pLibode" "const char * pSymbolName"
+.Sh DESCRIPTION
+The
+.Nm
+library provides an interface to load foreign dynamic libraries and access
+to their symbols.
+.Pp
+.Fn dlLoadLibrary
+loads a dynamic library at
+.Ar libpath
+and returns a handle to it for use in
+.Fn dlFreeLibrary 
+and
+.Fn dlFindSymbol
+calls.
+.Pp
+.Fn dlFreeLibrary 
+frees the loaded library with handle
+.Ar pLib .
+.Pp
+.Fn dlFindSymbol
+returns a pointer to a symbol with name
+.Ar pSymbolName
+in the library with handle
+.Ar pLib ,
+or returns a null pointer if the symbol cannot be found.
+.Sh SEE ALSO
+.Xr dyncall 3 ,
+.Xr dyncallback 3
+and the dyncall 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/dynload/dynload.c

@@ -0,0 +1,38 @@
+/*
+
+ Package: dyncall
+ Library: dynload
+ File: dynload/dynload.c
+ Description: Auto-include delegate to windows/posix-based dynamic linker.
+ 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.
+
+*/
+
+
+#include "../autovar/autovar_OSFAMILY.h"
+#if defined(OSFAMILY_Windows)
+#  include "dynload_windows.c"
+#elif defined(OSFAMILY_Unix)
+#  include "../autovar/autovar_OS.h"
+#  if defined(OS_Darwin)
+#    include "dynload_darwin.c"
+#  else
+#    include "dynload_unix.c"
+#  endif
+#endif
+

data/dyncall/dynload/dynload.h

@@ -0,0 +1,65 @@
+/*
+
+ Package: dyncall
+ Library: dynload
+ File: dynload/dynload.h
+ Description: public header for library dynload
+ 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 DYNLOAD_H
+#define DYNLOAD_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifndef DL_API
+#define DL_API
+#endif
+
+/* --- public api ---------------------------------------------------------- */
+
+/* shared library loading and explicit symbol resolving */
+
+typedef struct DLLib_ DLLib;
+
+DL_API DLLib* dlLoadLibrary(const char* libpath);
+DL_API void   dlFreeLibrary(DLLib* pLib);
+DL_API void*  dlFindSymbol(DLLib* pLib, const char* pSymbolName);
+
+/* symbol table enumeration - only for symbol lookup, not resolve */
+
+typedef struct DLSyms_ DLSyms;
+
+DL_API DLSyms*     dlSymsInit   (const char* libPath);
+DL_API void        dlSymsCleanup(DLSyms* pSyms);
+
+DL_API int         dlSymsCount        (DLSyms* pSyms);
+DL_API const char* dlSymsName         (DLSyms* pSyms, int index);
+DL_API const char* dlSymsNameFromValue(DLSyms* pSyms, void* value); /* symbol must be loaded */
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* DYNLOAD_H */
+