java.lang.Object
com.ibm.dtfj.corereaders.zos.le.Dll
This class represents a DLL (Dynamically Linked Library).
-
Constructor Summary
ConstructorDescriptionDll
(long address, AddressSpace space) Constructs a new Dll given the address of the DLCB (DLL Control Block) structure. -
Method Summary
Modifier and TypeMethodDescriptionstatic void
addFunction
(AddressSpace space, String name, DllFunction function) Add the givenDllFunction
to the set of functions for this AddressSpace.static DllFunction
getFunction
(AddressSpace space, String name) From the given AddressSpace returns the namedDllFunction
(or null if it can't be found).getFunction
(String name) Returns the namedDllFunction
(or null if it can't be found).Returns an array of theDllFunction
s belonging to this DLLlong
Returns the load address for this DLL.getName()
Returns the name of this DLL.getNext()
Returns the next Dll in the chain (or null if none).getVariable
(String name) Returns the namedDllVariable
(or null if it can't be found).Returns an array of theDllVariable
s belonging to this DLLlong
getWsa()
Returns the address of the WSA (Writable Static Area) for this DLL.
-
Constructor Details
-
Dll
Constructs a new Dll given the address of the DLCB (DLL Control Block) structure. The normal way for a user to get hold of an instance though would be viaEdb.getFirstDll()
.
-
-
Method Details
-
getName
Returns the name of this DLL.- Throws:
IOException
-
getLoadAddress
public long getLoadAddress()Returns the load address for this DLL. -
getWsa
Returns the address of the WSA (Writable Static Area) for this DLL.- Throws:
IOException
-
getNext
Returns the next Dll in the chain (or null if none).- Throws:
IOException
-
getVariable
Returns the namedDllVariable
(or null if it can't be found).- Throws:
IOException
-
getVariables
Returns an array of theDllVariable
s belonging to this DLL- Throws:
IOException
-
getFunction
Returns the namedDllFunction
(or null if it can't be found).- Throws:
IOException
-
getFunctions
Returns an array of theDllFunction
s belonging to this DLL- Throws:
IOException
-
getFunction
From the given AddressSpace returns the namedDllFunction
(or null if it can't be found). This caches previously found functions for speed. Note that this searches all the Dlls and returns the first match it finds so take care if multiple Dlls declare the same name!- Parameters:
space
- the AddressSpace to searchname
- the name of the required function- Throws:
IOException
-
addFunction
Add the givenDllFunction
to the set of functions for this AddressSpace. This can be used to add fake entries, eg seeinvalid reference
com.ibm.dtfj.corereaders.zos.le.FunctionEmulator#recordCalledFunctions
-