Package org.lwjgl.system.linux

Class DynamicLinkLoader

java.lang.Object

org.lwjgl.system.linux.DynamicLinkLoader

public class DynamicLinkLoader
extends java.lang.Object

Native bindings to <dlfcn.h>.

Field Summary

Fields

Modifier and Type	Field	Description
static int	RTLD_BINDING_MASK RTLD_DEEPBIND	The mode argument to dlopen(java.nio.ByteBuffer, int) contains one of the following.
static int	RTLD_GLOBAL	If the following bit is set in the mode argument to dlopen(java.nio.ByteBuffer, int), the symbols of the loaded object and its dependencies are made visible as if the object were linked directly into the program.
static int	RTLD_LAZY	The mode argument to dlopen(java.nio.ByteBuffer, int) contains one of the following.
static int	RTLD_LOCAL	Unix98 demands the following flag which is the inverse to RTLD_GLOBAL.
static int	RTLD_NODELETE	Do not delete object when closed.
static int	RTLD_NOLOAD RTLD_NOW	The mode argument to dlopen(java.nio.ByteBuffer, int) contains one of the following.

Method Summary

Modifier and Type	Method	Description
static int	dlclose(long handle)	Decrements the reference count on the dynamic library handle handle.
static java.lang.String	dlerror()	Returns a human readable string describing the most recent error that occurred from dlopen(java.nio.ByteBuffer, int), dlsym(long, java.nio.ByteBuffer) or dlclose(long) since the last call to dlerror().
static long	dlopen(java.lang.CharSequence filename, int mode)	Loads the dynamic library file named by the null-terminated string filename and returns an opaque "handle" for the dynamic library.
static long	dlopen(java.nio.ByteBuffer filename, int mode)	Loads the dynamic library file named by the null-terminated string filename and returns an opaque "handle" for the dynamic library.
static long	dlsym(long handle, java.lang.CharSequence name)	Takes a "handle" of a dynamic library returned by dlopen(java.nio.ByteBuffer, int) and the null-terminated symbol name, returning the address where that symbol is loaded into memory.
static long	dlsym(long handle, java.nio.ByteBuffer name)	Takes a "handle" of a dynamic library returned by dlopen(java.nio.ByteBuffer, int) and the null-terminated symbol name, returning the address where that symbol is loaded into memory.
static int	ndlclose(long handle)	Unsafe version of: dlclose(long)
static long	ndlerror()	Unsafe version of: dlerror()
static long	ndlopen(long filename, int mode)	Unsafe version of: dlopen(java.nio.ByteBuffer, int)
static long	ndlsym(long handle, long name)	Unsafe version of: dlsym(long, java.nio.ByteBuffer)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

RTLD_LAZY, RTLD_NOW, RTLD_BINDING_MASK, RTLD_NOLOAD, RTLD_DEEPBIND

The mode argument to dlopen(java.nio.ByteBuffer, int) contains one of the following.

RTLD_GLOBAL

If the following bit is set in the mode argument to dlopen(java.nio.ByteBuffer, int), the symbols of the loaded object and its dependencies are made visible as if the object were linked directly into the program.

RTLD_LOCAL

Unix98 demands the following flag which is the inverse to RTLD_GLOBAL. The implementation does this by default and so we can define the value to zero.

RTLD_NODELETE

Do not delete object when closed.

Method Detail

ndlopen

public static long ndlopen(long filename,
                           int mode)

Unsafe version of: dlopen(java.nio.ByteBuffer, int)

dlopen

public static long dlopen(@Nullable
                          java.nio.ByteBuffer filename,
                          int mode)

public static long dlopen(@Nullable
                          java.lang.CharSequence filename,
                          int mode)

Loads the dynamic library file named by the null-terminated string filename and returns an opaque "handle" for the dynamic library. If filename is NULL, then the returned handle is for the main program.

Parameters:

filename - the name of the dynamic library to open, or NULL

mode - a bitfield. One or more of:

RTLD_LAZY	RTLD_NOW	RTLD_BINDING_MASK	RTLD_NOLOAD	RTLD_DEEPBIND	RTLD_GLOBAL
RTLD_LOCAL	RTLD_NODELETE

ndlerror

public static long ndlerror()

Unsafe version of: dlerror()

dlerror

@Nullable
public static java.lang.String dlerror()

Returns a human readable string describing the most recent error that occurred from dlopen(java.nio.ByteBuffer, int), dlsym(long, java.nio.ByteBuffer) or dlclose(long) since the last call to dlerror(). It returns NULL if no errors have occurred since initialization or since it was last called.

ndlsym

public static long ndlsym(long handle,
                          long name)

Unsafe version of: dlsym(long, java.nio.ByteBuffer)

dlsym

public static long dlsym(long handle,
                         java.nio.ByteBuffer name)

public static long dlsym(long handle,
                         java.lang.CharSequence name)

Takes a "handle" of a dynamic library returned by dlopen(java.nio.ByteBuffer, int) and the null-terminated symbol name, returning the address where that symbol is loaded into memory. If the symbol is not found, in the specified library or any of the libraries that were automatically loaded by dlopen(java.nio.ByteBuffer, int) when that library was loaded, dlsym() returns NULL.

Parameters:

handle - the dynamic library handle

name - the symbol name

ndlclose

public static int ndlclose(long handle)

Unsafe version of: dlclose(long)

dlclose

public static int dlclose(long handle)

Decrements the reference count on the dynamic library handle handle. If the reference count drops to zero and no other loaded libraries use symbols in it, then the dynamic library is unloaded.

Parameters:

handle - the dynamic library to close