dlsetlibpath.3c (2010 09)

dlsetlibpath(3C) dlsetlibpath(3C)

EXAMPLES

The following example illustrates the use of

dlsetlibpath() to set the dynamic search path and dis-

able other search paths. For simplicity, error checking has been omitted.

#include <dlfcn.h>

int main() {

void *handle;

int status;

int flags;

/* Set dynamic search path and disable the embedded

* path and the standard library directory.

flags = RTLD_FLAG_DISABLE_EMBEDDED_PATH |

RTLD_FLAG_DISABLE_STD_PATH;

status = dlsetlibpath("/opt/lib:/opt/usr/lib", flags);

/* Call dlopen to load a library using the dynamic

* search path.

handle = dlopen("mylib.so", RTLD_LAZY);

/* Remove the dynamic search path and reenable all

* disabled search paths.

status = dlsetlibpath(NULL, 0);

}

RETURN VALUE

If successful,

dlsetlibpath()

returns 0, otherwise a non-0 value is returned. More detailed diagnos-

tic information is available through

dlerror() or dlerrno().

ERRORS

dlsetlibpath() fails, a subsequent call to

dlerrno() returns one of the following values:

[RTLD_ERR_NO_MEMORY] Cannot allocate dynamic memory.

[RTLD_ERR_CANT_APPLY_RELOC]

Failed to apply relocation while resolving call to

dlsetlib-

path().

[RTLD_ERR_SIGINHIBIT_FAILED]

siginhibit call failed on entry to dlsetlibpath()

[RTLD_ERR_SIGENABLE_FAILED]

sigenable call failed on exit from dlsetlibpath().

[RTLD_ERR_SETCANCELSTATE_FAILED]

__thread_setcancelstate failed on entry to or exit from

dlsetlibpath().

[RTLD_ERR_INV_DLSETLIBPATH_ARGUMENT]

Invalid argument in call to

dlsetlibpath().