Manualshelf

dlgetmodinfo.3c (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
12
d
dlgetmodinfo(3C) dlgetmodinfo(3C)
NAME
dlgetmodinfo() - retrieve information about a loaded module (program or shared library)
SYNOPSIS
cc [flag... ] file ...
-ldl [library ] ...
#include <dlfcn.h>
uint64_t dlgetmodinfo(int index,
struct load_module_desc *desc,
size_t desc_size,
void *(*read_tgt_mem)(void* buffer,
uint64_t ptr,
size_t bufsiz,
int ident),
int ident_parm,
uint64_t load_map_parm);
Multithread Usage
Thread safe in libdl.sl but not in libxpdl.sl
.
DESCRIPTION
dlgetmodinfo() is one of a family of routines that give the user direct access to the dynamic linking
facilities. dlgetmodinfo() retrieves information about a load module from an index specifying the
placement of the load module in the dynamic loader’s search list. Unlike
dlget(), dlgetmodinfo()
can retrieve information about a load module in another process. index of -1 requests information about
the dynamic loader. An index of -2 requests information about the program file itself. The dlgetmo-
dinfo() routine fills the load_module_desc with information from the matching load module.
The desc , desc_size , read_tgt_mem , ident_parm , and load_map_parm parameters are identical to those
for
dlmodinfo(). See dlmodinfo (3C).
RETURN VALUE
If successful,
dlgetmodinfo() returns a handle for the shared library as defined by the return value
from
dlopen(). NULL is returned otherwise. The return values are type-converted to
uint64_t.
ERRORS
If
dlgetmodinfo() fails, a subsequent call to
dlerrno() returns one of the following values:
[RTLD_ERR_CANT_APPLY_RELOC] Cannot apply relocation in library.
[RTLD_ERR_INV_ADDRESS] Invalid address.
[RTLD_ERR_INV_BUFFER_ARGUMENT] Invalid descriptor argument.
[RTLD_ERR_INV_DESC_VERSION] Invalid descriptor version.
[RTLD_ERR_INV_LIB_INDEX] Invalid load module index.
[RTLD_ERR_NO_MEMORY] Out of memory.
[RTLD_ERR_READ_TGT_MEM_FAILED]
read_tgt_mem failed in reading target memory.
[RTLD_ERR_SETCANCELSTATE_FAILED]
__thread_setcancelstate
failed on entry to or
exit from
dlgetmodinfo().
[RTLD_ERR_SIGENABLE_FAILED]
sigenable failed on exit from dlgetmodinfo()
.
[RTLD_ERR_SIGINHIBIT_FAILED]
siginhibit failed on entry to
dlgetmodinfo().
AUTHOR
dlgetmodinfo() was developed by HP.
SEE ALSO
System Tools
exec(2) System loader.
ld(1) Invokes the link editor.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)