Runtime Integration
Overview
This page discuses the first step in an overall STRIDE integration effort. Here we incorporate the STRIDE runtime in your target application build without tests. In the second and last step, we add the STRIDE Build Tools to the mix and hook up the test-running harnessing.
After building the target with the STRIDE runtime in place, we will run stride from a remote host computer to verify connectivity and runtime operation.
Recommendations
The STRIDE target environment offers lots of flexibility to accommodate different target scenarios. For an initial target integration, we recommend that you pursue the simplest STRIDE configuration that will yield results. Once this configuration is successfully integrated you can make adjustments as desired.
Here are a few specific recommendations:
- STRIDE runtime library
- Build and link with the static STRIDE runtime library (libstride.a or stride.lib)
- STRIDE I/O
- Build and use the single process configuration instead of building and employing the STRIDE daemon
Integrating STRIDE Into Your Target Build
To add the STRIDE runtime to your build process, the following changes must be made:
- Secure a PAL targeted to your target operating system
- Configure the PAL I/O parameters to conform the your target hardware
- Edit your target application's source code to start the runtime's I/O thread
- Add steps to your target build process to include the STRIDE runtime source files
Securing a PAL
The Platform Abstraction Layer (PAL) provides the glue between the STRIDE runtime and services offered by your OS. It is the only piece of the runtime that is customized between operating systems.
Fully tested PALs are provided for Linux and Windows, included as palIO.c and palOS.c in their respective SDKs. Other PALs are also available or under development. Please contact S2 for availability.
Configuring I/O parameters
If your target will communicate with the host computer via the default of TCP/IP port 8000, you can skip this step.
Otherwise, refer to palcfg.h for a list of configuration parameters.
For complete information, refer to the Platform Abstraction Layer page and the PAL Specification document.
Including the STRIDE Runtime Sources
The STRIDE runtime sources are distributed in source form. The source files are available as a stand-alone package and are also included with each flavor of SDK package.
The runtime sources are supplied in three directories:
If you are using an S2-supplied PAL, files in each of these directories should be included in your target build.
If you are using an S2-supplied PAL, additional required sources can be found in the SDK's src directory:
- PAL implementation
- palcfg.h
- palIO.c
- palOS.c
- Convenience functions (these wrap low-level STRIDE runtime calls)
- stride.c
- stride.h
The SDKs inlclude the runtime sources by building them into a library that is then linked with the target application.
Target Source Changes
Your target source must be edited to include code that initializes and uninitializes the runtime. The code is typically added to your main()</tty> function, but the only requirement is that the initialization takes place before the host computer connects and the uninitialization occurs before the process terminates.
Example startup code:
#ifdef WIN32
#include <windows.h>
#include <tchar.h>
#else
#include <stdlib.h>
#include <unistd.h>
#endif
/* STRIDE runtime includes */
#include <stride.h>
int main(int argc, char **argv)
{
...
/* initialize the STRIDE subsytem using default I/O */
strideIO_t io = {strideDEFAULT};
/* for C++ use
strideIO_t io = {strideIO_t::strideDEFAULT};
*/
if (strideInit(&io) != srTRUE) {
return -1;
}
/* target application code here */
...
/* this call blocks until a SIGTERM is received, omit if not needed */
strideExWaitForExit();
/* terminate all STRIDE threads and uninitialize STRIDE subsystem */
strideUninit();
return 0;
}