Scl function: Difference between revisions

Latest revision as of 22:20, 29 September 2015

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")

@@ Line 1: / Line 1: @@
-= The scl_function pragma =
+__NOTOC__
+The ''SCL function'' pragma allows capturing a global function for doubling or remoting. During the build process the [[Build Tools | Stride Build Tools]] generates [[Intercept Module]] that provides the correct logic for the test.
-The scl_function pragma allows the user to capture a function. All interfaces that STRIDE works with must be captured.
+<source lang=c>
+int foo(int x);
-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 [[s2sinstrument|Instrument Build Tool]] will use those options to generate appropriate function interception code.
+void boo(void);
-== Syntax ==
+#pragma scl_function(foo)
+#pragma scl_function(boo, "DEFINITION", "IMPLICIT", "TEST_GROUP")
+</source>
+=== 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 [[s2sinstrument|Instrument Build Tool]] will use those options to generate appropriate function interception code.
   #pragma scl_function(function-name [,context, name-mangling, group-id])
@@ Line 16: / Line 23: @@
 |-
 | ''function-name''
-| String
+| Identifier
-| Name of the function to capture (no quotes)
+| 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 (aka user) or ''"DEFINITION"'' - intercept at the function definition (aka owner).
+| 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|name mangling]] to be used when intercepted. Possible values are ''"EXPLICIT"'' or ''"IMPLICIT"''.
+| Optional. Type of [[Name_Mangling|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 solving name mangling conflicts.
+| 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 ==
+=== 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 (with either [[scl_func]] or scl_function).
+* A compilation error is reported if an attempt is made to capture a function more than once.
-== Example ==
+=== Examples ===
+Using the default "IMPLICIT" ''name-mangling'' and "STRIDE_TEST_GROUP" ''group-id''
 <source lang=c>
-int f(int x);
+void boo(void);
-void g(void);
+#pragma scl_function(boo, "DEFINITION")
+</source>
-#pragma scl_function(f)
-#pragma scl_function(g, "DEFINITION", "IMPLICIT", "TEST_GROUP")
+Setting a specific ''name-mangling'' and ''group-id''
+<source lang=c>
+void boo(void);
+#pragma scl_function(boo, "DEFINITION", "IMPLICIT", "MY_TEST_GROUP")
 </source>
-[[Category:SCL]]

Scl function: Difference between revisions

Latest revision as of 22:20, 29 September 2015

Syntax

Notes

Examples

Navigation menu

Search