home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Applications / MacPerl 5.0.3 / MacPerl Source ƒ / Perl5 / ext / DynaLoader / dl_mac.xs < prev    next >
Encoding:
Text File  |  1995-02-03  |  5.4 KB  |  202 lines  |  [TEXT/MPS ]
  1. /* dl_dlopen.xs
  2.  * 
  3.  * Platform:    Macintosh CFM, possibly others which use dlopen.
  4.  * Author:    Matthias Neeracher <neeri@iis.ee.ethz.ch>
  5.  *        Adapted from dl_dlopen.xs reference implementation by
  6.  *              Paul Marquess (pmarquess@bfsec.bt.co.uk)
  7.  * $Log$
  8.  */
  9.  
  10. /* Porting notes:
  11.  
  12.  
  13.    Definition of Sunos dynamic Linking functions
  14.    =============================================
  15.    In order to make this implementation easier to understand here is a
  16.    quick definition of the SunOS Dynamic Linking functions which are
  17.    used here.
  18.  
  19.    dlopen
  20.    ------
  21.      void *
  22.      dlopen(path, mode)
  23.      char * path; 
  24.      int    mode;
  25.  
  26.      This function takes the name of a dynamic object file and returns
  27.      a descriptor which can be used by dlsym later. It returns NULL on
  28.      error.
  29.  
  30.      The mode parameter must be set to 1 for Solaris 1 and to
  31.      RTLD_LAZY on Solaris 2.
  32.  
  33.  
  34.    dlsym
  35.    ------
  36.      void *
  37.      dlsym(handle, symbol)
  38.      void * handle; 
  39.      char * symbol;
  40.  
  41.      Takes the handle returned from dlopen and the name of a symbol to
  42.      get the address of. If the symbol was found a pointer is
  43.      returned.  It returns NULL on error. If DL_PREPEND_UNDERSCORE is
  44.      defined an underscore will be added to the start of symbol. This
  45.      is required on some platforms (freebsd).
  46.  
  47.    dlerror
  48.    ------
  49.      char * dlerror()
  50.  
  51.      Returns a null-terminated string which describes the last error
  52.      that occurred with either dlopen or dlsym. After each call to
  53.      dlerror the error message will be reset to a null pointer. The
  54.      SaveError function is used to save the error as soo as it happens.
  55.  
  56.  
  57.    Return Types
  58.    ============
  59.    In this implementation the two functions, dl_load_file &
  60.    dl_find_symbol, return void *. This is because the underlying SunOS
  61.    dynamic linker calls also return void *.  This is not necessarily
  62.    the case for all architectures. For example, some implementation
  63.    will want to return a char * for dl_load_file.
  64.  
  65.    If void * is not appropriate for your architecture, you will have to
  66.    change the void * to whatever you require. If you are not certain of
  67.    how Perl handles C data types, I suggest you start by consulting    
  68.    Dean Roerich's Perl 5 API document. Also, have a look in the typemap 
  69.    file (in the ext directory) for a fairly comprehensive list of types 
  70.    that are already supported. If you are completely stuck, I suggest you
  71.    post a message to perl5-porters, comp.lang.perl or if you are really 
  72.    desperate to me.
  73.  
  74.    Remember when you are making any changes that the return value from 
  75.    dl_load_file is used as a parameter in the dl_find_symbol 
  76.    function. Also the return value from find_symbol is used as a parameter 
  77.    to install_xsub.
  78.  
  79.  
  80.    Dealing with Error Messages
  81.    ============================
  82.    In order to make the handling of dynamic linking errors as generic as
  83.    possible you should store any error messages associated with your
  84.    implementation with the StoreError function.
  85.  
  86.    In the case of SunOS the function dlerror returns the error message 
  87.    associated with the last dynamic link error. As the SunOS dynamic 
  88.    linker functions dlopen & dlsym both return NULL on error every call 
  89.    to a SunOS dynamic link routine is coded like this
  90.  
  91.     RETVAL = dlopen(filename, 1) ;
  92.     if (RETVAL == NULL)
  93.         SaveError("%s",dlerror()) ;
  94.  
  95.    Note that SaveError() takes a printf format string. Use a "%s" as
  96.    the first parameter if the error may contain and % characters.
  97.  
  98. */
  99.  
  100. #include "EXTERN.h"
  101. #include "perl.h"
  102. #include "XSUB.h"
  103.  
  104. #include <CodeFragments.h>
  105.  
  106.  
  107. #include "dlutils.c"    /* SaveError() etc    */
  108.  
  109. void CopyC2PStr(char * cstr, StringPtr pstr);
  110.  
  111.  
  112. static void
  113. dl_private_init()
  114. {
  115.     (void)dl_generic_private_init();
  116. }
  117.  
  118. MODULE = DynaLoader    PACKAGE = DynaLoader
  119.  
  120. BOOT:
  121.     (void)dl_private_init();
  122.  
  123.  
  124. ConnectionID
  125. dl_load_file(filename)
  126.     char *        filename
  127.     CODE:
  128.     OSErr        err;
  129.     FSSpec        spec;
  130.     ConnectionID    connID;
  131.     Ptr            mainAddr;
  132.     Str255        errName;
  133.     DLDEBUG(1,fprintf(stderr,"dl_load_file(%s):\n", filename));
  134.     err = Path2FSSpec(filename, &spec);
  135.     if (!err)
  136.         err = 
  137.         GetDiskFragment(
  138.             &spec, 0, 0, &spec.name, kLoadLib, &connID, &mainAddr, errName);
  139.     if (!err)
  140.         RETVAL = connID;
  141.     else
  142.          RETVAL = (ConnectionID) 0;
  143.     DLDEBUG(2,fprintf(stderr," libref=%x\n", RETVAL));
  144.     ST(0) = sv_newmortal() ;
  145.     if (err)
  146.     SaveError("DynaLoader error [%d]!", err) ;
  147.     else
  148.     sv_setiv( ST(0), (IV)RETVAL);
  149.  
  150.  
  151. void *
  152. dl_find_symbol(connID, symbolname)
  153.     ConnectionID    connID
  154.     char *        symbolname
  155.     CODE:
  156.     OSErr        err;
  157.     Str255        symbol;
  158.     Ptr            symAddr;
  159.     SymClass        symClass;
  160.     DLDEBUG(2,fprintf(stderr,"dl_find_symbol(handle=%x, symbol=%s)\n",
  161.     connID, symbolname));
  162.     CopyC2PStr(symbolname, symbol);
  163.     err = FindSymbol(connID, symbol, &symAddr, &symClass);
  164.     if (err)
  165.         symAddr = (Ptr) 0;
  166.     RETVAL = (void *) symAddr;
  167.     DLDEBUG(2,fprintf(stderr,"  symbolref = %x\n", RETVAL));
  168.     ST(0) = sv_newmortal() ;
  169.     if (err)
  170.     SaveError("DynaLoader error [%d]!", err) ;
  171.     else
  172.     sv_setiv( ST(0), (IV)RETVAL);
  173.  
  174.  
  175. void
  176. dl_undef_symbols()
  177.     PPCODE:
  178.  
  179.  
  180.  
  181. # These functions should not need changing on any platform:
  182.  
  183. void
  184. dl_install_xsub(perl_name, symref, filename="$Package")
  185.     char *        perl_name
  186.     void *        symref 
  187.     char *        filename
  188.     CODE:
  189.     DLDEBUG(2,fprintf(stderr,"dl_install_xsub(name=%s, symref=%x)\n",
  190.         perl_name, symref));
  191.     ST(0)=sv_2mortal(newRV((SV*)newXS(perl_name, (void(*)())symref, filename)));
  192.  
  193.  
  194. char *
  195. dl_error()
  196.     CODE:
  197.     RETVAL = LastError ;
  198.     OUTPUT:
  199.     RETVAL
  200.  
  201. # end.
  202.