rbdc 0.8.0

data/dyncall/dyncallback/dyncall_thunk_ppc32.c

@@ -0,0 +1,51 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_ppc32.c
+ Description: Thunk - Implementation for ppc32
+ 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 "dyncall_thunk.h"
+
+unsigned short hi16(x) { return ( (unsigned short) (((unsigned int)x)>>16UL) ); }
+unsigned short lo16(x) { return ( (unsigned short)  ((unsigned int)x)        ); }   
+
+void dcbInitThunk(DCThunk* p, void (*entry)())
+{
+  /*
+    ppc32 thunk code:
+      lis   r2 , HI16(p)
+      ori   r2 , r2, LO16(p)
+      lwz   r12, 20(r2)
+      mtctr r12
+      bctr
+  */
+
+  p->code_load_hi = 0x3c40U;     /* lis  r2, HI16(p) */
+  p->addr_self_hi = hi16(p);
+  p->code_load_lo = 0x6042U; 	 /* ori  r2, r2, LO16(p) */
+  p->addr_self_lo = lo16(p);
+  p->code_jump[0] = 0x81820014U; /* lwz   r12, 20(r2) */
+  p->code_jump[1] = 0x7d8903a6U; /* mtclr r12 */
+  p->code_jump[2] = 0x4e800420U; /* bctr */
+  p->addr_entry   = entry;
+}
+

data/dyncall/dyncallback/dyncall_thunk_ppc32.h

@@ -0,0 +1,40 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_ppc32.h
+ Description: Thunk - Header for ppc32
+ 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_THUNK_PPC32_H
+#define DYNCALL_THUNK_PPC32_H
+
+struct DCThunk_
+{
+  unsigned short code_load_hi, addr_self_hi;  /* offset:  0 */
+  unsigned short code_load_lo, addr_self_lo;  /* offset:  4 */
+  unsigned int   code_jump[3];                /* offset:  8 */
+  void          (*addr_entry)();              /* offset: 20 */
+};
+
+#define DCTHUNK_SIZE_PPC32 24
+
+#endif /* DYNCALL_THUNK_PPC32_H */
+

data/dyncall/dyncallback/dyncall_thunk_sparc32.c

@@ -0,0 +1,32 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_sparc32.c
+ Description: Thunk - Implementation for sparc32
+ 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 "dyncall_thunk.h"
+
+void dcbInitThunk(DCThunk* p, void (*entry)())
+{
+  /* not yet implemented */
+}
+

data/dyncall/dyncallback/dyncall_thunk_sparc32.h

@@ -0,0 +1,36 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_sparc32.h
+ Description: Thunk - Header for sparc32 - not yet implemented
+ 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_THUNK_SPARC32_H
+#define DYNCALL_THUNK_SPARC32_H
+
+struct DCThunk_
+{
+  int x[4]; /* dummy */
+};
+
+#define DCTHUNK_SIZE_SPARC32 32
+
+#endif /* DYNCALL_THUNK_SPARC32_H */

data/dyncall/dyncallback/dyncall_thunk_sparc64.c

@@ -0,0 +1,32 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_sparc64.c
+ Description: Thunk - Implementation for sparc64
+ 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 "dyncall_thunk.h"
+
+void dcbInitThunk(DCThunk* p, void (*entry)())
+{
+  /* not yet implemented */
+}
+

data/dyncall/dyncallback/dyncall_thunk_sparc64.h

@@ -0,0 +1,36 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_sparc64.h
+ Description: Thunk - Header for sparc64 - not yet implemented
+ 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_THUNK_SPARC64_H
+#define DYNCALL_THUNK_SPARC64_H
+
+struct DCThunk_
+{
+  int x[4]; /* dummy */
+};
+
+#define DCTHUNK_SIZE_SPARC64 32
+
+#endif /* DYNCALL_THUNK_SPARC32_H */

data/dyncall/dyncallback/dyncall_thunk_x64.c

@@ -0,0 +1,48 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_x64.c
+ Description: Thunk - Implementation for x64
+ 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 "dyncall_thunk.h"
+
+void dcbInitThunk(DCThunk* p, void (*entry)())
+{
+  /*
+    # x64 thunk code:
+    .intel_syntax
+
+    thunk:
+        lea   rax, (rip)  # copy RIP (=p?) to RAX and use address in
+        jmp   [rax+16]    # 'entry' (stored at RIP+16) for jump
+        nop
+        nop
+        nop
+    entry:
+        .resq 1
+   */
+
+  p->code[0] = 0xfffffffff9058d48ULL;
+  p->code[1] = 0x9090900000000325ULL;
+  p->entry   = entry;
+}
+

data/dyncall/dyncallback/dyncall_thunk_x64.h

@@ -0,0 +1,39 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_x64.h
+ Description: Thunk - Header for x64
+ 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_THUNK_X64_H
+#define DYNCALL_THUNK_X64_H
+
+struct DCThunk_
+{
+  unsigned long long code[2];
+  void (*entry)();
+};
+
+#define DCTHUNK_X64_SIZE	24
+
+
+#endif /* DYNCALL_THUNK_X64_H */
+

data/dyncall/dyncallback/dyncall_thunk_x86.c

@@ -0,0 +1,44 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_x86.c
+ Description: Thunk - Implementation for x86
+ 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 "dyncall_thunk.h"
+
+void dcbInitThunk(DCThunk* p, void (*entry)())
+{
+  /*
+    x86 thunk code:
+      nop
+      nop
+      nop
+      mov %eax, p
+      jmp [%eax+12]
+      nop
+  */
+
+  p->code_load  = 0xb8909090UL; /* nop;nop;nop;mov %eax, ... */
+  p->addr_self  = p;
+  p->code_jump  = 0x900C60ffUL; /* jmp [%eax+12] ; nop */
+  p->addr_entry = entry;
+}

data/dyncall/dyncallback/dyncall_thunk_x86.h

@@ -0,0 +1,39 @@
+/*
+
+ Package: dyncall
+ Library: dyncallback
+ File: dyncallback/dyncall_thunk_x86.h
+ Description: Thunk - Header for x86
+ 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_THUNK_X86_H
+#define DYNCALL_THUNK_X86_H
+
+struct DCThunk_
+{
+  unsigned int code_load;
+  void*        addr_self;
+  unsigned int code_jump;
+  void        (*addr_entry)();
+};
+
+#define DCTHUNK_X86_SIZE	16
+
+#endif /* DYNCALL_THUNK_X86_H */

data/dyncall/dyncallback/dyncallback.3

@@ -0,0 +1,134 @@
+.\" 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 dyncallback 3
+.Os
+.Sh NAME
+.Nm dyncallback
+.Nd callback interface of dyncall
+.Sh SYNOPSIS
+.In dyncall_callback.h
+.Ft DCCallback *
+.Fn dcbNewCallback "const char * signature" "DCCallbackHandler * funcptr" "void * userdata"
+.Ft void
+.Fn dcbInitCallback "DCCallback * pcb" "const char * signature" "DCCallbackHandler * funcptr" "void * userdata"
+.Ft void
+.Fn dcbFreeCallback "DCCallback * pcb"
+.Ft void
+.Fn dcbGetUserData "DCCallback * pcb"
+.Sh DESCRIPTION
+The
+.Nm
+dyncall library has an interface to create callback objects, that can be passed
+to functions as callback arguments. In other words, a pointer to the callback
+object can be "called", directly. The callback handler then allows iterating
+dynamically over the arguments once called back.
+.Pp
+.Fn dcbNewCallback
+creates a new callback object, where
+.Ar signature
+is a signature string describing the function to be called back (see manual for
+format). This is needed for
+.Nm
+dyncallback to correctly prepare the arguments passed in by the function that
+calls the callback handler. Note that the handler doesn't return the value
+specified in the signature, directly, but simply 'i' or 'f' depending on whether
+it is a integral or floating point type. The return value itself is stored
+where the handler's 3rd parameter points to (see example).
+.Ar funcptr
+is a pointer to the
+.Nm
+dyncallback callback handler (see below), and
+.Ar userdata
+a pointer to arbitrary user data you want to use in the callback handler.
+Use the returned pointer as callback argument in functions requiring a callback
+function pointer.
+.Pp
+.Fn dcbInitCallback
+(re)initialize the callback object.
+.Pp
+.Fn dcbFreeCallback
+destroys and frees the callback handler.
+.Pp
+.Fn dcbGetUserData
+returns a pointer to the userdata passed to the callback object on creation or
+initialization.
+.Pp
+Declaration of a dyncallback handler (following function pointer definition in
+dyncallback/dyncall_callback.h):
+.Bd -literal -offset indent
+char cbHandler(DCCallback* cb,
+               DCArgs*     args,
+               DCValue*    result,
+               void*       userdata);
+.Ed
+.Pp
+.Ar cb is a pointer to the DCCallback object in use
+.Nm
+result is a pointer to a DCValue object in order to store the callback's
+return value (output, to be set by handler). Finally,
+.Ar userdata is a pointer to some user defined data that can be
+set when creating the callback object.
+The handler itself returns either 'i' or 'f' depending on whether the value
+stored in
+.Ar result is of integral or floating point type.
+.Sh EXAMPLE
+Let's say, we want to create a callback object and call it. For simplicity, this
+example will omit passing it as a function pointer to a function (e.g. compar
+in qsort(), etc.) and demonstrate calling it, directly. First, we need to define
+our callback handler - the following handler illustrates how to access the passed-
+in arguments:
+.Bd -literal -offset indent
+char cbHandler(DCCallback* cb,
+               DCArgs*     args,
+               DCValue*    result,
+               void*       userdata)
+{
+  int* ud = (int*)userdata;
+  int       arg1 = dcbArgInt     (args);
+  float     arg2 = dcbArgFloat   (args);
+  short     arg3 = dcbArgShort   (args);
+  double    arg4 = dcbArgDouble  (args);
+  long long arg5 = dcbArgLongLong(args);
+
+  // .. do something ..
+
+  result->s = 1244;
+  return 'i';
+}
+.Ed
+.Pp
+Note that the return value of the handler is a signature character, not the
+actual return value, itself, and note that the actual return value is of type
+short.
+Now, let's call it through a DCCallback object:
+.Bd -literal -offset indent
+  DCCallback* cb;
+  short result = 0;
+  int userdata = 1337;
+  cb = dcbNewCallback("ifsdl)s", &cbHandler, &userdata);
+  result = ((short(*)(int, float, short, double, long long))cb)
+    (123, 23.f, 3, 1.82, 9909ll);
+  dcbFreeCallback(cb);
+.Ed
+.Sh SEE ALSO
+.Xr dyncall 3 ,
+.Xr dynload 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