Top Description Fields Methods
com.jogamp.common.os

public Interface DynamicLinker

Known Direct Implementers
jogamp.common.os.DynamicLinkerImpl
Low level secure dynamic linker access.

Field Summary

Modifier and TypeField and Description
public static final boolean
DEBUG

public static final boolean
DEBUG_LOOKUP

Method Summary

Modifier and TypeMethod and Description
public void
claimAllLinkPermission()

public void
closeLibrary(long
a library handle previously retrieved via openLibraryLocal(String, boolean) or openLibraryGlobal(String, boolean).
libraryHandle, boolean
set to true to enable debugging
debug)

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

public String

Returns:

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

Returns a string containing the last error.

public long

Returns:

the library handle, maybe 0 if not found.
lookupSymbol(long
a library handle previously retrieved via openLibraryLocal(String, boolean) or openLibraryGlobal(String, boolean).
libraryHandle, String
global symbol name to lookup up system wide.
symbolName)

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

public long

Returns:

the library handle, maybe 0 if not found.
lookupSymbolGlobal(String
global symbol name to lookup up system wide.
symbolName)

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

public long

Returns:

the library handle, maybe 0 if not found.
openLibraryGlobal(String
the full pathname for the library to open
pathname, boolean
set to true to enable debugging
debug)

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

public long

Returns:

the library handle, maybe 0 if not found.
openLibraryLocal(String
the full pathname for the library to open
pathname, boolean
set to true to enable debugging
debug)

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

public void
releaseAllLinkPermission()

Field Detail

DEBUGback to summary
public static final boolean DEBUG
DEBUG_LOOKUPback to summary
public static final boolean DEBUG_LOOKUP

Method Detail

claimAllLinkPermissionback to summary
public void claimAllLinkPermission() throws SecurityException
Exceptions
SecurityException:
if user is not granted global access
closeLibraryback to summary
public 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:long

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

debug:boolean

set to true to enable debugging

Exceptions
SecurityException:
if user is not granted access for the given library handle
IllegalArgumentException:
in case case libraryHandle is unknown.
getLastErrorback to summary
public String getLastError()

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

Returns:String

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

lookupSymbolback to summary
public 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:long

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

symbolName:String

global symbol name to lookup up system wide.

Returns:long

the library handle, maybe 0 if not found.

Exceptions
SecurityException:
if user is not granted access for the given library handle
IllegalArgumentException:
in case case libraryHandle is unknown.
lookupSymbolGlobalback to summary
public 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:String

global symbol name to lookup up system wide.

Returns:long

the library handle, maybe 0 if not found.

Exceptions
SecurityException:
if user is not granted access for all libraries.
openLibraryGlobalback to summary
public 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:String

the full pathname for the library to open

debug:boolean

set to true to enable debugging

Returns:long

the library handle, maybe 0 if not found.

Exceptions
SecurityException:
if user is not granted access for the named library.
openLibraryLocalback to summary
public 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:String

the full pathname for the library to open

debug:boolean

set to true to enable debugging

Returns:long

the library handle, maybe 0 if not found.

Exceptions
SecurityException:
if user is not granted access for the named library.
releaseAllLinkPermissionback to summary
public void releaseAllLinkPermission() throws SecurityException
Exceptions
SecurityException:
if user is not granted global access