"{ Encoding: utf8 }"

"

 COPYRIGHT (c) 1993 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libcomp' }"

"{ NameSpace: Smalltalk }"

Object subclass:#ObjectFileLoader

	instanceVariableNames:''

	classVariableNames:'ActuallyLoadedObjects CopyLibrariesWhenLoading ErrorPrinting

		LastError LastErrorNumber LinkErrorMessage LoadedObjects

		MySymbolTable NextHandleID OldSpaceReserve

		PreviouslyLoadedObjects Verbose'

	poolDictionaries:''

	category:'System-Compiler'

!

Error subclass:#ObjectFileLoadError

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:ObjectFileLoader

!

Notification subclass:#ObjectFileLoadErrorNotification

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:ObjectFileLoader

!

ObjectFileLoader::ObjectFileLoadErrorNotification subclass:#RegistrationFailedErrorNotification

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:ObjectFileLoader

!

ObjectFileLoader::ObjectFileLoadErrorNotification subclass:#SuperClassMissingErrorNotification

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:ObjectFileLoader

!

!ObjectFileLoader primitiveDefinitions!

%{

#undef true

#undef false

/*

 * by default, use whatever the system provides

 */

#if defined(SYSV4) || defined(HAS_DLOPEN)   /* sys5.4 dlopen interface */

# define SYSV4_DL

# define HAS_DL

#endif

#ifdef __VMS__

# undef __new

#endif

#ifdef DL1_6    /* dl1.6 COFF loader */

# define HAS_DL

#endif

#include <stdio.h>

#ifdef NEXT_DL

# ifndef _RLD_H_

#  define _RLD_H_

#  ifdef __NEXT3__

#   include <mach-o/rld.h>

#  else

#   include <rld.h>

#  endif

# endif

#endif /* NEXT_DL */

#ifdef SYSV4_DL

# ifndef dlfcn_h

#  include <dlfcn.h>

#  define dlfcn_h

# endif

#endif

#ifdef GNU_DL

#  ifndef dld_h

#   include "dld.h"

#   define dld_h

#  endif

#endif

#ifdef DL1_6

#  ifndef dl_h

#   include "dl.h"

#   define dl_h

#  endif

#endif

#ifdef AIX_DL

# include <nlist.h>

# include <sys/ldr.h>

# include <errno.h>

#endif

#ifdef HPUX10_DL

# ifndef dl_h

#  include <dl.h>

#  define dl_h

# endif

# include <errno.h>

#endif

#ifdef WIN_DL

# undef INT

# undef UINT

# undef Array

# undef Number

# undef Method

# undef Block

# undef Time

# undef Date

# undef Set

# undef Delay

# undef Signal

# undef Context

# undef Message

# undef Process

# undef Processor

# undef Rectangle

# undef String

# undef Character

# undef Point

# undef Object

# ifdef __i386__

#  ifndef _X86_

#   define _X86_

#  endif

# endif

# ifdef __BORLANDC__

#  define NOATOM

#  define NOUSER

#  define NOGDI

#  define NOGDICAPMASKS

#  define NOMETAFILE

#  define NOMINMAX

#  define NOMSG

#  define NOOPENFILE

#  define NORASTEROPS

#  define NOSCROLL

#  define NOSOUND

#  define NOSYSMETRICS

#  define NOTEXTMETRIC

#  define NOWH

#  define NOCOMM

#  define NOKANJI

#  define NOCRYPT

#  define NOMCX

#  define WIN32_LEAN_AND_MEAN

#  include <windows.h>

// #  include <windef.h>

// #  include <winbase.h>

# else

#  ifdef __VISUALC__

// #  include <windows.h>

#   include <windef.h>

#   include <winbase.h>

#  else

#   include <windows.h>

#  endif

# endif /* BORLANDC */

# ifdef __DEF_Array

#  define Array __DEF_Array

# endif

# ifdef __DEF_Number

#  define Number __DEF_Number

# endif

# ifdef __DEF_Method

#  define Method __DEF_Method

# endif

# ifdef __DEF_Block

#  define Block __DEF_Block

# endif

# ifdef __DEF_Time

#  define Time __DEF_Time

# endif

# ifdef __DEF_Date

#  define Date __DEF_Date

# endif

# ifdef __DEF_Set

#  define Set __DEF_Set

# endif

# ifdef __DEF_Signal

#  define Signal __DEF_Signal

# endif

# ifdef __DEF_Delay

#  define Delay __DEF_Delay

# endif

# ifdef __DEF_Context

#  define Context __DEF_Context

# endif

# ifdef __DEF_Message

#  define Message __DEF_Message

# endif

# ifdef __DEF_Process

#  define Process __DEF_Process

# endif

# ifdef __DEF_Processor

#  define Processor __DEF_Processor

# endif

# ifdef __DEF_Rectangle

#  define Rectangle __DEF_Rectangle

# endif

# ifdef __DEF_String

#  define String __DEF_String

# endif

# ifdef __DEF_Character

#  define Character __DEF_Character

# endif

# ifdef __DEF_Point

#  define Point __DEF_Point

# endif

# ifdef __DEF_Object

#  define Object __DEF_Object

# endif

# define INT STX_INT

# define UINT STX_UINT

#endif /* WIN_DL */

#undef true

#define true __STX_true

#undef false

#define false __STX_false

%}

! !

!ObjectFileLoader class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1993 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    This class knowns how to dynamically load in external object-modules.

    WARNING:

      As to date, this is still experimental and WITHOUT ANY WARRANTY.

      It is still being developed and the code may need some cleanup and more

      robustness.

    There are basically two totally different mechanisms to do this:

	a) if there exists some dynamic-link facility such as:

	   GNU-DL, dlopen (sparc, SYS5.4), rld_open (NeXT),

	   or LoadLibrary (Win32), this is used

	b) if no such facility exists, the normal linker is used to

	   link the module to text/data address as previously malloced,

	   and the object file is loaded into that space.

    Not all mechanisms work fully satisfying.

    For example, the sun dl*-functions do an exit on link-errors

    (which is certainly not what we want here :-(;

    the NeXT mechanism does not allow for selective unloading

    (only all or the last loaded module).

    The only really useful packages are the GNU-dl package,

    the SGI/Unixware/sys5.4/linux/osx libdl packages and the win32 dll's.

    The GNU-dl package is only available for a.out file formats

    (which is more or less obsolete);

    For the above reasons, dynamic object loading is only

    officially released for SYS5.4-based, linux, osx and win32 systems.

    When stable, the functionality contained herein will be moved into the VM.

    (It is needed there, to allow reloading of objectfiles upon

     image restart; i.e. before any class is reinitialilized).

    Right now, reloading of object files is done by Smalltalk code,

    which fails, if code is to be loaded which is required before the

    load takes place, or which is used by the loader itself.

    (i.e. for now, many primitives from libbasic cannot be dynamically

    loaded at image restart time).

    This will fix itself, once we do object file loading in the VM.

    [author:]

	Claus Gittinger

"

! !

!ObjectFileLoader class methodsFor:'initialization'!

initialize

    |systemType libDir linkCommand linkArgs libPath searchedLibraries|

    Verbose := false.

    "/ Verbose := true.

    OperatingSystem isMSDOSlike ifTrue:[

	ParserFlags useBorlandC ifTrue:[

	    "/ default setup for bcc

	    libDir := '..\lib\bc'.

	    libDir asFilename exists ifFalse:[

		libDir := '..\lib\lib\bc'.

		libDir asFilename exists ifFalse:[

		    libDir := '..\lib'.

		]

	    ].

	    linkCommand isNil ifTrue:[

		"/ linkCommand := 'tlink32'.

		linkCommand := 'ilink32'.

	    ].

	    linkArgs isNil ifTrue:[

		"/ linkArgs := '-L',libDir,' -L\Programme\Borland\CBuilder3\lib -c -ap -Tpd -s -Gi -v -w-dup ',libDir,'\librun.lib'.

		linkArgs := '-L',libDir,' -L\Programme\Borland\CBuilder3\lib -r -c -ap -Tpd -Gi -w-dup'.

	    ].

	    searchedLibraries := #(

				    'import32.lib'

				  ).

	] ifFalse:[

	    linkCommand isNil ifTrue:[

		linkCommand := 'link'

	    ].

	    linkArgs isNil ifTrue:[

		linkArgs := '/NOPACK /NOLOGO /DEBUG /MACHINE:I386 /DLL /OUT:%1.dll /DEF:%1.def'

	    ].

	].

    ].

    MySymbolTable isNil ifTrue:[

	NextHandleID := 1.

	ObjectMemory addDependent:self.

	OperatingSystem isMSDOSlike ifTrue:[

	    searchedLibraries := #(

				    'import32.lib'

				  ).

	].

	OperatingSystem isUNIXlike ifTrue:[

	    |ldLibraryPath|

	    systemType := OperatingSystem getOSType.

	    "/ name of object file, where initial symbol table is found

	    "/ not req'd for all architectures.

	    MySymbolTable := 'stx'.

	    searchedLibraries := #().

	    "/ default libraryPath where shared objects are expected

	    "/ when a sharedObject load requires other objects to be loaded.

	    "/ For more compatibility with ELF systems, look for a shell variable

	    "/ named LD_LIBRARY_PATH, and - if present - take that instead if a default.

	    "/ Can (should) be set in the smalltalk.rc file.

	    ldLibraryPath := OperatingSystem getEnvironment:'LD_LIBRARY_PATH'.

	    ldLibraryPath isEmptyOrNil ifTrue:[

		libPath := '.:lib:/usr/local/smalltalk/lib:/usr/local/lib:/usr/lib:/lib'.

	    ] ifFalse:[

		"/ only needed for AIX - the dynamic linker of other Unixes use LD_LIBRARY_PATH implicitly

		systemType = #aix ifTrue:[

		    libPath := ldLibraryPath.

		].

	    ]

	]

    ].

    ParserFlags linkCommand:linkCommand.

    ParserFlags linkArgs:linkArgs.

    ParserFlags libPath:libPath ? ''.

    ParserFlags searchedLibraries:searchedLibraries.

    "

     LinkArgs := LinkCommand := nil.

     ObjectFileLoader initialize

    "

    "Modified: / 28-09-2012 / 18:19:28 / cg"

!

lastError

    ^ LastError ? 'unknown error'

    "Modified: / 30.9.1998 / 17:21:23 / cg"

!

libPath

    "see comment in #libPath:"

    ^ ParserFlags libPath

!

libPath:aSharedLibraryPath

    "set the pathnames of directories, where other shared objects

     are searched, in case a loaded module requires another module shared

     library object to be loaded.

     Currently, this is only required to be set for AIX systems;

     ELF based linux and solaris systems specify the libPath in the

     LD_LIBRARY_PATH environment variable."

    ParserFlags libPath:aSharedLibraryPath

    "

     ObjectFileLoader libPath:'.:/usr/lib:/usr/local/lib'

    "

!

linkErrorMessage

    ^ LinkErrorMessage

!

searchedLibraries

    "see comment in #searchedLibraries:"

    ^ ParserFlags searchedLibraries

!

searchedLibraries:aCollectionOfArchivePathNames

    "set the pathnames of archives which are to be searched

     when unresolved references occur while loading in an object

     file. On systems which support shared libraries (all SYS5.4 based

     systems), this is usually not required. Instead, modules which are to

     be filed in (.so files) are to be prelinked with the appropriate

     shared libraries. The dynamic loader then cares about loading those

     modules (keeping track of which modules are already loaded).

     Only systems in which the dynamic load is done 'manually' by st/x

     (i.e. currently only linux and a.out-sunos) need to set this."

    ParserFlags searchedLibraries:aCollectionOfArchivePathNames

!

verbose

    "return true, if debug traces are turned on"

    ^ Verbose

!

verbose:aBoolean

    "turn on/off debug traces"

    Verbose := aBoolean

    "ObjectFileLoader verbose:true"

! !

!ObjectFileLoader class methodsFor:'accessing'!

copyLibrariesWhenLoading

    "under windows, a library file (dll) which has been loaded cannot be overwritten.

     This makes it troublesome, to recompile a new lib while a smalltalk is being executed.

     When CopyLibrariesWhenLoading is true, ddl files are copied to a tempdir before loading,

     so that the original can still be recompiled.

     Makes loading a bit slower (due to the copying),

     so it is off by default and must be turned on explicitly during development."