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,
dlmodremove()
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.
Printable version
