Library Loading

When JNA classes are loaded, the native shared library (jnidispatch) is loaded as well. An attempt is made to load it from the any paths defined in jna.boot.library.path (if defined), then the system library path using System.loadLibrary(java.lang.String) , unless jna.nosys=true . If not found, the appropriate library will be extracted from the class path (into a temporary directory if found within a jar file) and loaded from there, unless jna.noclasspath=true . If your system has additional security constraints regarding execution or load of files (SELinux, for example), you should probably install the native library in an accessible location and configure your system accordingly, rather than relying on JNA to extract the library from its own jar file.

To avoid the automatic unpacking (in situations where you want to force a failure if the JNA native library is not properly installed on the system), set the system property jna.nounpack=true .

While this class and its corresponding native library are loaded, the system property jna.loaded will be set. The property will be cleared when native support has been unloaded (i.e. the Native class and its underlying native support has been GC'd).

NOTE: all native functions are provided within this class to ensure that all other JNA-provided classes and objects are GC'd and/or finalized/disposed before this class is disposed and/or removed from memory (most notably Memory and any other class which by default frees its resources in a finalizer).

Native Library Loading

If not supported by the underlying platform, this setting will have no effect.

NOTE: On platforms which support signals (non-Windows), JNA uses signals to trap errors. This may interfere with the JVM's own use of signals. When protected mode is enabled, you should make use of the jsig library, if available (see Signal Chaining ). In short, set the environment variable LD_PRELOAD to the path to libjsig.so in your JRE lib directory (usually ${java.home}/lib/${os.arch}/libjsig.so) before launching your Java application.

Usage note : This function assumes, that buf holds a char array. This means only single-byte encodings are supported.

Usage note : This function assumes, that buf holds a char array. This means only single-byte encodings are supported.

If name is null, attempts to map onto the current process. Native libraries loaded via this method may be found in several locations .

getWebStartLibraryPath

public static java.lang.String getWebStartLibraryPath(java.lang.String libName)

static java.io.File getTempDir()
                        throws java.io.IOException

static void removeTemporaryFiles()
                          throws java.io.IOException

getNativeSize

public static int getNativeSize(java.lang.Class<?> type,
                                java.lang.Object value)

getNativeSize

public static int getNativeSize(java.lang.Class<?> cls)

setCallbackExceptionHandler

public static void setCallbackExceptionHandler(Callback.UncaughtExceptionHandler eh)

getCallbackExceptionHandler

public static Callback.UncaughtExceptionHandler getCallbackExceptionHandler()

register

public static void register(java.lang.String libName)

register

public static void register(NativeLibrary lib)

findDirectMappedClass

static java.lang.Class<?> findDirectMappedClass(java.lang.Class<?> cls)

getCallingClass

static java.lang.Class<?> getCallingClass()

setCallbackThreadInitializer

public static void setCallbackThreadInitializer(Callback cb,
                                                CallbackThreadInitializer initializer)

unregister

public static void unregister()

unregister

public static void unregister(java.lang.Class<?> cls)

public static void register(java.lang.Class<?> cls,
                            java.lang.String libName)

public static void register(java.lang.Class<?> cls,
                            NativeLibrary lib)

createNativeCallback

static long createNativeCallback(Callback callback,
                                 java.lang.reflect.Method method,
                                 java.lang.Class<?>[] parameterTypes,
                                 java.lang.Class<?> returnType,
                                 int callingConvention,
                                 int flags,
                                 java.lang.String encoding)

static long open(java.lang.String name,
                 int flags)

getDirectByteBuffer

static java.nio.ByteBuffer getDirectByteBuffer(Pointer pointer,
                                               long addr,
                                               long offset,
                                               long length)

detach

public static void detach(boolean detach)