Relocatable loader library UM1237
The type for the user action callback function is rl_action_func_t. The parameters passed to the callback function when it is called are: handle
The handle that performed the action.
action performed.
cookie
The parameter passed to rl_add_action_callback()
.
The callback function returns 0 on success and -1 on failure. In the case of failure, the loading (or unloading) of the module is undone and the error code returned by rl_errno()
is set to RL_ERR_ACTIONF.
rl_delete_action_callback
Definition:
Remove the given function from the action callback list
int rl_delete_action_callback(
rl_action_func_t *callback_fn);
Arguments:
Returns:
Description:
callback_fn
The user specified callback function.
Returns 0 for success, -1 if the callback was not present in the callback list.
The rl_delete_action_callback() function removes the specified callback function from the action callback list. This function returns 0 if the callback was removed, or -1 if it was not present in the callback list. No error code is set.
rl_errno
Definition:
Return the error code for the last failed function
int rl_errno(
rl_handle_t *handle);
Arguments:
Returns:
Description:
handle
The handle for the module.
The error code for the last failed function.
The rl_errno() function returns the error code for the last failed function.
Table 31
lists the possible codes.
Table 31.
Errors returned by rl_errno()
Error code
RL_ERR_NONE
RL_ERR_MEM
RL_ERR_ELF
Diagnostic
Possible error causing function
No previous call has failed.
Ran out of memory (rl_memalign(), rl_text_memalign()
or rl_data_memalign() failed).
The load module is not a valid ELF file.
rl_load_buffer()
, rl_load_file()
, rl_load_stream()
, rl_set_file_name() rl_load_buffer()
, rl_load_file()
, rl_load_stream()
, rl_set_file_name()
154/166 8027948 Rev 15
UM1237 Relocatable loader library
Table 31.
Errors returned by rl_errno() (continued)
Error code Diagnostic
Possible error causing function
RL_ERR_DYN
RL_ERR_SEG
RL_ERR_REL
RL_ERR_RELSYM
RL_ERR_SYM
RL_ERR_FOPEN
RL_ERR_FREAD
RL_ERR_STREAM
RL_ERR_LINKED
RL_ERR_NLINKED
RL_ERR_SEGMENTF
RL_ERR_ACTIONF
The load module is not a dynamic library.
rl_load_buffer()
, rl_load_file()
, rl_load_stream()
, rl_set_file_name()
The load module has invalid segment information.
The load module contains invalid relocations.
rl_load_buffer()
, rl_load_file()
, rl_load_stream()
, rl_set_file_name() rl_load_buffer()
, rl_load_file()
, rl_load_stream()
, rl_set_file_name()
A symbol was not found a load time.
rl_errarg()
returns the symbol name.
rl_load_buffer()
, rl_load_file()
, rl_load_stream()
, rl_set_file_name()
The symbol is not defined in the module.
rl_errarg()
returns the symbol name.
rl_sym()
, rl_sym_rec()
The file cannot be opened by rl_fopen()
.
Error while reading the file in rl_fread()
.
Error while loading the file from a stream.
rl_load_file() rl_load_file() rl_load_stream()
Module handle is already linked.
Module handle is not linked
Error in segment function callback.
Error in action function callback. rl_load_file()
, rl_load_buffer()
, rl_load_stream()
, rl_handle_delete() rl_unload()
, rl_sym(), rl_sym_rec()
, rl_foreach_segment() rl_foreach_segment() rl_load_file()
, rl_load_buffer()
, rl_load_stream()
8027948 Rev 15 155/166
