Scl function

From STRIDE Wiki
Revision as of 16:20, 29 September 2015 by Ivailop (talk | contribs) (Syntax)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

The SCL function pragma allows capturing a global function for doubling or remoting. During the build process the Stride Build Tools generates Intercept Module that provides the correct logic for the test.

int foo(int x); 

void boo(void);

#pragma scl_function(foo)
#pragma scl_function(boo, "DEFINITION", "IMPLICIT", "TEST_GROUP")

Syntax

The scl_function pragma allows the user to capture a function. When captured for the purpose of interception (intercept-able) the optional arguments are used to specify how the intercept should be executed. The Instrument Build Tool will use those options to generate appropriate function interception code.

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


Parameters Type Description
function-name Identifier Name of the function to capture.
context String Optional. Context in which the function is going to be intercepted. Possible values are "REFERENCE" - intercept at the function call (i.e. where the function is called) or "DEFINITION" - intercept at the function definition (i.e. where the function is implemented).
name-mangling String Optional. Type of name mangling to be used when intercepted. Possible values are "EXPLICIT" or "IMPLICIT". If the context argument is defined the default will be IMPLICIT. Note that if EXPLICIT is set the srTEST_INTERCEPT(<function_name>) macro is required.
group-id String Optional. User defined identifier representing the group to which this function belongs when enabling interception. The default group-id is set to STRIDE_TEST_GROUP.

Notes

  • The function must be declared as a designator with external linkage.
  • A compilation error is reported if an attempt is made to capture a function more than once.

Examples

Using the default "IMPLICIT" name-mangling and "STRIDE_TEST_GROUP" group-id

void boo(void);

#pragma scl_function(boo, "DEFINITION")


Setting a specific name-mangling and group-id

void boo(void);

#pragma scl_function(boo, "DEFINITION", "IMPLICIT", "MY_TEST_GROUP")