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

d
dlopen_ia(3C) dlopen_ia(3C)
(Integrity Systems Only)
RETURN VALUE
If file cannot be found, cannot be opened for reading, is not a shared object, or if an error occurs during the
process of loading file or relocating its symbolic references,
dlopen() returns NULL. More detailed diag-
nostic information is available through
dlerror() or dlerrno()
.
ERRORS
If
dlopen() or dlopene() fails, a subsequent call to
dlerrno() returns one of the following values:
[RTLD_ERR_ARCH_EXT_NOT_SUPPORTED]
Cannot load library because required extensions not present in the
hardware.
[RTLD_ERR_BAD_ABI1] 64-bit program found a 32-bit shared library.
[RTLD_ERR_BAD_ABI2] 32-bit program found a 64-bit shared library.
[RTLD_ERR_BAD_DLL] Not a valid library.
[RTLD_ERR_BAD_DLL_ALIGNMENT]
Invalid library: bad alignment.
[RTLD_ERR_BAD_DLL_BAD_MACHINE]
Invalid library: bad machine type.
[RTLD_ERR_BAD_DLL_BAD_OBJFILE]
Invalid library: bad object file type.
[RTLD_ERR_BAD_DLL_BAD_PHDR]
Invalid library: program header not found.
[RTLD_ERR_BAD_DLL_MAGIC_NUM]
Invalid library: bad magic number.
[RTLD_ERR_BAD_DLL_NO_SYMTAB]
Invalid library: symbol table missing.
[RTLD_ERR_BAD_DLL_SEGMENT_COUNT]
Library needs a shared fixed address but has multiple data segments.
[RTLD_ERR_BAD_ELF_VER] Unknown elf version in library.
[RTLD_ERR_BAD_RELOC] Unknown relocation type.
[RTLD_ERR_CANT_APPLY_RELOC]
Cannot apply relocation in library.
[RTLD_ERR_CODE_UNSAT] Unsatisfied code symbol in library.
[RTLD_ERR_DATA_UNSAT] Unsatisfied data symbol in library.
[RTLD_ERR_DLDD_COMM_FAILURE]
Library needs a shared fixed address but unable to obtain it from
dldd.
[RTLD_ERR_DLOPEN_BAD_FLAGS]
Invalid flags for
dlopen().
[RTLD_ERR_DLOPEN_TLS_LIB]
Cannot dlopen() library because it contains TLS data.
[RTLD_ERR_DLOPENE_BAD_ADDR]
Invalid load address for segment (dlopene() only).
[RTLD_ERR_DLOPENE_NO_EXEC_PERM]
Shared library missing execution permission (dlopene() only).
[RTLD_ERR_DYN_FILTER_STLS_REF]
Library contains a static TLS reference to a symbol defined in a dynami-
cally loaded library.
[RTLD_ERR_FILTER_TLS] Cannot open filtered library: TLS size exceeds size recorded in filter.
[RTLD_ERR_INTERNAL_ERROR]
Internal error encountered in dld.
308 Hewlett-Packard Company − 4 − HP-UX 11i Version 3: February 2007