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 sv_setpv(MY_CXT.x_dl_last_error, error);
103 static char *dlopen(char *path, int mode /* mode is ignored */)
106 NSObjectFileImage ofile;
107 NSModule handle = NULL;
109 dyld_result = NSCreateObjectFileImageFromFile(path, &ofile);
110 if (dyld_result != NSObjectFileImageSuccess)
111 TranslateError(path, OFImage, dyld_result);
114 // NSLinkModule will cause the run to abort on any link errors
115 // not very friendly but the error recovery functionality is limited.
116 handle = NSLinkModule(ofile, path, TRUE);
117 NSDestroyObjectFileImage(ofile);
124 dlsym(void *handle, char *symbol)
128 if (NSIsSymbolNameDefined(symbol))
129 addr = NSAddressOfSymbol(NSLookupAndBindSymbol(symbol));
138 /* ----- code from dl_dlopen.xs below here ----- */
142 dl_private_init(pTHX)
144 (void)dl_generic_private_init(aTHX);
147 MODULE = DynaLoader PACKAGE = DynaLoader
150 (void)dl_private_init(aTHX);
155 dl_load_file(filename, flags=0)
161 DLDEBUG(1,PerlIO_printf(Perl_debug_log, "dl_load_file(%s,%x):\n", filename,flags));
163 Perl_warn(aTHX_ "Can't make loaded symbols global on this platform while loading %s",filename);
164 RETVAL = dlopen(filename, mode) ;
165 DLDEBUG(2,PerlIO_printf(Perl_debug_log, " libref=%x\n", RETVAL));
166 ST(0) = sv_newmortal() ;
168 SaveError(aTHX_ "%s",dlerror()) ;
170 sv_setiv( ST(0), PTR2IV(RETVAL) );
174 dl_find_symbol(libhandle, symbolname)
178 symbolname = Perl_form_nocontext("_%s", symbolname);
179 DLDEBUG(2, PerlIO_printf(Perl_debug_log,
180 "dl_find_symbol(handle=%lx, symbol=%s)\n",
181 (unsigned long) libhandle, symbolname));
182 RETVAL = dlsym(libhandle, symbolname);
183 DLDEBUG(2, PerlIO_printf(Perl_debug_log,
184 " symbolref = %lx\n", (unsigned long) RETVAL));
185 ST(0) = sv_newmortal() ;
187 SaveError(aTHX_ "%s",dlerror()) ;
189 sv_setiv( ST(0), PTR2IV(RETVAL) );
198 # These functions should not need changing on any platform:
201 dl_install_xsub(perl_name, symref, filename="$Package")
206 DLDEBUG(2,PerlIO_printf(Perl_debug_log, "dl_install_xsub(name=%s, symref=%x)\n",
208 ST(0) = sv_2mortal(newRV((SV*)newXS(perl_name,
209 (void(*)(pTHX_ CV *))symref,
217 RETVAL = dl_last_error ;