tclLoadDld.c
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:6k
源码类别:

通讯编程

开发平台:

Visual C++

  1. /* 
  2.  * tclLoadDld.c --
  3.  *
  4.  * This procedure provides a version of the TclLoadFile that
  5.  * works with the "dld_link" and "dld_get_func" library procedures
  6.  * for dynamic loading.  It has been tested on Linux 1.1.95 and
  7.  * dld-3.2.7.  This file probably isn't needed anymore, since it
  8.  * makes more sense to use "dl_open" etc.
  9.  *
  10.  * Copyright (c) 1995-1997 Sun Microsystems, Inc.
  11.  *
  12.  * See the file "license.terms" for information on usage and redistribution
  13.  * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  14.  *
  15.  * RCS: @(#) $Id: tclLoadDld.c,v 1.12 2002/10/10 12:25:53 vincentdarley Exp $
  16.  */
  17. #include "tclInt.h"
  18. #include "dld.h"
  19. /*
  20.  * In some systems, like SunOS 4.1.3, the RTLD_NOW flag isn't defined
  21.  * and this argument to dlopen must always be 1.
  22.  */
  23. #ifndef RTLD_NOW
  24. #   define RTLD_NOW 1
  25. #endif
  26. /*
  27.  *----------------------------------------------------------------------
  28.  *
  29.  * TclpDlopen --
  30.  *
  31.  * Dynamically loads a binary code file into memory and returns
  32.  * a handle to the new code.
  33.  *
  34.  * Results:
  35.  * A standard Tcl completion code.  If an error occurs, an error
  36.  * message is left in the interp's result.
  37.  *
  38.  * Side effects:
  39.  * New code suddenly appears in memory.
  40.  *
  41.  *----------------------------------------------------------------------
  42.  */
  43. int
  44. TclpDlopen(interp, pathPtr, loadHandle, unloadProcPtr)
  45.     Tcl_Interp *interp; /* Used for error reporting. */
  46.     Tcl_Obj *pathPtr; /* Name of the file containing the desired
  47.  * code (UTF-8). */
  48.     Tcl_LoadHandle *loadHandle; /* Filled with token for dynamically loaded
  49.  * file which will be passed back to 
  50.  * (*unloadProcPtr)() to unload the file. */
  51.     Tcl_FSUnloadFileProc **unloadProcPtr;
  52. /* Filled with address of Tcl_FSUnloadFileProc
  53.  * function which should be used for
  54.  * this file. */
  55. {
  56.     static int firstTime = 1;
  57.     int returnCode;
  58.     char *fileName;
  59.     CONST char *native;
  60.     
  61.     /*
  62.      *  The dld package needs to know the pathname to the tcl binary.
  63.      *  If that's not known, return an error.
  64.      */
  65.     if (firstTime) {
  66. if (tclExecutableName == NULL) {
  67.     Tcl_SetResult(interp,
  68.     "don't know name of application binary file, so can't initialize dynamic loader",
  69.     TCL_STATIC);
  70.     return TCL_ERROR;
  71. }
  72. returnCode = dld_init(tclExecutableName);
  73. if (returnCode != 0) {
  74.     Tcl_AppendResult(interp,
  75.     "initialization failed for dynamic loader: ",
  76.     dld_strerror(returnCode), (char *) NULL);
  77.     return TCL_ERROR;
  78. }
  79. firstTime = 0;
  80.     }
  81.     fileName = Tcl_GetString(pathPtr);
  82.     /* 
  83.      * First try the full path the user gave us.  This is particularly
  84.      * important if the cwd is inside a vfs, and we are trying to load
  85.      * using a relative path.
  86.      */
  87.     native = Tcl_FSGetNativePath(pathPtr);
  88.     returnCode = dld_link(native);
  89.     
  90.     if (returnCode != 0) {
  91. Tcl_DString ds;
  92. native = Tcl_UtfToExternalDString(NULL, fileName, -1, &ds);
  93. returnCode = dld_link(native);
  94. Tcl_DStringFree(&ds);
  95.     }
  96.     if (returnCode != 0) {
  97. Tcl_AppendResult(interp, "couldn't load file "", 
  98.  fileName, "": ", 
  99.  dld_strerror(returnCode), (char *) NULL);
  100. return TCL_ERROR;
  101.     }
  102.     *loadHandle = (Tcl_LoadHandle) strcpy(
  103.     (char *) ckalloc((unsigned) (strlen(fileName) + 1)), fileName);
  104.     *unloadProcPtr = &TclpUnloadFile;
  105.     return TCL_OK;
  106. }
  107. /*
  108.  *----------------------------------------------------------------------
  109.  *
  110.  * TclpFindSymbol --
  111.  *
  112.  * Looks up a symbol, by name, through a handle associated with
  113.  * a previously loaded piece of code (shared library).
  114.  *
  115.  * Results:
  116.  * Returns a pointer to the function associated with 'symbol' if
  117.  * it is found.  Otherwise returns NULL and may leave an error
  118.  * message in the interp's result.
  119.  *
  120.  *----------------------------------------------------------------------
  121.  */
  122. Tcl_PackageInitProc*
  123. TclpFindSymbol(interp, loadHandle, symbol) 
  124.     Tcl_Interp *interp;
  125.     Tcl_LoadHandle loadHandle;
  126.     CONST char *symbol;
  127. {
  128.     return (Tcl_PackageInitProc *) dld_get_func(symbol);
  129. }
  130. /*
  131.  *----------------------------------------------------------------------
  132.  *
  133.  * TclpUnloadFile --
  134.  *
  135.  * Unloads a dynamically loaded binary code file from memory.
  136.  * Code pointers in the formerly loaded file are no longer valid
  137.  * after calling this function.
  138.  *
  139.  * Results:
  140.  * None.
  141.  *
  142.  * Side effects:
  143.  * Code removed from memory.
  144.  *
  145.  *----------------------------------------------------------------------
  146.  */
  147. void
  148. TclpUnloadFile(loadHandle)
  149.     Tcl_LoadHandle loadHandle; /* loadHandle returned by a previous call
  150.  * to TclpDlopen().  The loadHandle is 
  151.  * a token that represents the loaded 
  152.  * file. */
  153. {
  154.     char *fileName;
  155.     handle = (char *) loadHandle;
  156.     dld_unlink_by_file(handle, 0);
  157.     ckfree(handle);
  158. }
  159. /*
  160.  *----------------------------------------------------------------------
  161.  *
  162.  * TclGuessPackageName --
  163.  *
  164.  * If the "load" command is invoked without providing a package
  165.  * name, this procedure is invoked to try to figure it out.
  166.  *
  167.  * Results:
  168.  * Always returns 0 to indicate that we couldn't figure out a
  169.  * package name;  generic code will then try to guess the package
  170.  * from the file name.  A return value of 1 would have meant that
  171.  * we figured out the package name and put it in bufPtr.
  172.  *
  173.  * Side effects:
  174.  * None.
  175.  *
  176.  *----------------------------------------------------------------------
  177.  */
  178. int
  179. TclGuessPackageName(fileName, bufPtr)
  180.     CONST char *fileName; /* Name of file containing package (already
  181.  * translated to local form if needed). */
  182.     Tcl_DString *bufPtr; /* Initialized empty dstring.  Append
  183.  * package name to this if possible. */
  184. {
  185.     return 0;
  186. }