[p5sagit/p5-mst-13.2.git] / ext / DynaLoader / dl_aix.xs

/* dl_aix.xs
 *
 * Written: 8/31/94 by Wayne Scott (wscott@ichips.intel.com)
 *
 *  All I did was take Jens-Uwe Mager's libdl emulation library for
 *  AIX and merged it with the dl_dlopen.xs file to create a dynamic library
 *  package that works for AIX.
 *
 *  I did change all malloc's, free's, strdup's, calloc's to use the perl
 *  equilvant.  I also removed some stuff we will not need.  Call fini()
 *  on statup...   It can probably be trimmed more.
 */

#define PERLIO_NOT_STDIO 0

/*
 * @(#)dlfcn.c	1.5 revision of 93/02/14  20:14:17
 * This is an unpublished work copyright (c) 1992 Helios Software GmbH
 * 3000 Hannover 1, Germany
 */
#include "EXTERN.h"
#include "perl.h"
#include "XSUB.h"

/* When building as a 64-bit binary on AIX, define this to get the
 * correct structure definitions.  Also determines the field-name
 * macros and gates some logic in readEntries().  -- Steven N. Hirsch
 * <hirschs@btv.ibm.com> */
#ifdef USE_64_BIT_ALL
#   define __XCOFF64__
#   define __XCOFF32__
#endif

#include <stdio.h>
#include <errno.h>
#include <string.h>
#include <stdlib.h>
#include <sys/types.h>
#include <sys/ldr.h>
#include <a.out.h>
#undef FREAD
#undef FWRITE
#include <ldfcn.h>

#ifdef USE_64_BIT_ALL
#   define AIX_SCNHDR SCNHDR_64
#   define AIX_LDHDR LDHDR_64
#   define AIX_LDSYM LDSYM_64
#   define AIX_LDHDRSZ LDHDRSZ_64
#else
#   define AIX_SCNHDR SCNHDR
#   define AIX_LDHDR LDHDR
#   define AIX_LDSYM LDSYM
#   define AIX_LDHDRSZ LDHDRSZ
#endif

/* When using Perl extensions written in C++ the longer versions
 * of load() and unload() from libC and libC_r need to be used,
 * otherwise statics in the extensions won't get initialized right.
 * -- Stephanie Beals <bealzy@us.ibm.com> */

/* Older AIX C compilers cannot deal with C++ double-slash comments in
   the ibmcxx and/or xlC includes.  Since we only need a single file,
   be more fine-grained about what's included <hirschs@btv.ibm.com> */

#ifdef USE_libC /* The define comes, when it comes, from hints/aix.pl. */
#   define LOAD   loadAndInit
#   define UNLOAD terminateAndUnload
#   if defined(USE_vacpp_load_h)
#       include "/usr/vacpp/include/load.h"
#   elif defined(USE_ibmcxx_load_h)
#       include "/usr/ibmcxx/include/load.h"
#   elif defined(USE_xlC_load_h)
#       include "/usr/lpp/xlC/include/load.h"
#   elif defined(USE_load_h)
#       include "/usr/include/load.h"
#   endif
#else
#   define LOAD   load
#   define UNLOAD unload
#endif

/*
 * AIX 4.3 does remove some useful definitions from ldfcn.h. Define
 * these here to compensate for that lossage.
 */
#ifndef BEGINNING
# define BEGINNING SEEK_SET
#endif
#ifndef FSEEK
# define FSEEK(ldptr,o,p)	fseek(IOPTR(ldptr),(p==BEGINNING)?(OFFSET(ldptr) +o):o,p)
#endif
#ifndef FREAD
# define FREAD(p,s,n,ldptr)	fread(p,s,n,IOPTR(ldptr))
#endif

/*
 * We simulate dlopen() et al. through a call to load. Because AIX has
 * no call to find an exported symbol we read the loader section of the
 * loaded module and build a list of exported symbols and their virtual
 * address.
 */

typedef struct {
	char		*name;		/* the symbols's name */
	void		*addr;		/* its relocated virtual address */
} Export, *ExportPtr;

/*
 * The void * handle returned from dlopen is actually a ModulePtr.
 */
typedef struct Module {
	struct Module	*next;
	char		*name;		/* module name for refcounting */
	int		refCnt;		/* the number of references */
	void		*entry;		/* entry point from load */
	int		nExports;	/* the number of exports found */
	ExportPtr	exports;	/* the array of exports */
} Module, *ModulePtr;

/*
 * We keep a list of all loaded modules to be able to reference count
 * duplicate dlopen's.
 */
static ModulePtr modList;		/* XXX threaded */

/*
 * The last error from one of the dl* routines is kept in static
 * variables here. Each error is returned only once to the caller.
 */
static char errbuf[BUFSIZ];		/* XXX threaded */
static int errvalid;			/* XXX threaded */

static void caterr(char *);
static int readExports(ModulePtr);
static void *findMain(void);

static char *strerror_failed   = "(strerror failed)";
static char *strerror_r_failed = "(strerror_r failed)";

char *strerrorcat(char *str, int err) {
    int strsiz = strlen(str);
    int msgsiz;
    char *msg;

#ifdef USE_THREADS
    char *buf = malloc(BUFSIZ);

    if (buf == 0)
      return 0;
    if (strerror_r(err, buf, BUFSIZ) == 0)
      msg = buf;
    else
      msg = strerror_r_failed;
    msgsiz = strlen(msg);
    if (strsiz + msgsiz < BUFSIZ)
      strcat(str, msg);
    free(buf);
#else
    if ((msg = strerror(err)) == 0)
      msg = strerror_failed;
    msgsiz = strlen(msg);		/* Note msg = buf and free() above. */
    if (strsiz + msgsiz < BUFSIZ)	/* Do not move this after #endif. */
      strcat(str, msg);
#endif

    return str;
}

char *strerrorcpy(char *str, int err) {
    int msgsiz;
    char *msg;

#ifdef USE_THREADS
    char *buf = malloc(BUFSIZ);

    if (buf == 0)
      return 0;
    if (strerror_r(err, buf, BUFSIZ) == 0)
      msg = buf;
    else
      msg = strerror_r_failed;
    msgsiz = strlen(msg);
    if (msgsiz < BUFSIZ)
      strcpy(str, msg);
    free(buf);
#else
    if ((msg = strerror(err)) == 0)
      msg = strerror_failed;
    msgsiz = strlen(msg);	/* Note msg = buf and free() above. */
    if (msgsiz < BUFSIZ)	/* Do not move this after #endif. */
      strcpy(str, msg);
#endif

    return str;
}
  
/* ARGSUSED */
void *dlopen(char *path, int mode)
{
	dTHX;
	register ModulePtr mp;
	static void *mainModule;		/* XXX threaded */

	/*
	 * Upon the first call register a terminate handler that will
	 * close all libraries.
	 */
	if (mainModule == NULL) {
		if ((mainModule = findMain()) == NULL)
			return NULL;
	}
	/*
	 * Scan the list of modules if have the module already loaded.
	 */
	for (mp = modList; mp; mp = mp->next)
		if (strcmp(mp->name, path) == 0) {
			mp->refCnt++;
			return mp;
		}
	Newz(1000,mp,1,Module);
	if (mp == NULL) {
		errvalid++;
		strcpy(errbuf, "Newz: ");
		strerrorcat(errbuf, errno);
		return NULL;
	}
	
	if ((mp->name = savepv(path)) == NULL) {
		errvalid++;
		strcpy(errbuf, "savepv: ");
		strerrorcat(errbuf, errno);
		safefree(mp);
		return NULL;
	}

	/*
	 * load should be declared load(const char *...). Thus we
	 * cast the path to a normal char *. Ugly.
	 */
	if ((mp->entry = (void *)LOAD((char *)path,
#ifdef L_LIBPATH_EXEC
				      L_LIBPATH_EXEC |
#endif
				      L_NOAUTODEFER,
				      NULL)) == NULL) {
	        int saverrno = errno;
		
		safefree(mp->name);
		safefree(mp);
		errvalid++;
		strcpy(errbuf, "dlopen: ");
		strcat(errbuf, path);
		strcat(errbuf, ": ");
		/*
		 * If AIX says the file is not executable, the error
		 * can be further described by querying the loader about
		 * the last error.
		 */
		if (saverrno == ENOEXEC) {
			char *moreinfo[BUFSIZ/sizeof(char *)];
			if (loadquery(L_GETMESSAGES, moreinfo, sizeof(moreinfo)) == -1)
				strerrorcpy(errbuf, saverrno);
			else {
				char **p;
				for (p = moreinfo; *p; p++)
					caterr(*p);
			}
		} else
			strerrorcat(errbuf, saverrno);
		return NULL;
	}
	mp->refCnt = 1;
	mp->next = modList;
	modList = mp;
	/*
	 * Assume anonymous exports come from the module this dlopen
	 * is linked into, that holds true as long as dlopen and all
	 * of the perl core are in the same shared object. Also bind
	 * against the main part, in the case a perl is not the main
	 * part, e.g mod_perl as DSO in Apache so perl modules can
	 * also reference Apache symbols.
	 */
	if (loadbind(0, (void *)dlopen, mp->entry) == -1 ||
	    loadbind(0, mainModule, mp->entry)) {
	        int saverrno = errno;

		dlclose(mp);
		errvalid++;
		strcpy(errbuf, "loadbind: ");
		strerrorcat(errbuf, saverrno);
		return NULL;
	}
	if (readExports(mp) == -1) {
		dlclose(mp);
		return NULL;
	}
	return mp;
}

/*
 * Attempt to decipher an AIX loader error message and append it
 * to our static error message buffer.
 */
static void caterr(char *s)
{
	register char *p = s;

	while (*p >= '0' && *p <= '9')
		p++;
	switch(atoi(s)) {
	case L_ERROR_TOOMANY:
		strcat(errbuf, "too many errors");
		break;
	case L_ERROR_NOLIB:
		strcat(errbuf, "can't load library");
		strcat(errbuf, p);
		break;
	case L_ERROR_UNDEF:
		strcat(errbuf, "can't find symbol");
		strcat(errbuf, p);
		break;
	case L_ERROR_RLDBAD:
		strcat(errbuf, "bad RLD");
		strcat(errbuf, p);
		break;
	case L_ERROR_FORMAT:
		strcat(errbuf, "bad exec format in");
		strcat(errbuf, p);
		break;
	case L_ERROR_ERRNO:
		strerrorcat(errbuf, atoi(++p));
		break;
	default:
		strcat(errbuf, s);
		break;
	}
}

void *dlsym(void *handle, const char *symbol)
{
	register ModulePtr mp = (ModulePtr)handle;
	register ExportPtr ep;
	register int i;

	/*
	 * Could speed up search, but I assume that one assigns
	 * the result to function pointers anyways.
	 */
	for (ep = mp->exports, i = mp->nExports; i; i--, ep++)
		if (strcmp(ep->name, symbol) == 0)
			return ep->addr;
	errvalid++;
	strcpy(errbuf, "dlsym: undefined symbol ");
	strcat(errbuf, symbol);
	return NULL;
}

char *dlerror(void)
{
	if (errvalid) {
		errvalid = 0;
		return errbuf;
	}
	return NULL;
}

int dlclose(void *handle)
{
	register ModulePtr mp = (ModulePtr)handle;
	int result;
	register ModulePtr mp1;

	if (--mp->refCnt > 0)
		return 0;
	result = UNLOAD(mp->entry);
	if (result == -1) {
		errvalid++;
		strerrorcpy(errbuf, errno);
	}
	if (mp->exports) {
		register ExportPtr ep;
		register int i;
		for (ep = mp->exports, i = mp->nExports; i; i--, ep++)
			if (ep->name)
				safefree(ep->name);
		safefree(mp->exports);
	}
	if (mp == modList)
		modList = mp->next;
	else {
		for (mp1 = modList; mp1; mp1 = mp1->next)
			if (mp1->next == mp) {
				mp1->next = mp->next;
				break;
			}
	}
	safefree(mp->name);
	safefree(mp);
	return result;
}

/* Added by Wayne Scott 
 * This is needed because the ldopen system call calls
 * calloc to allocated a block of date.  The ldclose call calls free.
 * Without this we get this system calloc and perl's free, resulting
 * in a "Bad free" message.  This way we always use perl's malloc.
 */
void *calloc(size_t ne, size_t sz) 
{
  void *out;

  out = (void *) safemalloc(ne*sz);
  memzero(out, ne*sz);
  return(out);
}
 
/*
 * Build the export table from the XCOFF .loader section.
 */
static int readExports(ModulePtr mp)
{
	dTHX;
	LDFILE *ldp = NULL;
	AIX_SCNHDR sh;
	AIX_LDHDR *lhp;
	char *ldbuf;
	AIX_LDSYM *ls;
	int i;
	ExportPtr ep;

	if ((ldp = ldopen(mp->name, ldp)) == NULL) {
		struct ld_info *lp;
		char *buf;
		int size = 4*1024;
		if (errno != ENOENT) {
			errvalid++;
			strcpy(errbuf, "readExports: ");
			strerrorcat(errbuf, errno);
			return -1;
		}
		/*
		 * The module might be loaded due to the LIBPATH
		 * environment variable. Search for the loaded
		 * module using L_GETINFO.
		 */
		if ((buf = safemalloc(size)) == NULL) {
			errvalid++;
			strcpy(errbuf, "readExports: ");
			strerrorcat(errbuf, errno);
			return -1;
		}
		while ((i = loadquery(L_GETINFO, buf, size)) == -1 && errno == ENOMEM) {
			safefree(buf);
			size += 4*1024;
			if ((buf = safemalloc(size)) == NULL) {
				errvalid++;
				strcpy(errbuf, "readExports: ");
				strerrorcat(errbuf, errno);
				return -1;
			}
		}
		if (i == -1) {
			errvalid++;
			strcpy(errbuf, "readExports: ");
			strerrorcat(errbuf, errno);
			safefree(buf);
			return -1;
		}
		/*
		 * Traverse the list of loaded modules. The entry point
		 * returned by LOAD() does actually point to the data
		 * segment origin.
		 */
		lp = (struct ld_info *)buf;
		while (lp) {
			if (lp->ldinfo_dataorg == mp->entry) {
				ldp = ldopen(lp->ldinfo_filename, ldp);
				break;
			}
			if (lp->ldinfo_next == 0)
				lp = NULL;
			else
				lp = (struct ld_info *)((char *)lp + lp->ldinfo_next);
		}
		safefree(buf);
		if (!ldp) {
			errvalid++;
			strcpy(errbuf, "readExports: ");
			strerrorcat(errbuf, errno);
			return -1;
		}
	}
#ifdef USE_64_BIT_ALL
	if (TYPE(ldp) != U803XTOCMAGIC) {
#else
	if (TYPE(ldp) != U802TOCMAGIC) {
#endif
		errvalid++;
		strcpy(errbuf, "readExports: bad magic");
		while(ldclose(ldp) == FAILURE)
			;
		return -1;
	}
	if (ldnshread(ldp, _LOADER, &sh) != SUCCESS) {
		errvalid++;
		strcpy(errbuf, "readExports: cannot read loader section header");
		while(ldclose(ldp) == FAILURE)
			;
		return -1;
	}
	/*
	 * We read the complete loader section in one chunk, this makes
	 * finding long symbol names residing in the string table easier.
	 */
	if ((ldbuf = (char *)safemalloc(sh.s_size)) == NULL) {
		errvalid++;
		strcpy(errbuf, "readExports: ");
		strerrorcat(errbuf, errno);
		while(ldclose(ldp) == FAILURE)
			;
		return -1;
	}
	if (FSEEK(ldp, sh.s_scnptr, BEGINNING) != OKFSEEK) {
		errvalid++;
		strcpy(errbuf, "readExports: cannot seek to loader section");
		safefree(ldbuf);
		while(ldclose(ldp) == FAILURE)
			;
		return -1;
	}
/* This first case is a hack, since it assumes that the 3rd parameter to
   FREAD is 1. See the redefinition of FREAD above to see how this works. */
	if (FREAD(ldbuf, sh.s_size, 1, ldp) != 1) {
		errvalid++;
		strcpy(errbuf, "readExports: cannot read loader section");
		safefree(ldbuf);
		while(ldclose(ldp) == FAILURE)
			;
		return -1;
	}
	lhp = (AIX_LDHDR *)ldbuf;
	ls = (AIX_LDSYM *)(ldbuf+AIX_LDHDRSZ);
	/*
	 * Count the number of exports to include in our export table.
	 */
	for (i = lhp->l_nsyms; i; i--, ls++) {
		if (!LDR_EXPORT(*ls))
			continue;
		mp->nExports++;
	}
	Newz(1001, mp->exports, mp->nExports, Export);
	if (mp->exports == NULL) {
		errvalid++;
		strcpy(errbuf, "readExports: ");
		strerrorcat(errbuf, errno);
		safefree(ldbuf);
		while(ldclose(ldp) == FAILURE)
			;
		return -1;
	}
	/*
	 * Fill in the export table. All entries are relative to
	 * the entry point we got from load.
	 */
	ep = mp->exports;
	ls = (AIX_LDSYM *)(ldbuf+AIX_LDHDRSZ);
	for (i = lhp->l_nsyms; i; i--, ls++) {
		char *symname;
		if (!LDR_EXPORT(*ls))
			continue;
#ifndef USE_64_BIT_ALL
		if (ls->l_zeroes == 0)
#endif
			symname = ls->l_offset+lhp->l_stoff+ldbuf;
#ifndef USE_64_BIT_ALL
		else
			symname = ls->l_name;
#endif
		ep->name = savepv(symname);
		ep->addr = (void *)((unsigned long)mp->entry + ls->l_value);
		ep++;
	}
	safefree(ldbuf);
	while(ldclose(ldp) == FAILURE)
		;
	return 0;
}

/*
 * Find the main modules entry point. This is used as export pointer
 * for loadbind() to be able to resolve references to the main part.
 */
static void * findMain(void)
{
	struct ld_info *lp;
	char *buf;
	int size = 4*1024;
	int i;
	void *ret;

	if ((buf = safemalloc(size)) == NULL) {
		errvalid++;
		strcpy(errbuf, "findMain: ");
		strerrorcat(errbuf, errno);
		return NULL;
	}
	while ((i = loadquery(L_GETINFO, buf, size)) == -1 && errno == ENOMEM) {
		safefree(buf);
		size += 4*1024;
		if ((buf = safemalloc(size)) == NULL) {
			errvalid++;
			strcpy(errbuf, "findMain: ");
			strerrorcat(errbuf, errno);
			return NULL;
		}
	}
	if (i == -1) {
		errvalid++;
		strcpy(errbuf, "findMain: ");
		strerrorcat(errbuf, errno);
		safefree(buf);
		return NULL;
	}
	/*
	 * The first entry is the main module. The entry point
	 * returned by load() does actually point to the data
	 * segment origin.
	 */
	lp = (struct ld_info *)buf;
	ret = lp->ldinfo_dataorg;
	safefree(buf);
	return ret;
}

/* dl_dlopen.xs
 * 
 * Platform:	SunOS/Solaris, possibly others which use dlopen.
 * Author:	Paul Marquess (Paul.Marquess@btinternet.com)
 * Created:	10th July 1994
 *
 * Modified:
 * 15th July 1994   - Added code to explicitly save any error messages.
 * 3rd August 1994  - Upgraded to v3 spec.
 * 9th August 1994  - Changed to use IV
 * 10th August 1994 - Tim Bunce: Added RTLD_LAZY, switchable debugging,
 *                    basic FreeBSD support, removed ClearError
 *
 */

/* Porting notes:

	see dl_dlopen.xs

*/

#include "dlutils.c"	/* SaveError() etc	*/


static void
dl_private_init(pTHX)
{
    (void)dl_generic_private_init(aTHX);
}
 
MODULE = DynaLoader     PACKAGE = DynaLoader

BOOT:
    (void)dl_private_init(aTHX);


void *
dl_load_file(filename, flags=0)
	char *	filename
	int	flags
	CODE:
	DLDEBUG(1,PerlIO_printf(Perl_debug_log, "dl_load_file(%s,%x):\n", filename,flags));
	if (flags & 0x01)
	    Perl_warn(aTHX_ "Can't make loaded symbols global on this platform while loading %s",filename);
	RETVAL = dlopen(filename, 1) ;
	DLDEBUG(2,PerlIO_printf(Perl_debug_log, " libref=%x\n", RETVAL));
	ST(0) = sv_newmortal() ;
	if (RETVAL == NULL)
	    SaveError(aTHX_ "%s",dlerror()) ;
	else
	    sv_setiv( ST(0), PTR2IV(RETVAL) );

int
dl_unload_file(libref)
    void *	libref
  CODE:
    DLDEBUG(1,PerlIO_printf(Perl_debug_log, "dl_unload_file(%lx):\n", libref));
    RETVAL = (dlclose(libref) == 0 ? 1 : 0);
    if (!RETVAL)
        SaveError(aTHX_ "%s", dlerror()) ;
    DLDEBUG(2,PerlIO_printf(Perl_debug_log, " retval = %d\n", RETVAL));
  OUTPUT:
    RETVAL

void *
dl_find_symbol(libhandle, symbolname)
	void *		libhandle
	char *		symbolname
	CODE:
	DLDEBUG(2,PerlIO_printf(Perl_debug_log, "dl_find_symbol(handle=%x, symbol=%s)\n",
		libhandle, symbolname));
	RETVAL = dlsym(libhandle, symbolname);
	DLDEBUG(2,PerlIO_printf(Perl_debug_log, "  symbolref = %x\n", RETVAL));
	ST(0) = sv_newmortal() ;
	if (RETVAL == NULL)
	    SaveError(aTHX_ "%s",dlerror()) ;
	else
	    sv_setiv( ST(0), PTR2IV(RETVAL));


void
dl_undef_symbols()
	PPCODE:


# These functions should not need changing on any platform:

void
dl_install_xsub(perl_name, symref, filename="$Package")
    char *	perl_name
    void *	symref 
    char *	filename
    CODE:
    DLDEBUG(2,PerlIO_printf(Perl_debug_log, "dl_install_xsub(name=%s, symref=%x)\n",
	perl_name, symref));
    ST(0) = sv_2mortal(newRV((SV*)newXS(perl_name,
					(void(*)(pTHX_ CV *))symref,
					filename)));


char *
dl_error()
    CODE:
    RETVAL = LastError ;
    OUTPUT:
    RETVAL

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