dlmodremove.3c (2010 09)

dlmodremove(3C) dlmodremove(3C)

NAME

dlmodremove() - remove information registered using dlmodadd

SYNOPSIS

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

-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

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.