DLSYM(3) BSD Library Functions Manual DLSYM(3)

NAME
     ddllssyymm - get address of a symbol

SYNOPSIS
     ##iinncclluuddee <>

     void*
     ddllssyymm(void* handle, const char* symbol);

DESCRIPTION
     ddllssyymm() returns the address of the code or data location specified by the
     null-terminated character string symbol.  Which libraries and bundles are
     searched depends on the handle parameter.

     If ddllssyymm() is called with a handle, returned by ddllooppeenn() then only that
     image and any libraries it depends on are searched for symbol.

     If ddllssyymm() is called with the special handle RTLDDEFAULT, then all mach-
     o images in the process (except those loaded with dlopen(xxx,
     RTLDLOCAL)) are searched in the order they were loaded.  This can be a
     costly search and should be avoided.

     If ddllssyymm() is called with the special handle RTLDNEXT, then the search
     for the symbol is limited to the images which were loaded after the one
     issuing the call to ddllssyymm().

RETURN VALUES
     The ddllssyymm() function returns a null pointer if the symbol cannot be
     found, and sets an error condition which may be queried with ddlleerrrroorr().

NNOOTTEESS
     Unlike other dyld API's, the symbol name passed to ddllssyymm() must NOT be
     prepended with an underscore.

SEE ALSO
     dlopen(3) dlsym(3) dlerror(3) dyld(3) NSModule(3) NSObjectFileImage(3)
     ld(1) cc(1)

                                 Sept 25, 2004