HP-UX Linker and Libraries User's Guide

Table 22 dl* routines for shared library management (continued)
ActionRoutine
Removes information registered using dlmodadd.“The dlmodremove Routine” (page 166)
Retrieves information about a loaded module (program or
shared library).
“The dlgetmodinfo Routine” (page 166)
All the dlopen routines are thread-safe. These routines are described in the dl*(3C) manpages.
The shl_load Routine Summary
The shl_load family of shared library management routines are available for both the PA32
(compatibility mode) and IPF/PA64 linker.
Use the following shl_load outines for shared library management:
Table 23 Routines for shared library management
ActionRoutine
Explicitly load a shared library. It lets you load a compatibility
or standard mode shared library. It does depth-first searching.
shl_load
shl_findsym Finds the address of a global symbol in a shared
library.
Get information about currently loaded libraries. The shl_get_r
routine is a thread-safe version of the shl_get routine with
the same syntax.
shl_get and shl_get_r
Get descriptor information about a loaded shared library. The
shl_gethandle_r routine is a thread-safe version of the
shl_gethandle routine with the same syntax.
shl_gethandle and shl_gethandle_r
Adds a new symbol to the global shared library symbol table.shl_definesym
Returns a list of symbols in a shared libraryshl_getsymbols
Unload a shared library.shl_unload and cxxshl_unload
Except for shl_get and shl_gethandle, all routines are thread safe. These routines are
described in the shl_load(3x) manpage.
Related Files and Commands
The following commands and files provide more information about using shared library management
routines.
ActionCommand/File
Executable file from assembler, compiler, and linker output.a.out(4)
Command to invoke the HP-UX C compiler.cc(1)
System loader.exec(2)
Command to invoke the linker.ld(1)
Shared Library Header Files
The shl_load family of shared library management routines use some special data types (structures)
and constants defined in the C-language header file /usr/include/dl.h. When using these
functions from C programs, be sure to include dl.h:
#include <dl.h>
Similarly, if you are using the dlopen family of routines, include /usr/include/dlfcn.h.
Shared Library Header Files 137