view go/godc/godc.go @ 37:8c8f848131c6

- version bump - better doc - made calling convention mode reset by default, as only way to specify convention used is via signature string
author Tassilo Philipp
date Mon, 13 Apr 2020 20:08:54 +0200
parents 8a45a05ff64e
children 1e3d929e43be
line wrap: on
line source

/*

 godc.go
 Copyright (c) 2014 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.

*/


// Go/dyncall extension implementation.
package godc

// #cgo LDFLAGS: -ldyncall_s
// #cgo LDFLAGS: -ldynload_s
// #cgo LDFLAGS: -ldyncallback_s
// #include <stdlib.h>
// #include "dyncall.h"
// #include "dynload.h"
// #include "dyncall_signature.h"
import "C"
import (
	"unsafe"
	"fmt"
	"reflect"
)

type ExtLib struct {
	lib  *C.DLLib
	syms *C.DLSyms
}

type CallVM struct {
	cvm  *C.DCCallVM
}


// dynload
func (p *ExtLib) Load(path string) error {
	s := C.CString(path)
	defer C.free(unsafe.Pointer(s))
	p.lib = C.dlLoadLibrary(s)
	if p.lib != nil { return nil }
	return fmt.Errorf("Can't load %s", path)
}

func (p *ExtLib) Free() {
	C.dlFreeLibrary(p.lib)
}

func (p *ExtLib) FindSymbol(name string) unsafe.Pointer {
	s := C.CString(name)
	defer C.free(unsafe.Pointer(s))
	return unsafe.Pointer(C.dlFindSymbol(p.lib, s))
}


// dynload Syms
func (p *ExtLib) SymsInit(path string) error {
	s := C.CString(path)
	defer C.free(unsafe.Pointer(s))
	p.syms = C.dlSymsInit(s)
	if p.syms != nil { return nil }
	return fmt.Errorf("Can't load %s", path)
}

func (p *ExtLib) SymsCleanup() {
	C.dlSymsCleanup(p.syms)
}

func (p *ExtLib) SymsCount() int {
	return int(C.dlSymsCount(p.syms))
}

func (p *ExtLib) SymsName(i int) string {
	return C.GoString(C.dlSymsName(p.syms, C.int(i)))
}

func (p *ExtLib) SymsNameFromValue(v unsafe.Pointer) string {
	return C.GoString(C.dlSymsNameFromValue(p.syms, v))
}


// dyncall
func (p *CallVM) InitCallVM() error {
	return p.InitCallVMWithStackSize(4096)
}

func (p *CallVM) InitCallVMWithStackSize(stackSize int) error {
	p.cvm = C.dcNewCallVM(C.DCsize(stackSize))
	if p.cvm != nil { return nil }
	return fmt.Errorf("Can't create CallVM")
}

func (p *CallVM) Free() {
	C.dcFree(p.cvm)
}

func (p *CallVM) Reset() {
	C.dcReset(p.cvm)
}



// Modes
const (
	DC_CALL_C_DEFAULT            = C.DC_CALL_C_DEFAULT
	DC_CALL_C_ELLIPSIS           = C.DC_CALL_C_ELLIPSIS
	DC_CALL_C_ELLIPSIS_VARARGS   = C.DC_CALL_C_ELLIPSIS_VARARGS
	DC_CALL_C_X86_CDECL          = C.DC_CALL_C_X86_CDECL
	DC_CALL_C_X86_WIN32_STD      = C.DC_CALL_C_X86_WIN32_STD
	DC_CALL_C_X86_WIN32_FAST_MS  = C.DC_CALL_C_X86_WIN32_FAST_MS
	DC_CALL_C_X86_WIN32_FAST_GNU = C.DC_CALL_C_X86_WIN32_FAST_GNU
	DC_CALL_C_X86_WIN32_THIS_MS  = C.DC_CALL_C_X86_WIN32_THIS_MS
	DC_CALL_C_X86_WIN32_THIS_GNU = C.DC_CALL_C_X86_WIN32_THIS_GNU
	DC_CALL_C_X64_WIN64          = C.DC_CALL_C_X64_WIN64
	DC_CALL_C_X64_SYSV           = C.DC_CALL_C_X64_SYSV
	DC_CALL_C_PPC32_DARWIN       = C.DC_CALL_C_PPC32_DARWIN
	DC_CALL_C_PPC32_OSX          = C.DC_CALL_C_PPC32_OSX
	DC_CALL_C_ARM_ARM_EABI       = C.DC_CALL_C_ARM_ARM_EABI
	DC_CALL_C_ARM_THUMB_EABI     = C.DC_CALL_C_ARM_THUMB_EABI
	DC_CALL_C_ARM_ARMHF          = C.DC_CALL_C_ARM_ARMHF
	DC_CALL_C_MIPS32_EABI        = C.DC_CALL_C_MIPS32_EABI
	DC_CALL_C_MIPS32_PSPSDK      = C.DC_CALL_C_MIPS32_PSPSDK
	DC_CALL_C_PPC32_SYSV         = C.DC_CALL_C_PPC32_SYSV
	DC_CALL_C_PPC32_LINUX        = C.DC_CALL_C_PPC32_LINUX
	DC_CALL_C_ARM_ARM            = C.DC_CALL_C_ARM_ARM
	DC_CALL_C_ARM_THUMB          = C.DC_CALL_C_ARM_THUMB
	DC_CALL_C_MIPS32_O32         = C.DC_CALL_C_MIPS32_O32
	DC_CALL_C_MIPS64_N32         = C.DC_CALL_C_MIPS64_N32
	DC_CALL_C_MIPS64_N64         = C.DC_CALL_C_MIPS64_N64
	DC_CALL_C_X86_PLAN9          = C.DC_CALL_C_X86_PLAN9
	DC_CALL_C_SPARC32            = C.DC_CALL_C_SPARC32
	DC_CALL_C_SPARC64            = C.DC_CALL_C_SPARC64
	DC_CALL_SYS_DEFAULT          = C.DC_CALL_SYS_DEFAULT
	DC_CALL_SYS_X86_INT80H_LINUX = C.DC_CALL_SYS_X86_INT80H_LINUX
	DC_CALL_SYS_X86_INT80H_BSD   = C.DC_CALL_SYS_X86_INT80H_BSD
)


func (p *CallVM) Mode(mode int) {
	C.dcMode(p.cvm, C.DCint(mode))
}

// Error codes
const (
	DC_ERROR_NONE             = C.DC_ERROR_NONE
	DC_ERROR_UNSUPPORTED_MODE = C.DC_ERROR_UNSUPPORTED_MODE
)


func (p *CallVM) GetError() int {
	return int(C.dcGetError(p.cvm))
}


// Helper for string/pointer conversion, needed as low-level string alloc needs to be freed in different scope
func (p *CallVM) AllocCString(value string) unsafe.Pointer { s := C.CString(value); return unsafe.Pointer(s) }
func (p *CallVM) FreeCString (value unsafe.Pointer)        { C.free(value) }

// Args
func (p *CallVM) ArgBool        (value bool)           { if value==true { C.dcArgBool(p.cvm, C.DC_TRUE) } else { C.dcArgBool(p.cvm, C.DC_FALSE) } }
func (p *CallVM) ArgChar        (value int8)           { C.dcArgChar    (p.cvm, C.DCchar    (value)) }
func (p *CallVM) ArgShort       (value int16)          { C.dcArgShort   (p.cvm, C.DCshort   (value)) }
func (p *CallVM) ArgInt         (value int)            { C.dcArgInt     (p.cvm, C.DCint     (value)) }
func (p *CallVM) ArgLong        (value int32)          { C.dcArgLong    (p.cvm, C.DClong    (value)) }
func (p *CallVM) ArgLongLong    (value int64)          { C.dcArgLongLong(p.cvm, C.DClonglong(value)) }
func (p *CallVM) ArgFloat       (value float32)        { C.dcArgFloat   (p.cvm, C.DCfloat   (value)) }
func (p *CallVM) ArgDouble      (value float64)        { C.dcArgDouble  (p.cvm, C.DCdouble  (value)) }
func (p *CallVM) ArgPointer     (value unsafe.Pointer) { C.dcArgPointer (p.cvm, C.DCpointer (value)) }
//@@@func (p *CallVM) ArgStruct  (s C.DCstruct*, value unsafe.Pointer)

// "Formatted" args
//   - first takes Go's types (as they cover all C types dyncall supports) and pushes values accordingly
//   - second uses a dyncall signature for implicit type conversion/casting, however it uses reflect package and is slower
// Note that first version doesn't feature calling convention mode switching.
func (p *CallVM) ArgF_Go(args ...interface{}) error {

	for i, n := 0, len(args); i<n; i++ {
		switch args[i].(type) {
			case bool:           p.ArgBool    (              (args[i].(bool          )))
			case int8:           p.ArgChar    (              (args[i].(int8          )))
			case uint8/*byte*/:  p.ArgChar    (int8          (args[i].(uint8         )))
			case int16:          p.ArgShort   (              (args[i].(int16         )))
			case uint16:         p.ArgShort   (int16         (args[i].(uint16        )))
			case int:            p.ArgInt     (              (args[i].(int           )))
			case uint:           p.ArgInt     (int           (args[i].(uint          )))
			case int32/*rune*/:  p.ArgLong    (              (args[i].(int32         )))
			case uint32:         p.ArgLong    (int32         (args[i].(uint32        )))
			case int64:          p.ArgLongLong(              (args[i].(int64         )))
			case uint64:         p.ArgLongLong(int64         (args[i].(uint64        )))
			case float32:        p.ArgFloat   (              (args[i].(float32       )))
			case float64:        p.ArgDouble  (              (args[i].(float64       )))
			case uintptr:        p.ArgPointer (unsafe.Pointer(args[i].(unsafe.Pointer)))
			case unsafe.Pointer: p.ArgPointer (              (args[i].(unsafe.Pointer)))
			default: return fmt.Errorf("Unknown type passed to ArgF_Go")
		}
	}
	return nil
}

func (p *CallVM) ArgF(signature string, args ...interface{}) {

	tb := reflect.TypeOf((*bool   )(nil)).Elem()
	ti := reflect.TypeOf((*int64  )(nil)).Elem()
	tf := reflect.TypeOf((*float64)(nil)).Elem()
	tp := reflect.TypeOf((*uintptr)(nil)).Elem()

	for i, n := 0, len(signature); i<n; i++ {
		//@@@ add support for calling convention mode(s)
		switch s := signature[i]; s {
			case C.DC_SIGCHAR_BOOL:                              p.ArgBool    (bool          (reflect.ValueOf(args[i]).Convert(tb).Bool   ()))
			case C.DC_SIGCHAR_CHAR,     C.DC_SIGCHAR_UCHAR:      p.ArgChar    (int8          (reflect.ValueOf(args[i]).Convert(ti).Int    ()))
			case C.DC_SIGCHAR_INT,      C.DC_SIGCHAR_UINT:       p.ArgInt     (int           (reflect.ValueOf(args[i]).Convert(ti).Int    ()))
			case C.DC_SIGCHAR_LONG,     C.DC_SIGCHAR_ULONG:      p.ArgLong    (int32         (reflect.ValueOf(args[i]).Convert(ti).Int    ()))
			case C.DC_SIGCHAR_LONGLONG, C.DC_SIGCHAR_ULONGLONG:  p.ArgLongLong(int64         (reflect.ValueOf(args[i]).Convert(ti).Int    ()))
			case C.DC_SIGCHAR_FLOAT:                             p.ArgFloat   (float32       (reflect.ValueOf(args[i]).Convert(tf).Float  ()))
			case C.DC_SIGCHAR_DOUBLE:                            p.ArgDouble  (float64       (reflect.ValueOf(args[i]).Convert(tf).Float  ()))
			case C.DC_SIGCHAR_POINTER,  C.DC_SIGCHAR_STRING:     p.ArgPointer (unsafe.Pointer(reflect.ValueOf(args[i]).Convert(tp).Pointer()))
			case C.DC_SIGCHAR_ENDARG:                            return
		}
		// Faster, but doesn't do cross-type conversions.
		//switch s := signature[i]; s {
		//	case C.DC_SIGCHAR_BOOL:                              p.ArgBool    (args[i].(bool          ))
		//	case C.DC_SIGCHAR_CHAR,     C.DC_SIGCHAR_UCHAR:      p.ArgChar    (args[i].(int8          ))
		//	case C.DC_SIGCHAR_SHORT,    C.DC_SIGCHAR_USHORT:     p.ArgShort   (args[i].(int16         ))
		//	case C.DC_SIGCHAR_INT,      C.DC_SIGCHAR_UINT:       p.ArgInt     (args[i].(int           ))
		//	case C.DC_SIGCHAR_LONG,     C.DC_SIGCHAR_ULONG:      p.ArgLong    (args[i].(int32         ))
		//	case C.DC_SIGCHAR_LONGLONG, C.DC_SIGCHAR_ULONGLONG:  p.ArgLongLong(args[i].(int64         ))
		//	case C.DC_SIGCHAR_FLOAT:                             p.ArgFloat   (args[i].(float32       ))
		//	case C.DC_SIGCHAR_DOUBLE:                            p.ArgDouble  (args[i].(float64       ))
		//	case C.DC_SIGCHAR_POINTER,  C.DC_SIGCHAR_STRING:     p.ArgPointer (args[i].(unsafe.Pointer))
		//	case C.DC_SIGCHAR_ENDARG:                            return
		//}
	}
}


// Calls
func (p *CallVM) CallVoid        (funcptr unsafe.Pointer)                {                       C.dcCallVoid    (p.cvm, C.DCpointer(funcptr))  }
func (p *CallVM) CallBool        (funcptr unsafe.Pointer) bool           { b := (C.dcCallBool(p.cvm, C.DCpointer(funcptr))); if b==C.DC_TRUE { return true } else { return false } }
func (p *CallVM) CallChar        (funcptr unsafe.Pointer) int8           { return int8          (C.dcCallChar    (p.cvm, C.DCpointer(funcptr))) }
func (p *CallVM) CallShort       (funcptr unsafe.Pointer) int16          { return int16         (C.dcCallShort   (p.cvm, C.DCpointer(funcptr))) }
func (p *CallVM) CallInt         (funcptr unsafe.Pointer) int            { return int           (C.dcCallInt     (p.cvm, C.DCpointer(funcptr))) }
func (p *CallVM) CallLong        (funcptr unsafe.Pointer) int32          { return int32         (C.dcCallLong    (p.cvm, C.DCpointer(funcptr))) }
func (p *CallVM) CallLongLong    (funcptr unsafe.Pointer) int64          { return int64         (C.dcCallLongLong(p.cvm, C.DCpointer(funcptr))) }
func (p *CallVM) CallFloat       (funcptr unsafe.Pointer) float32        { return float32       (C.dcCallFloat   (p.cvm, C.DCpointer(funcptr))) }
func (p *CallVM) CallDouble      (funcptr unsafe.Pointer) float64        { return float64       (C.dcCallDouble  (p.cvm, C.DCpointer(funcptr))) }
func (p *CallVM) CallPointer     (funcptr unsafe.Pointer) unsafe.Pointer { return unsafe.Pointer(C.dcCallPointer (p.cvm, C.DCpointer(funcptr))) }
func (p *CallVM) CallPointerToStr(funcptr unsafe.Pointer) string         { return C.GoString((*C.char)(C.dcCallPointer (p.cvm, C.DCpointer(funcptr)))) } // For convenience
//@@@func (p *CallVM) CallStruct  (funcptr unsafe.Pointer, s C.DCstruct* s, returnValue unsafe.Pointer)

// "Formatted" calls
//@@@func (p *CallVM) Call(result, funcptr unsafe.Pointer, signature string, args ...interface{}) {
//@@@...
//@@@}


//void dcCallF (DCCallVM* vm, DCValue* result, DCpointer funcptr, const DCsigchar* signature, ...);

/*
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);  	
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);
*/