Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > D

dlmodremove(3C)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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.

SEE ALSO

ld(1), dlerrno(3C), dlerror(3C), dlmodadd(3C), a.out(4), dld.so(5).

Texts and Tutorials

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)

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.