fpc/rtl/unix/dynlibs.inc
svenbarth 2d454dc8fa Move DynLibs support to System unit using a manager approach like for Threads, WideStrings, etc.. This is needed so that we can support features like "delayed" and loading of dynamic packages.
Each port that allows the usage of dynamic libraries should call InitSystemDynLibs during initialization of the System unit.
The DynLibs unit has been adjusted to be a forwarder for the functions that now reside in the System unit (for backwards compatiblity just in case). Additionally the unit will register the DynLibsManager if it doesn't reside in the System unit anyway.
Currently only the Windows targets (Win32, Win64 and WinCE) implement the DynLibsManager inside the System unit. For other systems using the LoadLibrary, etc. functions will lead to a run error/exception.
If a port wants to implement its own DynLibsManager then it needs to define DISABLE_NO_DYNLIBS_MANAGER. TLibHandle, NilHandle and optionally TOrdinalEntry (it's set to SizeUInt otherwise) should be defined in sysdlh.inc which needs to be enabled using the define FPC_SYSTEM_HAS_SYSDLH (because there are targets which have FEATURE_DYNLIBS enabled, but don't support them... e.g. powerpc-wii -.-).
The DynLibsManager contains methods for loading a library based on a RawByteString and based on a UnicodeString. BOTH should be implemented, but internally one can forward to the other.
The loading by ordinal *can* be be implemented. If it is set to Nil then the implementation of GetProcAddress(lib,ordinal) will return Nil.

+ new functions SetDynLibsManager and GetDynLibsManager to set and retrieve the current DynLibsManager
* provide interface of DynLibs unit in unit System

git-svn-id: trunk@29613 -
2015-02-03 20:00:00 +00:00

79 lines
2.0 KiB
PHP

{
This file is part of the Free Pascal run time library.
Copyright (c) 1999-2000 by the Free Pascal development team
Implement OS-dependent part of dynamic library loading.
See the file COPYING.FPC, included in this distribution,
for details about the copyright.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
**********************************************************************}
uses dl;
Function SysLoadLibraryA(const Name : RawByteString) : TLibHandle;
{$ifdef aix}
var
MemberName: RawByteString;
{$endif}
begin
{$ifndef aix}
Result:=TLibHandle(dlopen(PAnsiChar(Name),RTLD_LAZY));
{$else aix}
{ in aix, most shared libraries are static libraries (archives) that contain
a single object: shr.o for 32 bit, shr_64.o for 64 bit. You have to specify
this object file explicitly via the RTLD_MEMBER member flag }
{$ifdef cpu64}
MemberName:='(shr_64.o)';
{$else cpu64}
MemberName:='(shr.o)';
{$endif cpu64}
SetCodePage(MemberName,DefaultFileSystemCodePage,false);
MemberName:=Name+MemberName;
Result:=TLibHandle(dlopen(PAnsiChar(MemberName),RTLD_LAZY or RTLD_MEMBER));
{$endif aix}
end;
Function SysLoadLibraryU(const Name: UnicodeString) : TLibHandle;
begin
Result := SysLoadLibraryA(ToSingleByteFileSystemEncodedFileName(Name));
end;
Function SysGetProcedureAddress(Lib : TLibHandle; const ProcName : AnsiString) : Pointer;
begin
Result:=dlsym(lib,pchar(ProcName));
end;
Function SysUnloadLibrary(Lib : TLibHandle) : Boolean;
begin
Result:=dlClose(Lib)=0;
end;
Function SysGetLoadErrorStr: string;
begin
Result:=dl.dlerror;
end;
const
SysDynLibsManager: TDynLibsManager = (
LoadLibraryU: @SysLoadLibraryU;
LoadLibraryA: @SysLoadLibraryA;
GetProcAddress: @SysGetProcedureAddress;
GetProcAddressOrdinal: Nil;
UnloadLibrary: @SysUnloadLibrary;
GetLoadErrorStr: @SysGetLoadErrorStr;
);
procedure InitDynLibs;
begin
SetDynLibsManager(SysDynLibsManager);
end;