3 * Platform: Darwin (Mac OS)
4 * Author: Wilfredo Sanchez <wsanchez@apple.com>
5 * Based on: dl_next.xs by Paul Marquess
6 * Based on: dl_dlopen.xs by Anno Siegel
7 * Created: Aug 15th, 1994
12 And Gandalf said: 'Many folk like to know beforehand what is to
13 be set on the table; but those who have laboured to prepare the
14 feast like to keep their secret; for wonder makes the words of
20 dl_dyld.xs is based on dl_next.xs by Anno Siegel.
22 dl_next.xs is in turn a port from dl_dlopen.xs by Paul Marquess. It
23 should not be used as a base for further ports though it may be used
24 as an example for how dl_dlopen.xs can be ported to other platforms.
26 The method used here is just to supply the sun style dlopen etc.
27 functions in terms of NeXT's/Apple's dyld. The xs code proper is
28 unchanged from Paul's original.
30 The port could use some streamlining. For one, error handling could
33 This should be useable as a replacement for dl_next.xs, but it has not
34 been tested on NeXT platforms.
44 #include "dlutils.c" /* for SaveError() etc */
48 #import <mach-o/dyld.h>
50 static char *dlerror()
57 static int dlclose(void *handle) /* stub only */
67 static void TranslateError
68 (const char *path, enum dyldErrorSource type, int number)
74 static char *OFIErrorStrings[] =
76 "%s(%d): Object Image Load Failure\n",
77 "%s(%d): Object Image Load Success\n",
78 "%s(%d): Not a recognisable object file\n",
79 "%s(%d): No valid architecture\n",
80 "%s(%d): Object image has an invalid format\n",
81 "%s(%d): Invalid access (permissions?)\n",
82 "%s(%d): Unknown error code from NSCreateObjectFileImageFromFile\n",
84 #define NUM_OFI_ERRORS (sizeof(OFIErrorStrings) / sizeof(OFIErrorStrings[0]))
90 if (index > NUM_OFI_ERRORS - 1)
91 index = NUM_OFI_ERRORS - 1;
92 error = Perl_form_nocontext(OFIErrorStrings[index], path, number);
96 error = Perl_form_nocontext("%s(%d): Totally unknown error type %d\n",
100 safefree(dl_last_error);
101 dl_last_error = savepv(error);
104 static char *dlopen(char *path, int mode /* mode is ignored */)
107 NSObjectFileImage ofile;
108 NSModule handle = NULL;
110 dyld_result = NSCreateObjectFileImageFromFile(path, &ofile);
111 if (dyld_result != NSObjectFileImageSuccess)
112 TranslateError(path, OFImage, dyld_result);
115 // NSLinkModule will cause the run to abort on any link errors
116 // not very friendly but the error recovery functionality is limited.
117 handle = NSLinkModule(ofile, path, TRUE);
118 NSDestroyObjectFileImage(ofile);
125 dlsym(void *handle, char *symbol)
129 if (NSIsSymbolNameDefined(symbol))
130 addr = NSAddressOfSymbol(NSLookupAndBindSymbol(symbol));
139 /* ----- code from dl_dlopen.xs below here ----- */
143 dl_private_init(pTHX)
145 (void)dl_generic_private_init(aTHX);
148 MODULE = DynaLoader PACKAGE = DynaLoader
151 (void)dl_private_init(aTHX);
156 dl_load_file(filename, flags=0)
162 DLDEBUG(1,PerlIO_printf(Perl_debug_log, "dl_load_file(%s,%x):\n", filename,flags));
164 Perl_warn(aTHX_ "Can't make loaded symbols global on this platform while loading %s",filename);
165 RETVAL = dlopen(filename, mode) ;
166 DLDEBUG(2,PerlIO_printf(Perl_debug_log, " libref=%x\n", RETVAL));
167 ST(0) = sv_newmortal() ;
169 SaveError(aTHX_ "%s",dlerror()) ;
171 sv_setiv( ST(0), PTR2IV(RETVAL) );
175 dl_find_symbol(libhandle, symbolname)
179 symbolname = Perl_form_nocontext("_%s", symbolname);
180 DLDEBUG(2, PerlIO_printf(Perl_debug_log,
181 "dl_find_symbol(handle=%lx, symbol=%s)\n",
182 (unsigned long) libhandle, symbolname));
183 RETVAL = dlsym(libhandle, symbolname);
184 DLDEBUG(2, PerlIO_printf(Perl_debug_log,
185 " symbolref = %lx\n", (unsigned long) RETVAL));
186 ST(0) = sv_newmortal() ;
188 SaveError(aTHX_ "%s",dlerror()) ;
190 sv_setiv( ST(0), PTR2IV(RETVAL) );
199 # These functions should not need changing on any platform:
202 dl_install_xsub(perl_name, symref, filename="$Package")
207 DLDEBUG(2,PerlIO_printf(Perl_debug_log, "dl_install_xsub(name=%s, symref=%x)\n",
209 ST(0) = sv_2mortal(newRV((SV*)newXS(perl_name,
210 (void(*)(pTHX_ CV *))symref,
218 RETVAL = dl_last_error ;