OpenSS7
SS7 for the
Common Man
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.
Last modified: Mon, 28 Apr 2008 12:53:44 GMT
Home TopIndex FirstPrev Next LastMore Download Info FAQ Mail  Home -> Documentation -> Man Pages -> Manual Page
Quick Links

Download

SCTP

SIGTRAN

SS7

Hardware

STREAMS

Asterisk

Related

Package

Manual

FAQ

Man Pages

Applications

SS7 Stack

ISDN Stack

SIGTRAN Stack

VoIP Stack

MG Stack

SS7/ISDN Devices

IP Transport

Embedded Systems

OS

Documentation

FAQ

SIGTRAN

Design

Conformance

Performance

References

Man Pages

Manuals

Papers

Home

Overview

Status

Documentation

Resources

About

News

Description: Manual Page

Keywords: ss7 ss7/ip ss7 over ip ss7 mtp ss7 sccp ss7 tcap sigtran mtp sccp tcap openss7 acb56 linux telephony pstn linux telephony linux nebs linux compactpci


TEST-STREAMS

Section: The OpenSS7 Project Administration (8)
Updated: Thu, 14 Dec 2017 02:59:06 GMT
Index Return to Main Contents

NAME

test-streams - a test suite executable for STREAMS

SYNOPSIS

test-streams [options] [{-o|--onetest} [TESTCASE]] [{-t|--tests} [RANGE]]
test-streams [options] {-l|--list} [RANGE]
test-streams {-h|--help}
test-streams {-V|--version}
test-streams {-C|--copying}

DESCRIPTION

test-streams
is a test suite executable for STREAMS. The purpose of the test-streams test suite executable is to provide a means for development, diagnostic, regression and validation testing of STREAMS. The The OpenSS7 Project package also provides an autotest based test suite that uses the test-streams test case executable to invoke test cases. This test suite can be used for development, diagnostic, regression or validation testing. See the The OpenSS7 Project Installation and Reference Manual for more information on how to invoke the autotest test suite.

OPTIONS

test-streams options fall into several categories as detailed in the subsections below. If test-streams is executed without any options, it will execute all available test cases and report the progress and results of each test case.

Command Options

These command options determine whether test cases are run or whether an informative function is performed instead. If none of these command options are specified, then it is assumed that all test cases are to be executed. Options --list, --help, --version and --copying will override the --onetest and --tests options.

-o, --onetest [TESTCASE]
Specifies a single test case to run. TESTCASE is the individual test case number. This option may be repeated and is accumulative: that is, each test case added with an occurrence of this option will be added to the other test cases selected with --onetest or with --tests.
-t, --tests [RANGE]
Specifies a range of test cases to run. RANGE specifies the range of test cases and will match all test cases that have this string as an initial substring of the test case number. If RANGE is not specified, then all test cases are selected.
-l, --list [RANGE]
When this option is encountered, print a list of test cases to stdout and exit. When a RANGE of test cases is specified, only the specified range of tests will be listed. When a RANGE is not specified, all test cases will be listed. When used in combination with --verbose this option will print more or less information about each test case. Note that all options specified following this option are ignored.
-h, --help, -?, --?
When this option is encountered, print usage information to stdout and exit. Note that all options specified following this option are ignored.
-V, --version
When this option is encountered, print version information to stdout and exit. Note that all options specified following this option are ignored.
-C, --copying
When this option is encountered, print copying information to stdout and exit. Note that all options specified following this option are ignored.

General Options

The following options are applicable to all command options. For other than test case command options, these general options must appear ahead of the command option.

-q, --quiet
Specifies that the caller is interested only in the return code and error diagnostics and that normal output should be suppressed. The default verbosity level if this option is not specified is 1. This option is equivalent to --verbose=0.
-v, --verbose [LEVEL]
Increases or sets the verbosity level. When this option is given without the LEVEL argument, it specifies that the verbosity level should be increased by one. If the LEVEL argument is specified, the verbosity level is set to that integer value. This option can be repeated. The default verbosity level if this option is not specified is 1. For example, -vvvv is equivalent to --verbose=5.

Test Case Options

The following options are only applicable if a test case command option is in effect. That is, these options are only effective if test cases are being executed and are used to modify the manner in which test cases are executed or test case results reported.

-d, --device DEVICE
Specifies the device name to open for the tests. Because this test program uses pipes, this option is ineffective.
-w, --wait
Specifies that the client or server is to wait indefinitely. Normally a test case guard timer is started (40 seconds) that will fire and cause the test case to fail if the test cases waits indefinitely for an event to start or continue. This option suppresses the test cause guard timer and allows the client or server to wait indefinitely from some event to occur. This is paricularly useful when one side of the test case (client or server) is being run manually.
-e, --exit
Specifies that the first test case run that is not successful will cause all remaining test cases to be skipped and the return code will reflect the result of the failed test case. This option is useful in conjunction with option --onetest in that if a single test is being run, the return code will reflect the result of the test case. This is used by the OpenSS7-0.9.2 test suite to run individual tests under autotest.
-a, --again
Specifies that the selected test cases are to be repeated in verbose mode if they fail in non-verbose mode. This option is useful for use with autotest test suites.
-R, --repeat
Repeat the selected test cases on success or failure. This option causes the executable to loop through the selected test cases, one after the other, regardless of whether an individual test case succeeds or fails. This option is useful in conjunction with --onetest and --client or --server when the other end of the test is being executed manually.
-r, --repeat-fail
Repeat the selected test cases on failure. This option caues the executable to loop individual test cases when they fail, but allows the test sequence to continue when an individual test case succeeds. This option is useful in conjunction with --onetest and --client or --server when the other end of the test is being executed manually.
-f, --fast [SCALE]
When this option is present, test cases are run faster by the integer scaling factor SCALE. If SCALE is not provided, then the default scale factor is 50. This has the effect of scaling timers both in the implementation under test as well as in the test suite. If the scale factor, SCALE, is too large, test cases may fail that would otherwise pass. This option is useful for long test suite runs that would otherwise take an inordinate amount of time to execute. Timers can be scaled for development, diagnostic or regression testing, however, for full validation testing this option should not be used.
-s, --summary
Print a test case summary with each test case result at the end of the test suite run. The default if this option is not present is to not print a summary.
-m, --messages
Indicates whether messages, in hexadecimal, should be included in the test case output. This is independent of any --verbose setting.

DIAGNOSTICS

When test-streams fails, it prints a diagnostic message to stderr and exits with a non-zero return code. The following return codes are generated under the following conditions:

0
Execution was successful. One test case was selected for execution and that test case succeeded or was not applicable (i.e. unsupported). This exit code is interpreted by autotest as a PASS condition.
1
One test case was selected for execution and that test case failed or was inconclusive. More than one test case was selected and abort on failure was specified using the --exit option, and a test case in the selected test cases failed or was inconclusive. This exit code is interpreted by autotest as a FAIL or XFAIL condition.
2
An invalid parameter was provided. Test case execution was specified with options --onetest or --tests, or listing of test cases was specified with option --list, but no test case was selected by these options. More than one test case was selected for execution and a check of the test suite setup failed. This exit code is interpreted by autotest as a FAIL or XFAIL condition.
77
One test case was selected for execution and that test case was skipped. This exit code is interpreted by autotest as a SKIPPED condition.

NOTICES

test-streams is normally invoked from the OpenSS7-0.9.2 test suite.

EXAMPLES

test-streams --list 0.1
Generates a list of all test cases provided by the test-streams executable with numbers starting with the initial substring of 0.1.
test-streams -vv --list
Generates a verbose listing of all test cases provided by the test-streams executable.
test-streams --verbose=5 --onetest 0.1
Verbosely executes test case 0.1, and provides a diagnostic return code.
test-streams --fast --quiet --exit
Executes all test cases with a timer scaling factor of 50 with normal output suppressed and exiting on the first failed or inconclusive test case result.

DRIVERS

echo(4), nuls(4).

MODULES

nullmod(4).

FILES

/usr/libexec/OpenSS7/test-streams
contains the test-streams command.

SEE ALSO

STREAMS(4), The OpenSS7 Project Installation and Reference Manual.

BUGS

test-streams has no known bugs.

COMPATIBILITY

The test-streams test suite, when run using autotest, is compatible with the POSIX 1003.3 conformance test methodology, with the following mapping of test results:


POSIX 1003.3test-streamsautotest

PASSPASS(0)PASS
FAILFAIL(1)FAIL
XFAILFAIL(1)XFAIL
UNSUPPORTEDNOT APPLICABLE(0)PASS
UNRESOLVEDINCONCLUSIVE(1)FAIL or XFAIL
UNTESTEDSKIPPED(77)SKIPPED

CONFORMANCE

test-streams tests conformance of STREAMS(4) to the specifications listed on the STREAMS(4) manual page.

HISTORY

test-streams is provided with the The OpenSS7 Project package.

IDENTIFICATION

The OpenSS7 Project: Package OpenSS7 version 0.9.2 released Thu, 14 Dec 2017 02:59:06 GMT.

Copyright©1997-2008OpenSS7 Corp.
All Rights Reserved.
(See roff source for permission notice.)



Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
Command Options
General Options
Test Case Options
DIAGNOSTICS
NOTICES
EXAMPLES
DRIVERS
MODULES
FILES
SEE ALSO
BUGS
COMPATIBILITY
CONFORMANCE
HISTORY
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 02:59:06 GMT, December 14, 2017
OpenSS7
SS7 for the
Common Man
Home TopIndex FirstPrev Next LastMore Download Info FAQ Mail  Home -> Documentation -> Man Pages -> Manual Page
Last modified: Mon, 28 Apr 2008 12:53:44 GMT
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.