Low level secure dynamic linker access.
More...
|
| void | claimAllLinkPermission () throws SecurityException |
| |
| void | releaseAllLinkPermission () throws SecurityException |
| |
| long | openLibraryGlobal (LibPath libpath, boolean debug) throws SecurityException |
| | If a SecurityManager is installed, user needs link permissions for the named library. More...
|
| |
| long | openLibraryLocal (LibPath libpath, boolean debug) throws SecurityException |
| | If a SecurityManager is installed, user needs link permissions for the named library. More...
|
| |
| String | lookupLibraryPathname (long libraryHandle, String symbolName) throws SecurityException |
| | Security checks are implicit by previous call of openLibraryLocal(String, boolean) or openLibraryGlobal(String, boolean) retrieving the librarHandle. More...
|
| |
| long | lookupSymbolGlobal (String symbolName) throws SecurityException |
| | If a SecurityManager is installed, user needs link permissions for all libraries, i.e. More...
|
| |
| 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. More...
|
| |
| 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. More...
|
| |
| String | getLastError () |
| | Returns a string containing the last error. More...
|
| |
|
| static final boolean | DEBUG = NativeLibrary.DEBUG |
| |
| static final boolean | DEBUG_LOOKUP = NativeLibrary.DEBUG_LOOKUP |
| |
Low level secure dynamic linker access.
Definition at line 34 of file DynamicLinker.java.
◆ claimAllLinkPermission()
| void com.jogamp.common.os.DynamicLinker.claimAllLinkPermission |
( |
| ) |
throws SecurityException |
- Exceptions
-
| SecurityException | if user is not granted global access |
◆ closeLibrary()
| void com.jogamp.common.os.DynamicLinker.closeLibrary |
( |
long |
libraryHandle, |
|
|
boolean |
debug |
|
) |
| throws SecurityException, IllegalArgumentException |
◆ getLastError()
| String com.jogamp.common.os.DynamicLinker.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.
◆ lookupLibraryPathname()
| String com.jogamp.common.os.DynamicLinker.lookupLibraryPathname |
( |
long |
libraryHandle, |
|
|
String |
symbolName |
|
) |
| throws SecurityException |
Security checks are implicit by previous call of openLibraryLocal(String, boolean) or openLibraryGlobal(String, boolean) retrieving the librarHandle.
- Parameters
-
- Returns
- the library pathname if found and supported by OS or
null.
- Exceptions
-
| IllegalArgumentException | in case case libraryHandle is unknown. |
| SecurityException | if user is not granted access for the given library handle |
◆ lookupSymbol()
| long com.jogamp.common.os.DynamicLinker.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
-
- Returns
- the library handle, maybe 0 if not found.
- Exceptions
-
| IllegalArgumentException | in case case libraryHandle is unknown. |
| SecurityException | if user is not granted access for the given library handle |
◆ lookupSymbolGlobal()
| long com.jogamp.common.os.DynamicLinker.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.
- Exceptions
-
| SecurityException | if user is not granted access for all libraries. |
◆ openLibraryGlobal()
| long com.jogamp.common.os.DynamicLinker.openLibraryGlobal |
( |
LibPath |
libpath, |
|
|
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
-
| libpath | the LibPath for the library to open |
| debug | set to true to enable debugging |
- Returns
- the library handle, maybe 0 if not found.
- Exceptions
-
| SecurityException | if user is not granted access for the named library. |
◆ openLibraryLocal()
| long com.jogamp.common.os.DynamicLinker.openLibraryLocal |
( |
LibPath |
libpath, |
|
|
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
-
| libpath | the LibPath for the library to open |
| debug | set to true to enable debugging |
- Returns
- the library handle, maybe 0 if not found.
- Exceptions
-
| SecurityException | if user is not granted access for the named library. |
◆ releaseAllLinkPermission()
| void com.jogamp.common.os.DynamicLinker.releaseAllLinkPermission |
( |
| ) |
throws SecurityException |
- Exceptions
-
| SecurityException | if user is not granted global access |
◆ DEBUG
| final boolean com.jogamp.common.os.DynamicLinker.DEBUG = NativeLibrary.DEBUG |
|
static |
◆ DEBUG_LOOKUP
| final boolean com.jogamp.common.os.DynamicLinker.DEBUG_LOOKUP = NativeLibrary.DEBUG_LOOKUP |
|
static |
The documentation for this interface was generated from the following file: