Modifier and Type	Class and Description
pack-priv static class	DynamicLinkerImpl.LibRef

Modifier and Type	Field and Description
private boolean	allLinkPermissionGranted
private static final LongObjectHashMap	libHandle2Name
private final Object	secSync

Access	Constructor and Description
pack-priv	DynamicLinkerImpl()

Method Summary

Modifier and Type	Method and Description
private final void	checkAllLinkPermission()
private final void	checkLinkPermission(final String pathname)
private final void	checkLinkPermission(final long libraryHandle)
public final void	claimAllLinkPermission() Implements com.jogamp.common.os.DynamicLinker.claimAllLinkPermission.
public final void	closeLibrary(final long a library handle previously retrieved via `openLibraryLocal(String, boolean)` or `openLibraryGlobal(String, boolean)`. libraryHandle, final boolean set to true to enable debugging debug) Implements com.jogamp.common.os.DynamicLinker.closeLibrary. Security checks are implicit by previous call of `openLibraryLocal(String, boolean)` or `openLibraryGlobal(String, boolean)` retrieving the `librarHandle`.
protected abstract void	closeLibraryImpl(final long libraryHandle)
private final DynamicLinkerImpl.LibRef	decrLibRefCount(final long handle)
private final DynamicLinkerImpl.LibRef	getLibRef(final long handle)
private final DynamicLinkerImpl.LibRef	incrLibRefCount(final long handle, final String libName)
public final long	lookupSymbol(final long a library handle previously retrieved via `openLibraryLocal(String, boolean)` or `openLibraryGlobal(String, boolean)`. libraryHandle, final String global symbol name to lookup up system wide. symbolName) Implements com.jogamp.common.os.DynamicLinker.lookupSymbol. Security checks are implicit by previous call of `openLibraryLocal(String, boolean)` or `openLibraryGlobal(String, boolean)` retrieving the `librarHandle`.
public final long	lookupSymbolGlobal(final String global symbol name to lookup up system wide. symbolName) Implements com.jogamp.common.os.DynamicLinker.lookupSymbolGlobal. If a `SecurityManager` is installed, user needs link permissions for all libraries, i.e. for `new RuntimePermission("loadLibrary.*");`!
protected abstract long	lookupSymbolGlobalImpl(final String symbolName)
protected abstract long	lookupSymbolLocalImpl(final long libraryHandle, final String symbolName)
public final long	openLibraryGlobal(final String the full pathname for the library to open pathname, final boolean set to true to enable debugging debug) Implements com.jogamp.common.os.DynamicLinker.openLibraryGlobal. If a `SecurityManager` is installed, user needs link permissions for the named library.
protected abstract long	openLibraryGlobalImpl(final String pathname)
public final long	openLibraryLocal(final String the full pathname for the library to open pathname, final boolean set to true to enable debugging debug) Implements com.jogamp.common.os.DynamicLinker.openLibraryLocal. If a `SecurityManager` is installed, user needs link permissions for the named library.
protected abstract long	openLibraryLocalImpl(final String pathname)
public final void	releaseAllLinkPermission() Implements com.jogamp.common.os.DynamicLinker.releaseAllLinkPermission.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

allLinkPermissionGranted	back to summary
private boolean allLinkPermissionGranted

libHandle2Name	back to summary
private static final LongObjectHashMap libHandle2Name

secSync	back to summary
private final Object secSync

Constructor Detail

DynamicLinkerImpl	back to summary
pack-priv DynamicLinkerImpl()

Method Detail

checkAllLinkPermission	back to summary
private final void checkAllLinkPermission() throws SecurityException

checkLinkPermission	back to summary
private final void checkLinkPermission(final String pathname) throws SecurityException

checkLinkPermission	back to summary
private final void checkLinkPermission(final long libraryHandle) throws SecurityException

claimAllLinkPermission	back to summary
public final void claimAllLinkPermission() throws SecurityException Implements com.jogamp.common.os.DynamicLinker.claimAllLinkPermission. Exceptions SecurityException: if user is not granted global access

claimAllLinkPermission

back to summary

public final void claimAllLinkPermission() throws SecurityException

Implements com.jogamp.common.os.DynamicLinker.claimAllLinkPermission.

Exceptions

SecurityException:: if user is not granted global access

closeLibrary back to summary

closeLibrary	back to summary
public final void closeLibrary(final long libraryHandle, final boolean debug) throws SecurityException, IllegalArgumentException Implements com.jogamp.common.os.DynamicLinker.closeLibrary. Doc from com.jogamp.common.os.DynamicLinker.closeLibrary. 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 Annotations @Override Exceptions SecurityException: if user is not granted access for the given library handle IllegalArgumentException: in case case `libraryHandle` is unknown.

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

Implements com.jogamp.common.os.DynamicLinker.closeLibrary.

Doc from com.jogamp.common.os.DynamicLinker.closeLibrary.

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

Annotations

@Override

Exceptions

SecurityException:: if user is not granted access for the given library handle
IllegalArgumentException:: in case case libraryHandle is unknown.

closeLibraryImpl	back to summary
protected abstract void closeLibraryImpl(final long libraryHandle) throws SecurityException

decrLibRefCount	back to summary
private final DynamicLinkerImpl.LibRef decrLibRefCount(final long handle)

getLibRef	back to summary
private final DynamicLinkerImpl.LibRef getLibRef(final long handle)

incrLibRefCount	back to summary
private final DynamicLinkerImpl.LibRef incrLibRefCount(final long handle, final String libName)

lookupSymbol back to summary

lookupSymbol	back to summary
public final long lookupSymbol(final long libraryHandle, final String symbolName) throws SecurityException, IllegalArgumentException Implements com.jogamp.common.os.DynamicLinker.lookupSymbol. Doc from com.jogamp.common.os.DynamicLinker.lookupSymbol. 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. Annotations @Override Exceptions SecurityException: if user is not granted access for the given library handle IllegalArgumentException: in case case `libraryHandle` is unknown.

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

Implements com.jogamp.common.os.DynamicLinker.lookupSymbol.

Doc from com.jogamp.common.os.DynamicLinker.lookupSymbol.

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.

Annotations

@Override

Exceptions

SecurityException:: if user is not granted access for the given library handle
IllegalArgumentException:: in case case libraryHandle is unknown.

lookupSymbolGlobal back to summary

lookupSymbolGlobal	back to summary
public final long lookupSymbolGlobal(final String symbolName) throws SecurityException Implements com.jogamp.common.os.DynamicLinker.lookupSymbolGlobal. Doc from com.jogamp.common.os.DynamicLinker.lookupSymbolGlobal. 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. Annotations @Override Exceptions SecurityException: if user is not granted access for all libraries.

public final long lookupSymbolGlobal(final String symbolName) throws SecurityException

Implements com.jogamp.common.os.DynamicLinker.lookupSymbolGlobal.

Doc from com.jogamp.common.os.DynamicLinker.lookupSymbolGlobal.

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.

Annotations

@Override

Exceptions

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

lookupSymbolGlobalImpl	back to summary
protected abstract long lookupSymbolGlobalImpl(final String symbolName) throws SecurityException

lookupSymbolLocalImpl	back to summary
protected abstract long lookupSymbolLocalImpl(final long libraryHandle, final String symbolName) throws SecurityException

openLibraryGlobal back to summary

openLibraryGlobal	back to summary
public final long openLibraryGlobal(final String pathname, final boolean debug) throws SecurityException Implements com.jogamp.common.os.DynamicLinker.openLibraryGlobal. Doc from com.jogamp.common.os.DynamicLinker.openLibraryGlobal. 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. Annotations @Override Exceptions SecurityException: if user is not granted access for the named library.

public final long openLibraryGlobal(final String pathname, final boolean debug) throws SecurityException

Implements com.jogamp.common.os.DynamicLinker.openLibraryGlobal.

Doc from com.jogamp.common.os.DynamicLinker.openLibraryGlobal.

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.

Annotations

@Override

Exceptions

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

openLibraryGlobalImpl	back to summary
protected abstract long openLibraryGlobalImpl(final String pathname) throws SecurityException

openLibraryLocal back to summary

openLibraryLocal	back to summary
public final long openLibraryLocal(final String pathname, final boolean debug) throws SecurityException Implements com.jogamp.common.os.DynamicLinker.openLibraryLocal. Doc from com.jogamp.common.os.DynamicLinker.openLibraryLocal. 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. Annotations @Override Exceptions SecurityException: if user is not granted access for the named library.

public final long openLibraryLocal(final String pathname, final boolean debug) throws SecurityException

Implements com.jogamp.common.os.DynamicLinker.openLibraryLocal.

Doc from com.jogamp.common.os.DynamicLinker.openLibraryLocal.

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.

Annotations

@Override

Exceptions

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

openLibraryLocalImpl	back to summary
protected abstract long openLibraryLocalImpl(final String pathname) throws SecurityException

releaseAllLinkPermission	back to summary
public final void releaseAllLinkPermission() throws SecurityException Implements com.jogamp.common.os.DynamicLinker.releaseAllLinkPermission. Exceptions SecurityException: if user is not granted global access

releaseAllLinkPermission

back to summary

public final void releaseAllLinkPermission() throws SecurityException

Implements com.jogamp.common.os.DynamicLinker.releaseAllLinkPermission.

Exceptions

SecurityException:: if user is not granted global access

jogamp.common.os back to summary

pack-priv final Class DynamicLinkerImpl.LibRef

Class Inheritance

extends Object

java.lang.Object
jogamp.common.os.DynamicLinkerImpl.LibRef

Field Summary

Modifier and Type	Field and Description
private final String	name
private int	refCount

Constructor Summary

Access	Constructor and Description
pack-priv	LibRef(final String name)

Method Summary

Modifier and Type	Method and Description
pack-priv final int	decrRefCount()
pack-priv final String	getName()
pack-priv final int	getRefCount()
pack-priv final int	incrRefCount()
public final String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

name	back to summary
private final String name

refCount	back to summary
private int refCount

Constructor Detail

LibRef	back to summary
pack-priv LibRef(final String name)

Method Detail

decrRefCount	back to summary
pack-priv final int decrRefCount()

getName	back to summary
pack-priv final String getName()

getRefCount	back to summary
pack-priv final int getRefCount()

incrRefCount	back to summary
pack-priv final int incrRefCount()

toString	back to summary
public final String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Returns:String a string representation of the object Annotations @Override

toString

back to summary

public final String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object

Annotations