HP-UX Reference (11i v1 05/09) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

211

212

213

214

215

216

217

218

219

220

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

If dlmodremove() fails, a subsequent call to

dlerrno() returns one of the following values:

[RTLD_ERR_NO_MEMORY] Out of memory.

[RTLD_ERR_CANT_APPLY_RELOC]

Cannot apply relocation in library.

[RTLD_ERR_INV_HANDLE] Invalid handle.

[RTLD_ERR_SIGINHIBIT_FAILED]

siginhibit failed on entry to dlmodremove()

[RTLD_ERR_SIGENABLE_FAILED]

sigenable failed on exit from dlmodremove()

[RTLD_ERR_SETCANCELSTATE_FAILED]

__thread_setcancelstate

failed on entry to or exit from

dlmodremove() .

AUTHOR

dlmodadd() was developed by HP.