Kenwood HP 9000 Personal Computer User Manual


 
248 Chapter 6
Shared Library Management Routines
The dlopen Shared Library Management Routines
The dlget Routine
Retrieves information about a loaded module (program or shared
library).
Syntax
void *dlget(unsigned int index,
struct load_module_desc *desc,
size_t desc_size);
Parameters
Return Values
If successful, dlget returns a handle for the shared library as defined by
the return value from dlopen(). If a call to dlget is unsuccessful, a
NULL pointer is returned and desc remains unchanged.
Description
dlget is one of a family of routines that give the user direct access to the
dynamic linking facilities. dlget retrieves information about a load
module from an index specifying the placement of a load module in the
dynamic loader’s search list.
A load_module_desc structure has the following members:
Parameter Definition
index Specifies the requested shared library by its placement
on the dynamic loader's search list. An index of zero
requests information about the program file itself. An
index of -1 requests info about the dynamic loader.
desc Must be preallocated by the user. The structure
members are filled in by the dynamic loader with
information about the requested shared library.
desc_size Specifies the size in bytes of the load_module_desc
structure sent in by the user.