rl_load_stream. STMicroelectronics STxP70

STxP70 is a compiler that manages the stages of the compilation process: preprocessing, compiling into assembly language, assembling and linking. The assembler file is compiled using stxp70-as and linked using stxp70-ld to provide an STxP70 binary image. All these phases are hidden using the driver tool stxp70cc. This compiler supports the ANSI C89 standard and partially supports the ANSI C99 standard.

PDF

Document

UM1237 Relocatable loader library

rl_load_stream

Load a relocatable module into memory from a byte stream

Definition:

typedef int rl_stream_func_t (

void *cookie,

char *buffer,

int length); int rl_load_stream(

rl_handle_t *handle,

rl_stream_func_t *stream_func,

void *stream_cookie);

Arguments:

Returns:

Description:

handle stream_func stream_cookie

The handle for the module.

The user specified callback function.

The user specified state.

Returns 0 for success, -1 for failure.

The rl_load_stream() function loads a relocatable module into memory from a byte stream provided through a user specified callback function stream_func and the user specified state stream_cookie.

The callback function must be of type rl_stream_func_t. It is called multiple times by the loader to retrieve the load module data in the buffer buffer of length length until the module is loaded into memory. The loader always calls the callback function with a buffer length strictly greater than 0. The stream_cookie argument passed to rl_load_stream

is passed to the callback function in its cookie parameter. The cookie

parameter is intended to be used by the callback function to update a private state.

The callback function must return the number of bytes transferred. If the returned value is less than the given buffer length or is -1, rl_load_stream() will in turn return an error and the error code returned by rl_errno() is set accordingly.

The rl_load_stream() function allocates the space for the loaded module from the heap, loads the segments by calling the callback function, links the module to the parent module of the handle, relocates and initializes the loaded module. This function calls the action callback functions for RL_ACTION_LOAD after loading and before executing any code in the loaded module.

is returned if the load was successful, -1 is returned on failure and the error code returned by rl_errno() is set accordingly.

This function can be used as an alternative to rl_load_buffer() or rl_load_file()

to allow any loading method to be implemented.

8027948 Rev 15 149/166

Greetings! I've processed the STMicroelectronics STxP70 compiler User Manual. This extensive document covers the STxP70 compiler driver, pragmas, optimization techniques, GNU C extensions, and built-in functions. I'm prepared to answer questions regarding the compiler's usage and functionalities.

Show related prompts

Assistant typing

Assistant is out of keyboard. Please, try again later.

Key features

GNU C language parser
State-of-the-art optimizations
Hardware loop mechanisms
Special addressing modes
Memory space optimization
Instruction scheduling
Compiler intrinsics and built-ins support
Support for X3, FPX, and MPx extensions

Frequently asked questions

The purpose of the STxP70 compilation driver (stxp70cc) is to manage the stages of the compilation process: preprocessing, compiling into assembly language, assembling and linking. The assembler file is compiled using stxp70-as and linked using stxp70-ld to provide an STxP70 binary image. All these phases are hidden using the driver tool stxp70cc.

This user manual provides detailed information to enable users to write efficient code optimized to run on the STxP70 processors and to compile and link it ready for execution by sxrun. The manual covers: stxp70cc driver options, pragmas supported by stxp70cc, compiler optimization techniques, GNU C language extensions, GNU asm construct, built-in functions.

The load/run tool sxrun and the STxP70 debugger sxgdb are described in the STxP70 Professional Toolset user manual (7833754).

User questions

Linda H.

How does the STxP70 compiler manage floating-point arithmetic and the float type?

The STxP70 compiler assumes double precision by default but can be instructed to use single precision via the -fshort-double option. Floating-point support can be managed with -mlib-nofloat to reduce library size, while the -trapuv option initializes float variables to a NaN pattern for debugging. Floating-point arithmetic is enabled by connecting the FPx extension via -Mextension=fpx.