Difference between revisions of "Studio:Deploying STRIDE on the Target"

From STRIDE Wiki
Jump to: navigation, search
(IM & Target Test Code)
Line 8: Line 8:
  
 
==IM & Target Test Code==
 
==IM & Target Test Code==
The second category is more dynamic in nature and its composition depends on your SCL instrumentation:
+
The second category is more dynamic in nature and is referred to as an ''Intercept Module'' (IM). This code takes the form of c or c++ source code that is generated by STRIDE Studio from the SCL instrumentation you have applied to your target source header files.
  
* If your SCL includes instrumentation for ''host-based'' testing (e.g. <code>scl_function()</code> or <code>scl_msg()</code>), this category will include IM code
+
It's important to understand the way that the IM is used in your specific testing scenario, since this controls the ways in which the overall STRIDE code can be deployed on your target system.
  
* If your SCL includes instrumentation for ''target-based'' testing (e.g. <code>scl_test_class()</code>), this category will include IM code (generated to run your test classes) and the c++ test class code that you write.
+
===IM Composition===
 
* An Intercept Module (IM), which is dynamically created from your SCL-instrumented source code (and additional specification through either the IM Wizard or scripting of the studio object model).
 
  
A last category is test classes that you create for target-based testing.  
+
* If your SCL includes specific interface instrumentation (e.g. the <code>scl_function()</code> or <code>scl_msg()</code> pragmas are used), the IM code will include some combination of sutbs, proxies, and delegates to enable the remoting of the interfaces you have instrumented. This type of instrumentation is typically used with ''host-based'' testing, where scripts running on the host call C functions running on the host.
  
All of this code  
+
* If your SCL includes instrumentation for ''target-based'' testing utilizing one or more C++ ''test classes'' (e.g. the <code>scl_test_class()</code> pragma), the IM code will include a synthesized function to run each test class (which includes a stub that enables the function to be called from the remote host), and the C++ test class code that you write.
  
  
The IM, however, is often a dynamically-changing module, especially as source code is incrementally SCL-instrumented as tests are being developed.
 
  
 
=Target Deployment Models=
 
=Target Deployment Models=
It is not always known what the ultimate IM setup will be when starting to create tests for a platform, but it's  important to consider your needs up front, since the STRIDE deployment model you choose will affect project workflow.  
+
It is not always known what the ultimate IM setup will be when starting to create tests for a platform, but it's  important to consider your needs up front, since the STRIDE deployment model you choose will affect project workflow.
 +
 
==The TestAgent Configuration==
 
==The TestAgent Configuration==
 
[[Image:TestAgentConfiguration.jpg|frame]]
 
[[Image:TestAgentConfiguration.jpg|frame]]

Revision as of 17:35, 18 April 2008

STRIDE Code on the Target

In order for STRIDE Studio to interoperate with your target system, some STRIDE-specific code must be part of the binary running on your target.

STRIDE Runtime & PAL

The first category of STRIDE code is the combination of STRIDE Runtime and PAL, which together provide standard STRIDE runtime services customized for the target hardware and operating system.

The runtime + PAL combination is typically created as part of a STRIDE platform integration. This code is static in nature; once produced, it is usually packaged as a linkable library for use with the dynamic portions of the test code.

IM & Target Test Code

The second category is more dynamic in nature and is referred to as an Intercept Module (IM). This code takes the form of c or c++ source code that is generated by STRIDE Studio from the SCL instrumentation you have applied to your target source header files.

It's important to understand the way that the IM is used in your specific testing scenario, since this controls the ways in which the overall STRIDE code can be deployed on your target system.

IM Composition

  • If your SCL includes specific interface instrumentation (e.g. the scl_function() or scl_msg() pragmas are used), the IM code will include some combination of sutbs, proxies, and delegates to enable the remoting of the interfaces you have instrumented. This type of instrumentation is typically used with host-based testing, where scripts running on the host call C functions running on the host.
  • If your SCL includes instrumentation for target-based testing utilizing one or more C++ test classes (e.g. the scl_test_class() pragma), the IM code will include a synthesized function to run each test class (which includes a stub that enables the function to be called from the remote host), and the C++ test class code that you write.


Target Deployment Models

It is not always known what the ultimate IM setup will be when starting to create tests for a platform, but it's important to consider your needs up front, since the STRIDE deployment model you choose will affect project workflow.

The TestAgent Configuration

TestAgentConfiguration.jpg

By default, we recommend that you consider the light-weight "TestAgent" configuration. This deployment model imposes several limitations, but this model minimizes the impact on your target system and workflow, and in many testing scenarios, the limitations are not ***.

Requirements:

  • IM can contain only stubs
  • No target c/cpp files may be used to build the executable image
    • For target-based testing, test class implementations are in header file(s)


The TestApp Configuration

TestAppConfiguration.jpg