UM1237 Relocatable loader library
rl_sym
Definition:
Return a pointer reference to the symbol in the loaded module
void *rl_sym(
rl_handle_t *handle,
const char *name);
Arguments:
Returns:
Description:
handle name
The handle for the loaded module.
The symbol in the loaded module.
The pointer reference to the symbol.
The rl_sym() function returns a pointer reference to the symbol named name in the loaded module specified by handle. It searches the dynamic symbol table of the loaded module and returns a pointer to the symbol. The handle parameter can be the handle of any currently loaded module, or the handle of the main module.
If the symbol is not defined in the loaded module, NULL is returned. It is not generally an error for this function to return NULL. For example, the user may conditionally call a specific function only if it is defined in the module.
In this function, as well as in the rl_sym_rec() function, the name parameter must be the mangled symbol name. For instance, on some targets, C names are mangled by prefixing the name with an underscore (_). For example, to return a reference to the printf() function, the symbol name passed to rl_sym() will be “_printf”.
rl_sym_rec
Return a pointer reference to the symbol in the loaded module or one of its ancestors
Definition:
void *rl_sym_rec(
rl_handle_t *handle,
const char *name);
Arguments:
handle name
The handle for the loaded module.
The symbol in the loaded module.
Returns:
Description:
The pointer reference to the symbol.
The rl_sym_rec() function returns a pointer reference to the symbol named name in the loaded module specified by handle or one of its ancestors.
This function searches the dynamic symbol table of the loaded module and returns a pointer to the symbol if found. If the symbol is not found, the function iteratively searches in the dynamic symbol table of the parent module until the symbol is found.
The handle parameter can be the handle of any currently loaded module, or the handle of the main module.
If the symbol is not defined in the loaded module or one of its ancestors, NULL is the returned. It is not generally an error for this function to return NULL.
The name parameter must be the mangled symbol name as for the rl_sym() function.
8027948 Rev 15 151/166
