Relocatable loader library UM1237
rl_this
Definition:
Arguments:
Returns:
Description:
Return the handle for the current module
rl_handle_t *rl_this(void);
None.
The handle for the current module.
The rl_this() function returns the handle for the current module. If called from the main module, it returns the handle of the main module. If called from a loaded module, it returns the handle that holds the loaded module.
This function is used when allocating a handle with rl_handle_new(). It can also be used, for example, to retrieve a symbol in the current module: void *symbol_ptr = rl_sym(rl_this(), "symbol");
rl_parent
Definition:
Arguments:
Returns:
Description:
Return the handle for the parent of the current handle
rl_handle_t *rl_parent(void);
None.
The handle for the parent of the current handle.
The rl_parent() function returns the handle for the parent of the current handle
(as returned by rl_this()).
It may be used, for example, to find a symbol in one of the parent modules: void *symbol_in_parents = rl_sym_rec(rl_parent(), "symbol");
rl_load_addr
Definition:
Return the memory load address of a loaded module
const char *rl_load_addr(
rl_handle_t *handle);
Arguments:
handle
The handle for the loaded module.
Returns:
Description:
The memory load address of the loaded module, or NULL.
The rl_load_addr() function returns the memory load address of a loaded module. It returns NULL if the handle does not hold a loaded module or if the handle passed is the main program handle.
rl_load_size
Definition:
Return the memory load size of a loaded module
unsigned int rl_load_size(
rl_handle_t *handle);
Arguments:
handle
The handle for the loaded module.
Returns:
Description:
The memory load size of the loaded module, or 0.
The rl_load_size() function returns the memory load size of a loaded module. It returns 0 if the handle does not hold a loaded module or if the handle passed is the main program handle.
146/166 8027948 Rev 15
