Scl function

The scl_function pragma

The scl_function pragma allows the user to capture the function. All interfaces that STRIDE works with must be captured.

When captured for the purpose of interception (in which case the term intercept-able is used throught the documentation) optional arguments allow specification of how would it be done. The Instrument Build Tool will use those options to generate appropriate function interception code.

Syntax

#pragma scl_function(function-name [,context, name-mangling, group-id])

Parameters	Type	Description
function-name	String	Name of the function to define (no quotes)
context	String	Optional. Context in which the function is going to be intercepted. Possible values are "REFERENCE" - intercept at the function call or "DEFINITION" - intercept at the function definition. These attribute is equivalent to the formal User/Owner option that is in place for generating delegates.
name-mangling	String	Optional. Type of name mangling to be used when intercepted. Possible values are "EXPLICIT" or "IMPLICIT". These attribute is equivalent to the formal Implicit/Explicit option that is in place for generating delegates.
group-id	String	Optional. User defined identifier representing the group to which this function belongs when solving name mangling conflicts. These attribute is equivalent to the formal Group ID option that is in place for generating delegates.

Notes

• Identifier must be declared as a function designator with external linkage.
• A compilation error is reported if an attempt is made to capture a function more than once (with either scl_func or scl_function).

Example

int f(int x); 

void g(void);

#pragma scl_function(f)
#pragma scl_function(g, "DEFINITION", "IMPLICIT", "TEST_GROUP")