Difference between revisions of "STRIDE Runner"

From STRIDE Wiki
Jump to: navigation, search
Line 2: Line 2:
 
== The STRIDE Test Unit Runner Application ==
 
== The STRIDE Test Unit Runner Application ==
  
−
The '''stride''' executable
+
The '''stride''' executable runs target-based tests from a host computer and optionally uploads results to [[STRIDE Test Space]]. The program also can be used to list the names of all Test Units that exist in a STRIDE database file.
  
−
Runs on Windows XP, Linux x86 w/gcc32 and gcc41.
+
The stride executable is available to run on Windows XP and on Linux x86.
  
−
All warnings and errors that occur during the compilation are written to the standard output device. The compilation for a particular file is considered successful if no errors occur. Otherwise it is unsuccessful. Unsuccessful compilations do not yield <tt>.meta</tt> files.
+
=== Running Tests ===
 +
You may specify either built-in diagnostics or user tests to be run.
 +
 
 +
==== Input ====
 +
database file
 +
 
 +
tests to run
 +
 
 +
==== Output ====
 +
console output
 +
 
 +
local xml file
 +
 
 +
test space
 +
 
 +
 
 +
=== Syntax ===
 +
    stride [<i>options</i>]
 +
 
 +
Any warnings or errors that occur during execution are written to the standard output device.
 
   
 
   
−
Options are validated and any incorrect options diagnosed will result in compilation process failure.
+
Prints a summary of results on the console: passed/failed/in progress/not in use
 +
 
 +
by default, xml output is written to the db directory using db name with xml extension
 +
 
 +
run a test
  
−
=== Syntax ===
+
check program version
−
    stride [<i>options</i>] <i>scl_file1</i> [<i>scl_fileN</i>]
+
 
 +
list database contents
 +
 
 +
run diagnostic test
  
 
=== Options ===
 
=== Options ===
Line 28: Line 54:
 
|-
 
|-
 
| '''--timeout''' (=0)
 
| '''--timeout''' (=0)
−
| Specifies a watchdog timeout (in seconds) per single execution step. (0 = infinite timeout)
+
| Specifies a watchdog timeout (in milliseconds) per single execution step. (0 = infinite timeout)
 
|-
 
|-
 
| '''-r''' [ --run ] arg (=/(*))
 
| '''-r''' [ --run ] arg (=/(*))
Line 42: Line 68:
 
|-
 
|-
 
| '''-u''' [ --upload ] [=arg(=full)]
 
| '''-u''' [ --upload ] [=arg(=full)]
−
| Specifies an upload of results to STRIDE Test Space. Arg specifies incomplete/incremental/complete.  
+
| Specifies an upload of results to STRIDE Test Space. Arg specifies full or incomplete/incremental/complete.  
 
|-
 
|-
 
| '''--testspace''' arg
 
| '''--testspace''' arg
Line 60: Line 86:
 
|-
 
|-
 
| '''--diagnostics'''
 
| '''--diagnostics'''
−
| Performs a set of built-in diagnostic tests on the target.
+
| Performs a set of built-in diagnostic tests on the target. [[Verifying_Installation]]
 
|-
 
|-
 
| '''-o''' [ --output ] arg
 
| '''-o''' [ --output ] arg
Line 71: Line 97:
  
 
===Environment Variables===
 
===Environment Variables===
 +
The following environment variables are recognized by the application and their values used as shown if set. Any value specifed by an environment variable will be overridden if the corresponding value is specified onn the command line.
 +
 +
;STRIDE_DEVICE
 +
: specifies the --device argument
 +
;STRIDE_TESTSPACE_URL
 +
: specifies the  --testspace argument
 +
;STRIDE_TESTSPACE_PROJECT
 +
: specifies the --project argument
 +
;STRIDE_TESTSPACE_SPACE
 +
: specifies the --space argument
  
 
=== Examples ===
 
=== Examples ===

Revision as of 12:55, 27 May 2009

The STRIDE Test Unit Runner Application

The stride executable runs target-based tests from a host computer and optionally uploads results to STRIDE Test Space. The program also can be used to list the names of all Test Units that exist in a STRIDE database file.

The stride executable is available to run on Windows XP and on Linux x86.

Running Tests

You may specify either built-in diagnostics or user tests to be run.

Input

database file

tests to run

Output

console output

local xml file

test space


Syntax

   stride [options]

Any warnings or errors that occur during execution are written to the standard output device.

Prints a summary of results on the console: passed/failed/in progress/not in use

by default, xml output is written to the db directory using db name with xml extension

run a test

check program version

list database contents

run diagnostic test

Options

Option Description
--version Print version information.
--database arg Specifies the name of an existing STRIDE database (.sidb) file that will be used for test execution.
--device arg Specifies the parameters to be used to connect to the target device (i.e. TCP:host:port or COMport:rate:mode). For example: TCP:localhost:8000 or COM7:28800:8N1 or /dev/ttyS2:57600:8N1
--timeout (=0) Specifies a watchdog timeout (in milliseconds) per single execution step. (0 = infinite timeout)
-r [ --run ] arg (=/(*)) Specifies a list of Test Units to execute and their order of execution with optional grouping by suite.
  • = wild card

- = remaining 

For example:
  /(TU1,TU2,TU3)
  "/Suite1/Suite2(TUa, TUb)"
  /Suite(*)
  "TUx TUy TUz"
-u [ --upload ] [=arg(=full)] Specifies an upload of results to STRIDE Test Space. Arg specifies full or incomplete/incremental/complete.
--testspace arg Specifies the root STRIDE Test Space URL and credentials. (i.e. http://host:port@user:pwd)
--project arg Specifies the name of the STRIDE Test Space project to which the results will be uploaded
--space arg Specifies the name of the STRIDE Test Space project's test space.
--name arg Specifies the name under which the results will be uploaded to STRIDE Test Space
--list Lists all Test Units in the specified STRIDE database
--diagnostics Performs a set of built-in diagnostic tests on the target. Verifying_Installation
-o [ --output ] arg Specifies the local file to which results will be written.
-O [--options_file] arg A file that contains command line options. The format is the same as the command line with the only addition that it could be split on multiple lines. A line starting with "#" symbol is ignored.

This option is necessary if the length of the command line string exceeds system limits. Otherwise it is provided only as a convenience.

Environment Variables

The following environment variables are recognized by the application and their values used as shown if set. Any value specifed by an environment variable will be overridden if the corresponding value is specified onn the command line.

STRIDE_DEVICE
specifies the --device argument
STRIDE_TESTSPACE_URL
specifies the --testspace argument
STRIDE_TESTSPACE_PROJECT
specifies the --project argument
STRIDE_TESTSPACE_SPACE
specifies the --space argument

Examples

Refer to the Compiling section of the Build Tools Examples.

Notes

Retrieved from "https://www.stridewiki.com/index.php?title=STRIDE_Runner&oldid=9725"