rl_file_name. STMicroelectronics STxP70

UM1237 Relocatable loader library

rl_file_name

Return the filename associated with the loaded module handle

Definition:

const char *rl_file_name(

rl_handle_t *handle);

Arguments:

handle

The handle for the loaded module.

Returns:

Description:

The filename associated with the loaded module handle, or NULL.

The rl_file_name() function returns the filename associated with the loaded module handle. It returns NULL if no filename is associated with the current loaded module, if the handle does not hold a loaded module or if the handle passed is the main program handle.

rl_set_file_name

Definition:

int rl_set_file_name(

rl_handle_t *handle,

const char *f_name);

Arguments:

handle f_name

Specify a filename for the handle

The handle for the module.

The filename to specify for the handle.

Returns:

Description:

Returns 0 for success, -1 for failure.

The rl_set_file_name() function is used to specify a filename for a handle. This filename is attached to the next module that will be loaded. It can be used to specify a filename for modules loaded from memory or to force a different filename for a module loaded from a file.

This function returns 0 if the filename was successfully set, or -1 and the error code returned by rl_errno() is set accordingly if a module is already loaded or if the application runs out of memory.

8027948 Rev 15 147/166