Lines Matching +full:test +full:- +full:results
23 .\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
34 .TH TST_RES 3 01/21/2011 "Linux Test Project"
36 tst_resm \- Print result message
38 tst_resm_hexd \- Print result message, including specified buffer in hexadecimal format
40 tst_brkm \- Print result message and break remaining test cases
42 tst_old_flush \- Print any messages pending because of CONDENSE mode, and flush output stream
44 tst_exit \- Exit test with a meaningful exit value
46 tst_environ \- Keep results coming to original stdout
48 \fB#include "test.h"\fR
72 This library of functions are used by UNICOS tests to report results to
74 library have a distinct number of test cases, and that each test case is
75 distinct and uniquely identified by the test case number. It is also assumed
76 that test case results are printed in consecutive order, starting with 1.
79 results and to keep track of the current result reporting state (i.e. how many
80 total test cases there are, and how many have been reported so far) for the
81 calling test.
86 \fBTST_TOTAL\fR must be set to the total number of test cases that will be
90 tst_res.o. \fBtst_count\fR is the running count of the number of test
91 results that have been reported so far. The library initializes it to 0, and
92 it should not be modified by the test.
98 test result type; one of \fBTPASS, TFAIL, TBROK, TCONF, TWARN\fR, or
107 pointer to a character string containing a message explaining the test
108 result. This character string can contain percent-sign conversion
118 exiting the test or some function executed at the end of each iteration of a
128 The possible test result types defined in \fBtest.h\fR are as follows:
132 The test case produced expected results.
135 The test case produced unexpected results.
138 A resource needed to execute the test case was not available (e.g. a
142 The test case was not appropriate for the current hardware or software
147 test results (e.g. a temporary file could not be removed after all test
148 results were recorded).
151 An informative message about the execution of the test that does not
152 correspond to a test case result and does not indicate a problem.
157 result reporting functions. They report 1 or more test case results of the
159 \fBtst_range\fR global variable indicates the number of results that will be
161 library to 1, but may be set to a value > 1 by the test. Each call to one of
162 these functions will result in \fBtst_range\fR test case results being
166 \fBtst_brk()\fR and \fBtst_brkm()\fR are used to report results for all test
167 cases remaining in the test, and then call a cleanup function. The only
171 followed by results of type \fBTBROK\fR for the remaining test cases. When
173 \fIttype\fR will be printed for all remaining test cases. If \fIfunc\fR is
175 results have been printed. If the call to \fIfunc\fR returns,
178 after all results have been printed. If \fBtst_brk()\fR is called with a
183 \fBtst_old_flush()\fR is used to print any results pending because of
188 value. A bit is set in the exit value for each of the non passing test
191 corresponding result flag was used at least once in the test run.
216 on the test program exit status.
218 \fBtst_environ()\fR is used to ensure that results reported by this library
219 will go to the original stdout, even if the test changes the original stdout
220 to another file, or closes it. A test may want to do this in order to
222 file. \fBtst_environ()\fR returns 0 upon successful completion, and -1 if it
228 of the test in order to have any effect (see \fBksh\fR(1) for information on
233 A test result output line is generated for each test result. This is the
237 Consecutive, identical PASS, FAIL, BROK, CONF, and RETR test results are
238 condensed into one output line. The test case number field contains the range
239 of results involved. WARN and INFO output lines are not condensed, but
252 #include "test.h"
254 char *TCID = "tsttcs01"; /* set test case identifier */
255 int TST_TOTAL = 15; /* set total number of test results */
261 /* a successful test result */
266 /* break all remaining test results */
273 /* exit after all test results have been passed to tst_res */
294 If an invalid test type is specified.
298 If one of the \fBtst_brk[m]()\fR routines is called with a test type
305 will be empty. This allows a test to not print a message for a result, but
313 test result order problems.