com.oracle.svm.core.posix.headers

Class Dlfcn

java.lang.Object

com.oracle.svm.core.posix.headers.Dlfcn

Direct Known Subclasses:

LinuxDlfcn

public class Dlfcn
extends Object

Definitions manually translated from the C header file dlfcn.h.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Dlfcn.Dl_info Structure containing information about object searched using `dladdr'.

Constructor Summary

Constructors

Constructor and Description
Dlfcn()

Method Summary

Modifier and Type	Method and Description
static int	dladdr(org.graalvm.word.WordBase address, Dlfcn.Dl_info info) Fill in *INFO with the following information about ADDRESS.
static int	dlclose(org.graalvm.word.PointerBase handle) Unmap and close a shared object opened by `dlopen'.
static org.graalvm.nativeimage.c.type.CCharPointer	dlerror() When any of the above functions fails, call this function to return a string describing the error.
static <T extends org.graalvm.word.PointerBase> T	dlmopen(long nsid, org.graalvm.nativeimage.c.type.CCharPointer file, int mode) Like `dlopen', but request object to be allocated in a new namespace.
static org.graalvm.word.PointerBase	dlopen(org.graalvm.nativeimage.c.type.CCharPointer file, int mode) Open the shared object FILE and map it in; return a handle that can be passed to `dlsym' to get symbol values from it.
static <T extends org.graalvm.word.PointerBase> T	dlsym(org.graalvm.word.PointerBase handle, org.graalvm.nativeimage.c.type.CCharPointer name) Find the run-time address in the shared object HANDLE refers to of the symbol called NAME.
static <T extends org.graalvm.word.PointerBase> T	dlvsym(org.graalvm.word.PointerBase handle, org.graalvm.nativeimage.c.type.CCharPointer name, org.graalvm.nativeimage.c.type.CCharPointer version) Find the run-time address in the shared object HANDLE refers to of the symbol called NAME with VERSION.
static org.graalvm.word.PointerBase	RTLD_DEFAULT() If the first argument to `dlsym' or `dlvsym' is set to RTLD_DEFAULT the run-time address of the symbol called NAME in the global scope is returned.
static int	RTLD_GLOBAL() If the following bit is set in the MODE argument to `dlopen', 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() Lazy function call binding.
static int	RTLD_LOCAL() Unix98 demands the following flag which is the inverse to RTLD_GLOBAL.
static org.graalvm.word.PointerBase	RTLD_NEXT() If the first argument of `dlsym' or `dlvsym' is set to RTLD_NEXT the run-time address of the symbol called NAME in the next shared object is returned.
static int	RTLD_NODELETE() Do not delete object when closed.
static int	RTLD_NOLOAD() Do not load the object.
static int	RTLD_NOW() Immediate function call binding.

Methods inherited from class java.lang.Object

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

Constructor Detail

Dlfcn

public Dlfcn()

Method Detail

RTLD_LAZY

public static int RTLD_LAZY()

Lazy function call binding.

RTLD_NOW

public static int RTLD_NOW()

Immediate function call binding.

RTLD_NOLOAD

public static int RTLD_NOLOAD()

Do not load the object.

RTLD_GLOBAL

public static int RTLD_GLOBAL()

If the following bit is set in the MODE argument to `dlopen', the symbols of the loaded object and its dependencies are made visible as if the object were linked directly into the program.

RTLD_LOCAL

public static int 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

public static int RTLD_NODELETE()

Do not delete object when closed.

RTLD_NEXT

public static org.graalvm.word.PointerBase RTLD_NEXT()

If the first argument of `dlsym' or `dlvsym' is set to RTLD_NEXT the run-time address of the symbol called NAME in the next shared object is returned. The "next" relation is defined by the order the shared objects were loaded.

RTLD_DEFAULT

public static org.graalvm.word.PointerBase RTLD_DEFAULT()

If the first argument to `dlsym' or `dlvsym' is set to RTLD_DEFAULT the run-time address of the symbol called NAME in the global scope is returned.

dlopen

public static org.graalvm.word.PointerBase dlopen(org.graalvm.nativeimage.c.type.CCharPointer file,
                                                  int mode)

Open the shared object FILE and map it in; return a handle that can be passed to `dlsym' to get symbol values from it.

dlclose

public static int dlclose(org.graalvm.word.PointerBase handle)

Unmap and close a shared object opened by `dlopen'. The handle cannot be used again after calling `dlclose'.

dlsym

public static <T extends org.graalvm.word.PointerBase> T dlsym(org.graalvm.word.PointerBase handle,
                                                               org.graalvm.nativeimage.c.type.CCharPointer name)

Find the run-time address in the shared object HANDLE refers to of the symbol called NAME.

dlmopen

public static <T extends org.graalvm.word.PointerBase> T dlmopen(long nsid,
                                                                 org.graalvm.nativeimage.c.type.CCharPointer file,
                                                                 int mode)

Like `dlopen', but request object to be allocated in a new namespace.

dlvsym

public static <T extends org.graalvm.word.PointerBase> T dlvsym(org.graalvm.word.PointerBase handle,
                                                                org.graalvm.nativeimage.c.type.CCharPointer name,
                                                                org.graalvm.nativeimage.c.type.CCharPointer version)

Find the run-time address in the shared object HANDLE refers to of the symbol called NAME with VERSION.

dlerror

public static org.graalvm.nativeimage.c.type.CCharPointer dlerror()

When any of the above functions fails, call this function to return a string describing the error. Each call resets the error string so that a following call returns null.

dladdr

public static int dladdr(org.graalvm.word.WordBase address,
                         Dlfcn.Dl_info info)

Fill in *INFO with the following information about ADDRESS. Returns 0 iff no shared object's segments contain that address.