1f08c3bdfSopenharmony_ciRESULT CODES
2f08c3bdfSopenharmony_ci============
3f08c3bdfSopenharmony_ci
4f08c3bdfSopenharmony_ciPOSIX Test Suite tests all return standard result codes for ease in
5f08c3bdfSopenharmony_ciinterpreting the output.  The result code terms are taken from
6f08c3bdfSopenharmony_ciIEEE Test Methods for Measuring Conformance to POSIX (IEEE 1003.3-1991).
7f08c3bdfSopenharmony_ciThese result codes are a subset of the LSB result codes and, for
8f08c3bdfSopenharmony_ciconsistency with LSB, are given the same number.
9f08c3bdfSopenharmony_ci
10f08c3bdfSopenharmony_ciInitial Contributors:
11f08c3bdfSopenharmony_ci	ajosey REMOVE-THIS AT rdg DOT opengroup DOT org
12f08c3bdfSopenharmony_ci	julie.n.fleischer REMOVE-THIS AT intel DOT com
13f08c3bdfSopenharmony_ci	geoffrey.r.gustafson REMOVE-THIS AT intel DOT com
14f08c3bdfSopenharmony_ci
15f08c3bdfSopenharmony_ciThe PTS result codes are:
16f08c3bdfSopenharmony_ci
17f08c3bdfSopenharmony_ci#define PTS_PASS        0
18f08c3bdfSopenharmony_ci#define PTS_FAIL        1
19f08c3bdfSopenharmony_ci#define PTS_UNRESOLVED  2
20f08c3bdfSopenharmony_ci#define PTS_UNSUPPORTED 4
21f08c3bdfSopenharmony_ci#define PTS_UNTESTED    5
22f08c3bdfSopenharmony_ci
23f08c3bdfSopenharmony_ciA brief discussion of each of these follows:
24f08c3bdfSopenharmony_ci
25f08c3bdfSopenharmony_ciPTP_PASS	Used when the test executes fully with no problems and passes.
26f08c3bdfSopenharmony_ciPTP_FAIL	Used when the test executes fully, but fails.
27f08c3bdfSopenharmony_ciPTP_UNRESOLVED	Used when the test was blocked from fully completing and
28f08c3bdfSopenharmony_ci		the pass/failure results cannot be determined.
29f08c3bdfSopenharmony_ciPTP_UNSUPPORTED	Used if the test is for a conditional feature that is
30f08c3bdfSopenharmony_ci		not implemented.
31f08c3bdfSopenharmony_ciPTP_UNTESTED	Used when a feature does not have a test associated
32f08c3bdfSopenharmony_ci		with it because:
33f08c3bdfSopenharmony_ci		- The test is just a stub and doesn't do anything
34f08c3bdfSopenharmony_ci		- The test is only partially complete and can't really
35f08c3bdfSopenharmony_ci		  finish the test
36f08c3bdfSopenharmony_ci		- The test is complete in some cases, but certain things
37f08c3bdfSopenharmony_ci		  can happen that leave the test incomplete.  When these
38f08c3bdfSopenharmony_ci		  happen, it's PTP_UNTESTED.
39f08c3bdfSopenharmony_ci
40f08c3bdfSopenharmony_ciThese result codes are contained in the header file posixtest.h, located
41f08c3bdfSopenharmony_ciin the include/ directory.
42f08c3bdfSopenharmony_ci
43f08c3bdfSopenharmony_ciThis header file should be included in each test suite created.
44