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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

241

242

243

244

245

246

247

248

249

250

dlget(3C) dlget(3C)

NAME

dlget - retrieve information about a loaded module (program or shared library)

SYNOPSIS

cc [ﬂag ... ] ﬁle ...

-ldl [library ] ...

#include <dlfcn.h>

void *dlget(int index,

struct load_module_desc *desc,

size_t desc_size);

DESCRIPTION

dlget is one of a family of routines that give the user direct access to the dynamic linking facilities.

dlget returns information about a loaded module for a process. retrieves information about a load

module from an index specifying the placement of the load module in the dynamic loader’s search list. An

index of -1 requests information about the dynamic loader. An index of -2 requests information about the

program ﬁle itself.

If successful,

dlget returns a handle for the shared library as deﬁned by the return value from

dlo-

pen().

desc must be preallocated by the user. The structure members are ﬁlled in by the dynamic loader with

information about the requested shared library.

A load_module_desc structure has the following members:

struct load_module_desc {

unsigned long text_base;

unsigned long text_size;

unsigned long data_base;

unsigned long data_size;

unsigned long unwind_base;

unsigned long linkage_ptr;

unsigned long phdr_base;

unsigned long tls_size;

unsigned long tls_start_addr;

}

desc_size speciﬁes the size in bytes of the load_module_desc structure sent in by the user.

If a call to

dlget is unsuccessful, a NULL pointer is returned and desc remains unchanged.

MULTITHREAD USAGE

This routine is thread-safe.

AUTHOR

dlget() was developed by HP.