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

d
dlmodremove(3C) dlmodremove(3C)
NAME
dlmodremove() - remove information registered using dlmodadd
SYNOPSIS
cc [flag]... file...
-ldl [library]...
#include <dlfcn.h>
int dlmodremove(void* handle);
Multithread Usage
This routine is thread-safe.
DESCRIPTION
dlmodremove()
removes the registered information of individual dynamically generated functions.
handle must be a handle returned by
dlmodadd() .
The
dlmodadd() removes the registration of the indicated function, and frees the space used by the
unwind header and unwind table created by dlmodadd()
. It does not free the space used by the unwind
info block or by the generated code, which was allocated by the user, and must be freed by the user.
RETURN VALUE
The
dlmodremove() routine returns 0
on success. If handle does not refer to a valid handle, dlmo-
dremove()
returns a non-0 value.
ERRORS
If dlmodremove() 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_HANDLE] Invalid handle.
[RTLD_ERR_NO_MEMORY] Out of memory.
[RTLD_ERR_SETCANCELSTATE_FAILED]
__thread_setcancelstate
failed on entry to or
exit from
dlmodremove().
[RTLD_ERR_SIGENABLE_FAILED]
sigenable failed on exit from dlmodremove().
[RTLD_ERR_SIGINHIBIT_FAILED]
siginhibit failed on entry to dlmodremove().
AUTHOR
dlmodadd() was developed by HP.
SEE ALSO
ld(1), dlerrno(3C), dlerror(3C), dlmodadd(3C), a.out(4), dld.so(5).
Texts and Tutorial s
HP-UX Linker and Libraries Online User Guide
(See the +help option)
HP-UX Linker and Libraries User’s Guide
(See manuals(5) for ordering information)
HP-UX 11i Version 2: December 2007 Update 1 Hewlett-Packard Company 311