Interface DynamicLinker

Method Details

• claimAllLinkPermission

  void claimAllLinkPermission() throws SecurityException

  Throws:

  SecurityException - if user is not granted global access

• releaseAllLinkPermission

  void releaseAllLinkPermission() throws SecurityException

  Throws:

  SecurityException - if user is not granted global access

• openLibraryGlobal

  long openLibraryGlobal(String pathname, boolean debug) throws SecurityException

  If a SecurityManager is installed, user needs link permissions for the named library.

  Opens the named library, allowing system wide access for other users.

  Parameters:

  pathname - the full pathname for the library to open

  debug - set to true to enable debugging

  Returns:

  the library handle, maybe 0 if not found.

  Throws:

  SecurityException - if user is not granted access for the named library.

• openLibraryLocal

  long openLibraryLocal(String pathname, boolean debug) throws SecurityException

  If a SecurityManager is installed, user needs link permissions for the named library.

  Opens the named library, restricting access to this process.

  Parameters:

  pathname - the full pathname for the library to open

  debug - set to true to enable debugging

  Returns:

  the library handle, maybe 0 if not found.

  Throws:

  SecurityException - if user is not granted access for the named library.

• lookupSymbolGlobal

  long lookupSymbolGlobal(String symbolName) throws SecurityException

  If a SecurityManager is installed, user needs link permissions for all libraries, i.e. for new RuntimePermission("loadLibrary.*");!

  Parameters:

  symbolName - global symbol name to lookup up system wide.

  Returns:

  the library handle, maybe 0 if not found.

  Throws:

  SecurityException - if user is not granted access for all libraries.

• lookupSymbol

  long lookupSymbol(long libraryHandle, String symbolName) throws SecurityException, IllegalArgumentException

  Security checks are implicit by previous call of openLibraryLocal(String, boolean) or openLibraryGlobal(String, boolean) retrieving the librarHandle.

  Parameters:

  libraryHandle - a library handle previously retrieved via openLibraryLocal(String, boolean) or openLibraryGlobal(String, boolean).

  symbolName - global symbol name to lookup up system wide.

  Returns:

  the library handle, maybe 0 if not found.

  Throws:

  IllegalArgumentException - in case case libraryHandle is unknown.

  SecurityException - if user is not granted access for the given library handle

• closeLibrary

  void closeLibrary(long libraryHandle, boolean debug) throws SecurityException, IllegalArgumentException

  Security checks are implicit by previous call of openLibraryLocal(String, boolean) or openLibraryGlobal(String, boolean) retrieving the librarHandle.

  Parameters:

  libraryHandle - a library handle previously retrieved via openLibraryLocal(String, boolean) or openLibraryGlobal(String, boolean).

  debug - set to true to enable debugging

  Throws:

  IllegalArgumentException - in case case libraryHandle is unknown.

  SecurityException - if user is not granted access for the given library handle

• getLastError

  String getLastError()

  Returns a string containing the last error. Maybe called for debuging purposed if any method fails.

  Returns:

  error string, maybe null. A null or non-null value has no semantics.