STRIDE Runner: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| 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. | ||
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 [<i>options</i>] | |||
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 === | === Options === | ||
| Line 28: | Line 54: | ||
|- | |- | ||
| '''--timeout''' (=0) | | '''--timeout''' (=0) | ||
| Specifies a watchdog timeout (in | | 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 18: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.
- = 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.