1/* dl_aix.xs
2 *
3 * Written: 8/31/94 by Wayne Scott (wscott@ichips.intel.com)
4 *
5 *  All I did was take Jens-Uwe Mager's libdl emulation library for
6 *  AIX and merged it with the dl_dlopen.xs file to create a dynamic library
7 *  package that works for AIX.
8 *
9 *  I did change all malloc's, free's, strdup's, calloc's to use the perl
10 *  equilvant.  I also removed some stuff we will not need.  Call fini()
11 *  on startup...   It can probably be trimmed more.
12 */
13
14#define PERLIO_NOT_STDIO 0
15#define PERL_EXT
16#define PERL_IN_DL_AIX_XS
17
18/*
19 * On AIX 4.3 and above the emulation layer is not needed any more, and
20 * indeed if perl uses its emulation and perl is linked into apache
21 * which is supposed to use the native dlopen conflicts arise.
22 * Jens-Uwe Mager jum@helios.de
23 */
24#ifdef USE_NATIVE_DLOPEN
25
26#include "EXTERN.h"
27#include "perl.h"
28#include "XSUB.h"
29#include <dlfcn.h>
30
31#include "dlutils.c"	/* SaveError() etc	*/
32
33#else
34
35/*
36 * @(#)dlfcn.c	1.5 revision of 93/02/14  20:14:17
37 * This is an unpublished work copyright (c) 1992 Helios Software GmbH
38 * 3000 Hannover 1, Germany
39 */
40#include "EXTERN.h"
41#include "perl.h"
42#include "XSUB.h"
43
44/* When building as a 64-bit binary on AIX, define this to get the
45 * correct structure definitions.  Also determines the field-name
46 * macros and gates some logic in readEntries().  -- Steven N. Hirsch
47 * <hirschs@btv.ibm.com> */
48#ifdef USE_64_BIT_ALL
49#   define __XCOFF64__
50#   define __XCOFF32__
51#endif
52
53#include <stdio.h>
54#include <errno.h>
55#include <string.h>
56#include <stdlib.h>
57#include <sys/types.h>
58#include <sys/ldr.h>
59#include <a.out.h>
60#undef FREAD
61#undef FWRITE
62#include <ldfcn.h>
63
64#ifdef USE_64_BIT_ALL
65#   define AIX_SCNHDR SCNHDR_64
66#   define AIX_LDHDR LDHDR_64
67#   define AIX_LDSYM LDSYM_64
68#   define AIX_LDHDRSZ LDHDRSZ_64
69#else
70#   define AIX_SCNHDR SCNHDR
71#   define AIX_LDHDR LDHDR
72#   define AIX_LDSYM LDSYM
73#   define AIX_LDHDRSZ LDHDRSZ
74#endif
75
76/* When using Perl extensions written in C++ the longer versions
77 * of load() and unload() from libC and libC_r need to be used,
78 * otherwise statics in the extensions won't get initialized right.
79 * -- Stephanie Beals <bealzy@us.ibm.com> */
80
81/* Older AIX C compilers cannot deal with C++ double-slash comments in
82   the ibmcxx and/or xlC includes.  Since we only need a single file,
83   be more fine-grained about what's included <hirschs@btv.ibm.com> */
84
85#ifdef USE_libC /* The define comes, when it comes, from hints/aix.pl. */
86#   define LOAD   loadAndInit
87#   define UNLOAD terminateAndUnload
88#   if defined(USE_vacpp_load_h)
89#       include "/usr/vacpp/include/load.h"
90#   elif defined(USE_ibmcxx_load_h)
91#       include "/usr/ibmcxx/include/load.h"
92#   elif defined(USE_xlC_load_h)
93#       include "/usr/lpp/xlC/include/load.h"
94#   elif defined(USE_load_h)
95#       include "/usr/include/load.h"
96#   endif
97#else
98#   define LOAD   load
99#   define UNLOAD unload
100#endif
101
102/*
103 * AIX 4.3 does remove some useful definitions from ldfcn.h. Define
104 * these here to compensate for that lossage.
105 */
106#ifndef BEGINNING
107# define BEGINNING SEEK_SET
108#endif
109#ifndef FSEEK
110# define FSEEK(ldptr,o,p)	fseek(IOPTR(ldptr),(p==BEGINNING)?(OFFSET(ldptr) +o):o,p)
111#endif
112#ifndef FREAD
113# define FREAD(p,s,n,ldptr)	fread(p,s,n,IOPTR(ldptr))
114#endif
115
116#ifndef RTLD_LAZY
117# define RTLD_LAZY 0
118#endif
119#ifndef RTLD_GLOBAL
120# define RTLD_GLOBAL 0
121#endif
122
123/*
124 * We simulate dlopen() et al. through a call to load. Because AIX has
125 * no call to find an exported symbol we read the loader section of the
126 * loaded module and build a list of exported symbols and their virtual
127 * address.
128 */
129
130typedef struct {
131	char		*name;		/* the symbols's name */
132	void		*addr;		/* its relocated virtual address */
133} Export, *ExportPtr;
134
135/*
136 * The void * handle returned from dlopen is actually a ModulePtr.
137 */
138typedef struct Module {
139	struct Module	*next;
140	char		*name;		/* module name for refcounting */
141	int		refCnt;		/* the number of references */
142	void		*entry;		/* entry point from load */
143	int		nExports;	/* the number of exports found */
144	ExportPtr	exports;	/* the array of exports */
145} Module, *ModulePtr;
146
147typedef struct {
148    /*
149     * We keep a list of all loaded modules to be able to reference count
150     * duplicate dlopen's.
151     */
152    ModulePtr	x_modList;
153
154    /*
155     * The last error from one of the dl* routines is kept in static
156     * variables here. Each error is returned only once to the caller.
157     */
158    char	x_errbuf[BUFSIZ];
159    int		x_errvalid;
160    void *	x_mainModule;
161} my_cxtx_t;		/* this *must* be named my_cxtx_t */
162
163#define DL_CXT_EXTRA	/* ask for dl_cxtx to be defined in dlutils.c */
164#include "dlutils.c"	/* SaveError() etc	*/
165
166#define dl_modList	(dl_cxtx.x_modList)
167#define dl_errbuf	(dl_cxtx.x_errbuf)
168#define dl_errvalid	(dl_cxtx.x_errvalid)
169#define dl_mainModule	(dl_cxtx.x_mainModule)
170
171static void caterr(char *);
172static int readExports(ModulePtr);
173static void *findMain(void);
174
175/* these statics are ok because they're constants */
176static char *strerror_failed   = "(strerror failed)";
177static char *strerror_r_failed = "(strerror_r failed)";
178
179char *strerrorcat(char *str, int err) {
180    int strsiz = strlen(str);
181    int msgsiz;
182    char *msg;
183
184    dTHX;
185
186    if ((msg = strerror(err)) == 0)
187      msg = strerror_failed;
188    msgsiz = strlen(msg);		/* Note msg = buf and free() above. */
189    if (strsiz + msgsiz < BUFSIZ)	/* Do not move this after #endif. */
190      strcat(str, msg);
191
192    return str;
193}
194
195char *strerrorcpy(char *str, int err) {
196    int msgsiz;
197    char *msg;
198
199    dTHX;
200
201    if ((msg = strerror(err)) == 0)
202      msg = strerror_failed;
203    msgsiz = strlen(msg);	/* Note msg = buf and free() above. */
204    if (msgsiz < BUFSIZ)	/* Do not move this after #endif. */
205      strcpy(str, msg);
206
207    return str;
208}
209
210/* ARGSUSED */
211void *dlopen(char *path, int mode)
212{
213	dTHX;
214	dMY_CXT;
215	ModulePtr mp;
216
217	/*
218	 * Upon the first call register a terminate handler that will
219	 * close all libraries.
220	 */
221	if (dl_mainModule == NULL) {
222		if ((dl_mainModule = findMain()) == NULL)
223			return NULL;
224	}
225	/*
226	 * Scan the list of modules if have the module already loaded.
227	 */
228	for (mp = dl_modList; mp; mp = mp->next)
229		if (strEQ(mp->name, path)) {
230			mp->refCnt++;
231			return mp;
232		}
233	Newxz(mp,1,Module);
234	if (mp == NULL) {
235		dl_errvalid++;
236		strcpy(dl_errbuf, "Newz: ");
237		strerrorcat(dl_errbuf, errno);
238		return NULL;
239	}
240
241	if ((mp->name = savepv(path)) == NULL) {
242		dl_errvalid++;
243		strcpy(dl_errbuf, "savepv: ");
244		strerrorcat(dl_errbuf, errno);
245		safefree(mp);
246		return NULL;
247	}
248
249	/*
250	 * load should be declared load(const char *...). Thus we
251	 * cast the path to a normal char *. Ugly.
252	 */
253	if ((mp->entry = (void *)LOAD((char *)path,
254#ifdef L_LIBPATH_EXEC
255				      L_LIBPATH_EXEC |
256#endif
257				      L_NOAUTODEFER,
258				      NULL)) == NULL) {
259	        int saverrno = errno;
260
261		safefree(mp->name);
262		safefree(mp);
263		dl_errvalid++;
264		strcpy(dl_errbuf, "dlopen: ");
265		strcat(dl_errbuf, path);
266		strcat(dl_errbuf, ": ");
267		/*
268		 * If AIX says the file is not executable, the error
269		 * can be further described by querying the loader about
270		 * the last error.
271		 */
272		if (saverrno == ENOEXEC) {
273			char *moreinfo[BUFSIZ/sizeof(char *)];
274			if (loadquery(L_GETMESSAGES, moreinfo, sizeof(moreinfo)) == -1)
275				strerrorcpy(dl_errbuf, saverrno);
276			else {
277				char **p;
278				for (p = moreinfo; *p; p++)
279					caterr(*p);
280			}
281		} else
282			strerrorcat(dl_errbuf, saverrno);
283		return NULL;
284	}
285	mp->refCnt = 1;
286	mp->next = dl_modList;
287	dl_modList = mp;
288	/*
289	 * Assume anonymous exports come from the module this dlopen
290	 * is linked into, that holds true as long as dlopen and all
291	 * of the perl core are in the same shared object. Also bind
292	 * against the main part, in the case a perl is not the main
293	 * part, e.g mod_perl as DSO in Apache so perl modules can
294	 * also reference Apache symbols.
295	 */
296	if (loadbind(0, (void *)dlopen, mp->entry) == -1 ||
297	    loadbind(0, dl_mainModule, mp->entry)) {
298	        int saverrno = errno;
299
300		dlclose(mp);
301		dl_errvalid++;
302		strcpy(dl_errbuf, "loadbind: ");
303		strerrorcat(dl_errbuf, saverrno);
304		return NULL;
305	}
306	if (readExports(mp) == -1) {
307		dlclose(mp);
308		return NULL;
309	}
310	return mp;
311}
312
313/*
314 * Attempt to decipher an AIX loader error message and append it
315 * to our static error message buffer.
316 */
317static void caterr(char *s)
318{
319	dTHX;
320	dMY_CXT;
321	char *p = s;
322
323	while (isDIGIT(*p))
324		p++;
325	switch(atoi(s)) {
326	case L_ERROR_TOOMANY:
327		strcat(dl_errbuf, "too many errors");
328		break;
329	case L_ERROR_NOLIB:
330		strcat(dl_errbuf, "can't load library");
331		strcat(dl_errbuf, p);
332		break;
333	case L_ERROR_UNDEF:
334		strcat(dl_errbuf, "can't find symbol");
335		strcat(dl_errbuf, p);
336		break;
337	case L_ERROR_RLDBAD:
338		strcat(dl_errbuf, "bad RLD");
339		strcat(dl_errbuf, p);
340		break;
341	case L_ERROR_FORMAT:
342		strcat(dl_errbuf, "bad exec format in");
343		strcat(dl_errbuf, p);
344		break;
345	case L_ERROR_ERRNO:
346		strerrorcat(dl_errbuf, atoi(++p));
347		break;
348	default:
349		strcat(dl_errbuf, s);
350		break;
351	}
352}
353
354void *dlsym(void *handle, const char *symbol)
355{
356	dTHX;
357	dMY_CXT;
358	ModulePtr mp = (ModulePtr)handle;
359	ExportPtr ep;
360	int i;
361
362	/*
363	 * Could speed up search, but I assume that one assigns
364	 * the result to function pointers anyways.
365	 */
366	for (ep = mp->exports, i = mp->nExports; i; i--, ep++)
367		if (strEQ(ep->name, symbol))
368			return ep->addr;
369	dl_errvalid++;
370	strcpy(dl_errbuf, "dlsym: undefined symbol ");
371	strcat(dl_errbuf, symbol);
372	return NULL;
373}
374
375char *dlerror(void)
376{
377	dTHX;
378	dMY_CXT;
379	if (dl_errvalid) {
380		dl_errvalid = 0;
381		return dl_errbuf;
382	}
383	return NULL;
384}
385
386int dlclose(void *handle)
387{
388	dTHX;
389	dMY_CXT;
390	ModulePtr mp = (ModulePtr)handle;
391	int result;
392	ModulePtr mp1;
393
394	if (--mp->refCnt > 0)
395		return 0;
396	result = UNLOAD(mp->entry);
397	if (result == -1) {
398		dl_errvalid++;
399		strerrorcpy(dl_errbuf, errno);
400	}
401	if (mp->exports) {
402		ExportPtr ep;
403		int i;
404		for (ep = mp->exports, i = mp->nExports; i; i--, ep++)
405			if (ep->name)
406				safefree(ep->name);
407		safefree(mp->exports);
408	}
409	if (mp == dl_modList)
410		dl_modList = mp->next;
411	else {
412		for (mp1 = dl_modList; mp1; mp1 = mp1->next)
413			if (mp1->next == mp) {
414				mp1->next = mp->next;
415				break;
416			}
417	}
418	safefree(mp->name);
419	safefree(mp);
420	return result;
421}
422
423/* Added by Wayne Scott
424 * This is needed because the ldopen system call calls
425 * calloc to allocated a block of date.  The ldclose call calls free.
426 * Without this we get this system calloc and perl's free, resulting
427 * in a "Bad free" message.  This way we always use perl's malloc.
428 */
429void *calloc(size_t ne, size_t sz)
430{
431  void *out;
432
433  out = (void *) safemalloc(ne*sz);
434  memzero(out, ne*sz);
435  return(out);
436}
437
438/*
439 * Build the export table from the XCOFF .loader section.
440 */
441static int readExports(ModulePtr mp)
442{
443	dTHX;
444	dMY_CXT;
445	LDFILE *ldp = NULL;
446	AIX_SCNHDR sh;
447	AIX_LDHDR *lhp;
448	char *ldbuf;
449	AIX_LDSYM *ls;
450	int i;
451	ExportPtr ep;
452
453	if ((ldp = ldopen(mp->name, ldp)) == NULL) {
454		struct ld_info *lp;
455		char *buf;
456		int size = 4*1024;
457		if (errno != ENOENT) {
458			dl_errvalid++;
459			strcpy(dl_errbuf, "readExports: ");
460			strerrorcat(dl_errbuf, errno);
461			return -1;
462		}
463		/*
464		 * The module might be loaded due to the LIBPATH
465		 * environment variable. Search for the loaded
466		 * module using L_GETINFO.
467		 */
468		if ((buf = safemalloc(size)) == NULL) {
469			dl_errvalid++;
470			strcpy(dl_errbuf, "readExports: ");
471			strerrorcat(dl_errbuf, errno);
472			return -1;
473		}
474		while ((i = loadquery(L_GETINFO, buf, size)) == -1 && errno == ENOMEM) {
475			safefree(buf);
476			size += 4*1024;
477			if ((buf = safemalloc(size)) == NULL) {
478				dl_errvalid++;
479				strcpy(dl_errbuf, "readExports: ");
480				strerrorcat(dl_errbuf, errno);
481				return -1;
482			}
483		}
484		if (i == -1) {
485			dl_errvalid++;
486			strcpy(dl_errbuf, "readExports: ");
487			strerrorcat(dl_errbuf, errno);
488			safefree(buf);
489			return -1;
490		}
491		/*
492		 * Traverse the list of loaded modules. The entry point
493		 * returned by LOAD() does actually point to the data
494		 * segment origin.
495		 */
496		lp = (struct ld_info *)buf;
497		while (lp) {
498			if (lp->ldinfo_dataorg == mp->entry) {
499				ldp = ldopen(lp->ldinfo_filename, ldp);
500				break;
501			}
502			if (lp->ldinfo_next == 0)
503				lp = NULL;
504			else
505				lp = (struct ld_info *)((char *)lp + lp->ldinfo_next);
506		}
507		safefree(buf);
508		if (!ldp) {
509			dl_errvalid++;
510			strcpy(dl_errbuf, "readExports: ");
511			strerrorcat(dl_errbuf, errno);
512			return -1;
513		}
514	}
515#ifdef USE_64_BIT_ALL
516	if (TYPE(ldp) != U803XTOCMAGIC) {
517#else
518	if (TYPE(ldp) != U802TOCMAGIC) {
519#endif
520		dl_errvalid++;
521		strcpy(dl_errbuf, "readExports: bad magic");
522		while(ldclose(ldp) == FAILURE)
523			;
524		return -1;
525	}
526	if (ldnshread(ldp, _LOADER, &sh) != SUCCESS) {
527		dl_errvalid++;
528		strcpy(dl_errbuf, "readExports: cannot read loader section header");
529		while(ldclose(ldp) == FAILURE)
530			;
531		return -1;
532	}
533	/*
534	 * We read the complete loader section in one chunk, this makes
535	 * finding long symbol names residing in the string table easier.
536	 */
537	if ((ldbuf = (char *)safemalloc(sh.s_size)) == NULL) {
538		dl_errvalid++;
539		strcpy(dl_errbuf, "readExports: ");
540		strerrorcat(dl_errbuf, errno);
541		while(ldclose(ldp) == FAILURE)
542			;
543		return -1;
544	}
545	if (FSEEK(ldp, sh.s_scnptr, BEGINNING) != OKFSEEK) {
546		dl_errvalid++;
547		strcpy(dl_errbuf, "readExports: cannot seek to loader section");
548		safefree(ldbuf);
549		while(ldclose(ldp) == FAILURE)
550			;
551		return -1;
552	}
553/* This first case is a hack, since it assumes that the 3rd parameter to
554   FREAD is 1. See the redefinition of FREAD above to see how this works. */
555	if (FREAD(ldbuf, sh.s_size, 1, ldp) != 1) {
556		dl_errvalid++;
557		strcpy(dl_errbuf, "readExports: cannot read loader section");
558		safefree(ldbuf);
559		while(ldclose(ldp) == FAILURE)
560			;
561		return -1;
562	}
563	lhp = (AIX_LDHDR *)ldbuf;
564	ls = (AIX_LDSYM *)(ldbuf+AIX_LDHDRSZ);
565	/*
566	 * Count the number of exports to include in our export table.
567	 */
568	for (i = lhp->l_nsyms; i; i--, ls++) {
569		if (!LDR_EXPORT(*ls))
570			continue;
571		mp->nExports++;
572	}
573	Newxz(mp->exports, mp->nExports, Export);
574	if (mp->exports == NULL) {
575		dl_errvalid++;
576		strcpy(dl_errbuf, "readExports: ");
577		strerrorcat(dl_errbuf, errno);
578		safefree(ldbuf);
579		while(ldclose(ldp) == FAILURE)
580			;
581		return -1;
582	}
583	/*
584	 * Fill in the export table. All entries are relative to
585	 * the entry point we got from load.
586	 */
587	ep = mp->exports;
588	ls = (AIX_LDSYM *)(ldbuf+AIX_LDHDRSZ);
589	for (i = lhp->l_nsyms; i; i--, ls++) {
590		char *symname;
591		if (!LDR_EXPORT(*ls))
592			continue;
593#ifndef USE_64_BIT_ALL
594		if (ls->l_zeroes == 0)
595#endif
596			symname = ls->l_offset+lhp->l_stoff+ldbuf;
597#ifndef USE_64_BIT_ALL
598		else
599			symname = ls->l_name;
600#endif
601		ep->name = savepv(symname);
602		ep->addr = (void *)((unsigned long)mp->entry + ls->l_value);
603		ep++;
604	}
605	safefree(ldbuf);
606	while(ldclose(ldp) == FAILURE)
607		;
608	return 0;
609}
610
611/*
612 * Find the main modules entry point. This is used as export pointer
613 * for loadbind() to be able to resolve references to the main part.
614 */
615static void * findMain(void)
616{
617	dTHX;
618	dMY_CXT;
619	struct ld_info *lp;
620	char *buf;
621	int size = 4*1024;
622	int i;
623	void *ret;
624
625	if ((buf = safemalloc(size)) == NULL) {
626		dl_errvalid++;
627		strcpy(dl_errbuf, "findMain: ");
628		strerrorcat(dl_errbuf, errno);
629		return NULL;
630	}
631	while ((i = loadquery(L_GETINFO, buf, size)) == -1 && errno == ENOMEM) {
632		safefree(buf);
633		size += 4*1024;
634		if ((buf = safemalloc(size)) == NULL) {
635			dl_errvalid++;
636			strcpy(dl_errbuf, "findMain: ");
637			strerrorcat(dl_errbuf, errno);
638			return NULL;
639		}
640	}
641	if (i == -1) {
642		dl_errvalid++;
643		strcpy(dl_errbuf, "findMain: ");
644		strerrorcat(dl_errbuf, errno);
645		safefree(buf);
646		return NULL;
647	}
648	/*
649	 * The first entry is the main module. The entry point
650	 * returned by load() does actually point to the data
651	 * segment origin.
652	 */
653	lp = (struct ld_info *)buf;
654	ret = lp->ldinfo_dataorg;
655	safefree(buf);
656	return ret;
657}
658#endif /* USE_NATIVE_DLOPEN */
659
660/* dl_dlopen.xs
661 *
662 * Platform:	SunOS/Solaris, possibly others which use dlopen.
663 * Author:	Paul Marquess (Paul.Marquess@btinternet.com)
664 * Created:	10th July 1994
665 *
666 * Modified:
667 * 15th July 1994   - Added code to explicitly save any error messages.
668 * 3rd August 1994  - Upgraded to v3 spec.
669 * 9th August 1994  - Changed to use IV
670 * 10th August 1994 - Tim Bunce: Added RTLD_LAZY, switchable debugging,
671 *                    basic FreeBSD support, removed ClearError
672 *
673 */
674
675/* Porting notes:
676
677	see dl_dlopen.xs
678
679*/
680
681static void
682dl_private_init(pTHX)
683{
684    (void)dl_generic_private_init(aTHX);
685}
686
687MODULE = DynaLoader     PACKAGE = DynaLoader
688
689BOOT:
690    (void)dl_private_init(aTHX);
691
692
693void
694dl_load_file(filename, flags=0)
695	char *	filename
696	int	flags
697        PREINIT:
698        void *retv;
699	PPCODE:
700	DLDEBUG(1,PerlIO_printf(Perl_debug_log, "dl_load_file(%s,%x):\n", filename,flags));
701	if (flags & 0x01)
702	    Perl_warn(aTHX_ "Can't make loaded symbols global on this platform while loading %s",filename);
703	retv = dlopen(filename, RTLD_GLOBAL|RTLD_LAZY) ;
704	DLDEBUG(2,PerlIO_printf(Perl_debug_log, " libref=%x\n", retv));
705	ST(0) = sv_newmortal() ;
706	if (retv == NULL)
707	    SaveError(aTHX_ "%s",dlerror()) ;
708	else
709	    sv_setiv( ST(0), PTR2IV(retv) );
710        XSRETURN(1);
711
712int
713dl_unload_file(libref)
714    void *	libref
715  CODE:
716    DLDEBUG(1,PerlIO_printf(Perl_debug_log, "dl_unload_file(%lx):\n", libref));
717    RETVAL = (dlclose(libref) == 0 ? 1 : 0);
718    if (!RETVAL)
719        SaveError(aTHX_ "%s", dlerror()) ;
720    DLDEBUG(2,PerlIO_printf(Perl_debug_log, " retval = %d\n", RETVAL));
721  OUTPUT:
722    RETVAL
723
724void
725dl_find_symbol(libhandle, symbolname, ign_err=0)
726	void *		libhandle
727	char *		symbolname
728        int	        ign_err
729	PREINIT:
730        void *retv;
731        CODE:
732	DLDEBUG(2,PerlIO_printf(Perl_debug_log, "dl_find_symbol(handle=%x, symbol=%s)\n",
733		libhandle, symbolname));
734	retv = dlsym(libhandle, symbolname);
735	DLDEBUG(2,PerlIO_printf(Perl_debug_log, "  symbolref = %x\n", retv));
736	ST(0) = sv_newmortal();
737	if (retv == NULL) {
738            if (!ign_err)
739	        SaveError(aTHX_ "%s", dlerror());
740	} else
741	    sv_setiv( ST(0), PTR2IV(retv));
742
743
744void
745dl_undef_symbols()
746	CODE:
747
748
749
750# These functions should not need changing on any platform:
751
752void
753dl_install_xsub(perl_name, symref, filename="$Package")
754    char *	perl_name
755    void *	symref
756    const char *	filename
757    CODE:
758    DLDEBUG(2,PerlIO_printf(Perl_debug_log, "dl_install_xsub(name=%s, symref=%x)\n",
759	perl_name, symref));
760    ST(0) = sv_2mortal(newRV((SV*)newXS_flags(perl_name,
761					      (void(*)(pTHX_ CV *))symref,
762					      filename, NULL,
763					      XS_DYNAMIC_FILENAME)));
764
765
766SV *
767dl_error()
768    CODE:
769    dMY_CXT;
770    RETVAL = newSVsv(MY_CXT.x_dl_last_error);
771    OUTPUT:
772    RETVAL
773
774#if defined(USE_ITHREADS)
775
776void
777CLONE(...)
778    CODE:
779    MY_CXT_CLONE;
780
781    PERL_UNUSED_VAR(items);
782
783    /* MY_CXT_CLONE just does a memcpy on the whole structure, so to avoid
784     * using Perl variables that belong to another thread, we create our
785     * own for this thread.
786     */
787    MY_CXT.x_dl_last_error = newSVpvs("");
788
789#endif
790
791# end.
792