HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

321

322

323

324

325

326

327

328

329

330

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 diagnostic

information is available through

dlerror() or dlerrno() .

ERRORS

If 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

dlsetlibpath()

[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().