sl@0: /* sl@0: * tclLoadOSF.c -- sl@0: * sl@0: * This procedure provides a version of the TclLoadFile that works sl@0: * under OSF/1 1.0/1.1/1.2 and related systems, utilizing the old OSF/1 sl@0: * /sbin/loader and /usr/include/loader.h. OSF/1 versions from 1.3 and sl@0: * on use ELF, rtld, and dlopen()[/usr/include/ldfcn.h]. sl@0: * sl@0: * This is useful for: sl@0: * OSF/1 1.0, 1.1, 1.2 (from OSF) sl@0: * includes: MK4 and AD1 (from OSF RI) sl@0: * OSF/1 1.3 (from OSF) using ROSE sl@0: * HP OSF/1 1.0 ("Acorn") using COFF sl@0: * sl@0: * This is likely to be useful for: sl@0: * Paragon OSF/1 (from Intel) sl@0: * HI-OSF/1 (from Hitachi) sl@0: * sl@0: * This is NOT to be used on: sl@0: * Digitial Alpha OSF/1 systems sl@0: * OSF/1 1.3 or later (from OSF) using ELF sl@0: * includes: MK6, MK7, AD2, AD3 (from OSF RI) sl@0: * sl@0: * This approach to things was utter @&^#; thankfully, sl@0: * OSF/1 eventually supported dlopen(). sl@0: * sl@0: * John Robert LoVerso sl@0: * sl@0: * Copyright (c) 1995-1997 Sun Microsystems, Inc. sl@0: * sl@0: * See the file "license.terms" for information on usage and redistribution sl@0: * of this file, and for a DISCLAIMER OF ALL WARRANTIES. sl@0: * sl@0: * RCS: @(#) $Id: tclLoadOSF.c,v 1.11 2002/10/10 12:25:53 vincentdarley Exp $ sl@0: */ sl@0: sl@0: #include "tclInt.h" sl@0: #include sl@0: #include sl@0: sl@0: /* sl@0: *---------------------------------------------------------------------- sl@0: * sl@0: * TclpDlopen -- sl@0: * sl@0: * Dynamically loads a binary code file into memory and returns sl@0: * a handle to the new code. sl@0: * sl@0: * Results: sl@0: * A standard Tcl completion code. If an error occurs, an error sl@0: * message is left in the interp's result. sl@0: * sl@0: * Side effects: sl@0: * New code suddenly appears in memory. sl@0: * sl@0: *---------------------------------------------------------------------- sl@0: */ sl@0: sl@0: int sl@0: TclpDlopen(interp, pathPtr, loadHandle, unloadProcPtr) sl@0: Tcl_Interp *interp; /* Used for error reporting. */ sl@0: Tcl_Obj *pathPtr; /* Name of the file containing the desired sl@0: * code (UTF-8). */ sl@0: Tcl_LoadHandle *loadHandle; /* Filled with token for dynamically loaded sl@0: * file which will be passed back to sl@0: * (*unloadProcPtr)() to unload the file. */ sl@0: Tcl_FSUnloadFileProc **unloadProcPtr; sl@0: /* Filled with address of Tcl_FSUnloadFileProc sl@0: * function which should be used for sl@0: * this file. */ sl@0: { sl@0: ldr_module_t lm; sl@0: char *pkg; sl@0: char *fileName = Tcl_GetString(pathPtr); sl@0: CONST char *native; sl@0: sl@0: /* sl@0: * First try the full path the user gave us. This is particularly sl@0: * important if the cwd is inside a vfs, and we are trying to load sl@0: * using a relative path. sl@0: */ sl@0: native = Tcl_FSGetNativePath(pathPtr); sl@0: lm = (Tcl_PackageInitProc *) load(native, LDR_NOFLAGS); sl@0: sl@0: if (lm == LDR_NULL_MODULE) { sl@0: /* sl@0: * Let the OS loader examine the binary search path for sl@0: * whatever string the user gave us which hopefully refers sl@0: * to a file on the binary path sl@0: */ sl@0: Tcl_DString ds; sl@0: native = Tcl_UtfToExternalDString(NULL, fileName, -1, &ds); sl@0: lm = (Tcl_PackageInitProc *) load(native, LDR_NOFLAGS); sl@0: Tcl_DStringFree(&ds); sl@0: } sl@0: sl@0: if (lm == LDR_NULL_MODULE) { sl@0: Tcl_AppendResult(interp, "couldn't load file \"", fileName, sl@0: "\": ", Tcl_PosixError (interp), (char *) NULL); sl@0: return TCL_ERROR; sl@0: } sl@0: sl@0: *clientDataPtr = NULL; sl@0: sl@0: /* sl@0: * My convention is to use a [OSF loader] package name the same as shlib, sl@0: * since the idiots never implemented ldr_lookup() and it is otherwise sl@0: * impossible to get a package name given a module. sl@0: * sl@0: * I build loadable modules with a makefile rule like sl@0: * ld ... -export $@: -o $@ $(OBJS) sl@0: */ sl@0: if ((pkg = strrchr(fileName, '/')) == NULL) { sl@0: pkg = fileName; sl@0: } else { sl@0: pkg++; sl@0: } sl@0: *loadHandle = pkg; sl@0: *unloadProcPtr = &TclpUnloadFile; sl@0: return TCL_OK; sl@0: } sl@0: sl@0: /* sl@0: *---------------------------------------------------------------------- sl@0: * sl@0: * TclpFindSymbol -- sl@0: * sl@0: * Looks up a symbol, by name, through a handle associated with sl@0: * a previously loaded piece of code (shared library). sl@0: * sl@0: * Results: sl@0: * Returns a pointer to the function associated with 'symbol' if sl@0: * it is found. Otherwise returns NULL and may leave an error sl@0: * message in the interp's result. sl@0: * sl@0: *---------------------------------------------------------------------- sl@0: */ sl@0: Tcl_PackageInitProc* sl@0: TclpFindSymbol(interp, loadHandle, symbol) sl@0: Tcl_Interp *interp; sl@0: Tcl_LoadHandle loadHandle; sl@0: CONST char *symbol; sl@0: { sl@0: return ldr_lookup_package((char *)loadHandle, symbol); sl@0: } sl@0: sl@0: /* sl@0: *---------------------------------------------------------------------- sl@0: * sl@0: * TclpUnloadFile -- sl@0: * sl@0: * Unloads a dynamically loaded binary code file from memory. sl@0: * Code pointers in the formerly loaded file are no longer valid sl@0: * after calling this function. sl@0: * sl@0: * Results: sl@0: * None. sl@0: * sl@0: * Side effects: sl@0: * Does nothing. Can anything be done? sl@0: * sl@0: *---------------------------------------------------------------------- sl@0: */ sl@0: sl@0: void sl@0: TclpUnloadFile(loadHandle) sl@0: Tcl_LoadHandle loadHandle; /* loadHandle returned by a previous call sl@0: * to TclpDlopen(). The loadHandle is sl@0: * a token that represents the loaded sl@0: * file. */ sl@0: { sl@0: } sl@0: sl@0: /* sl@0: *---------------------------------------------------------------------- sl@0: * sl@0: * TclGuessPackageName -- sl@0: * sl@0: * If the "load" command is invoked without providing a package sl@0: * name, this procedure is invoked to try to figure it out. sl@0: * sl@0: * Results: sl@0: * Always returns 0 to indicate that we couldn't figure out a sl@0: * package name; generic code will then try to guess the package sl@0: * from the file name. A return value of 1 would have meant that sl@0: * we figured out the package name and put it in bufPtr. sl@0: * sl@0: * Side effects: sl@0: * None. sl@0: * sl@0: *---------------------------------------------------------------------- sl@0: */ sl@0: sl@0: int sl@0: TclGuessPackageName(fileName, bufPtr) sl@0: CONST char *fileName; /* Name of file containing package (already sl@0: * translated to local form if needed). */ sl@0: Tcl_DString *bufPtr; /* Initialized empty dstring. Append sl@0: * package name to this if possible. */ sl@0: { sl@0: return 0; sl@0: }