Bug 1479: NativeLibrary: Add getNativeLibraryPath() returning queried used native library path, supported throughout DynamicLibraryBundle[Info]

Motivation: It is helpful to retrieve the actually used native library pathname,
since loading a library w/o absolute path but lookup through LD_LIBRARY_PATH
may render it hard for the user to determine which library is used.

+++

+++

Windows implementation simply can use GetModuleFileNameA() with the native library handle.

POSIX implementation may utilize a symbol-name to retrieve its address within the
loading native library used to retrieved the library information
via dladdr().

To support this feature throughout DynamicLibraryBundle and DynamicLibraryBundleInfo,
the custom DynamicLibraryBundleInfo specializations shall provide
optional symbol-names per each tool-library-name for the POSIX implementation,
see above.

public interface DynamicLibraryBundleInfo {

...

/**
 * Returns optional list of optional symbol names per {@link #getToolLibNames()}
 * in same order for an OS which requires the symbol's address to retrieve
 * the path of the containing library.
 */
public List<String> getSymbolForToolLibPath();

...

}

1 files changed, 13 insertions, 0 deletions

diff --git a/src/java/jogamp/common/os/DynamicLinkerImpl.java b/src/java/jogamp/common/os/DynamicLinkerImpl.java
index 5ce94c1..13b08d7 100644
--- a/src/java/jogamp/common/os/DynamicLinkerImpl.java
+++ b/src/java/jogamp/common/os/DynamicLinkerImpl.java
@@ -45,6 +45,7 @@ import com.jogamp.common.util.SecurityUtil;
   /**
    * @throws SecurityException if user is not granted global access
    */
+  @Override
   public final void claimAllLinkPermission() throws SecurityException {
       synchronized( secSync ) {
           allLinkPermissionGranted = true;
@@ -54,6 +55,7 @@ import com.jogamp.common.util.SecurityUtil;
   /**
    * @throws SecurityException if user is not granted global access
    */
+  @Override
   public final void releaseAllLinkPermission() throws SecurityException {
       synchronized( secSync ) {
           allLinkPermissionGranted = false;
@@ -120,6 +122,17 @@ import com.jogamp.common.util.SecurityUtil;
   protected abstract long openLibraryLocalImpl(final String pathname) throws SecurityException;
 
   @Override
+  public final String lookupLibraryPathname(final long libraryHandle, final String symbolName) throws SecurityException {
+    checkLinkPermission(libraryHandle);
+    final String fname = lookupLibraryPathnameImpl(libraryHandle, symbolName);
+    if(DEBUG_LOOKUP) {
+        System.err.println("DynamicLinkerImpl.lookupLibraryPathname(0x"+Long.toHexString(libraryHandle)+", "+symbolName+") -> '"+fname+"'");
+    }
+    return fname;
+  }
+  protected abstract String lookupLibraryPathnameImpl(final long libraryHandle, String symbolName) throws SecurityException;
+
+  @Override
   public final long lookupSymbolGlobal(final String symbolName) throws SecurityException {
     checkAllLinkPermission();
     final long addr = lookupSymbolGlobalImpl(symbolName);