Difference between revisions of "STRIDE Runner"

From STRIDE Wiki
Jump to: navigation, search
(New page: Category:Reference)
 
Line 1: Line 1:
 +
__FORCETOC__
 +
== The STRIDE Test Unit Runner Application ==
  
 +
The '''stride''' executable
 +
 +
Runs on Windows XP, Linux x86 w/gcc32 and gcc41.
 +
 +
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.
 +
 +
Options are validated and any incorrect options diagnosed will result in compilation process failure.
 +
 +
=== Syntax ===
 +
    stride [<i>options</i>] <i>scl_file1</i> [<i>scl_fileN</i>]
 +
 +
=== Options ===
 +
{| border="1" cellspacing="0" cellpadding="10" style="align:left;background-color:#ffffcc;" 
 +
!width="200pt"|'''Option'''
 +
!width="500pt"|'''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 COM''port'':''rate'':''mode''). For example: TCP:localhost:8000 or COM7:28800:8N1 or /dev/ttyS2:57600:8N1
 +
|-
 +
| '''--timeout''' (=0)
 +
| Specifies a watchdog timeout (in seconds) 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 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.
 +
|-
 +
| '''-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===
 +
 +
=== Examples ===
 +
Refer to the [[Build_Tools#Compiling_multiple_files|Compiling]] section of the Build Tools Examples.
 +
 +
=== Notes ===
 +
<references/>
 +
[[Category:Build_Tools]]
  
  
 
[[Category:Reference]]
 
[[Category:Reference]]

Revision as of 12:02, 27 May 2009

The STRIDE Test Unit Runner Application

The stride executable

Runs on Windows XP, Linux x86 w/gcc32 and gcc41.

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 .meta files.

Options are validated and any incorrect options diagnosed will result in compilation process failure.

Syntax

   stride [options] scl_file1 [scl_fileN]

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 seconds) 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 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.
-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

Examples

Refer to the Compiling section of the Build Tools Examples.

Notes

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