65 lines
2.2 KiB
Plaintext
65 lines
2.2 KiB
Plaintext
|
|
QUICK-START
|
|
***********
|
|
|
|
So you're in a hurry and don't feel like reading all those docs in the Documentation section that we have worked so hard to write huh?
|
|
|
|
No worries! Here's a quick doc to help you around POSIX** Test Suite.
|
|
|
|
========================
|
|
Setting up your machine
|
|
========================
|
|
|
|
* There is nothing to install, the suite is intended to be run directly.
|
|
|
|
* See the "BUILD" file for info on how to set up the Makefile and your machine,
|
|
depending on what specific area you are concentrating on.
|
|
(Signals, Semaphores, Threads, Timers or Message Queues).
|
|
|
|
===================
|
|
Running the tests
|
|
===================
|
|
|
|
* Easiest way to run all the tests is to do a "make all" in the top-level
|
|
directory.
|
|
|
|
* To run tests for a specific directory, do the following
|
|
- make generate-makefiles # only required for the first shot.
|
|
- cd <subdir> ; make all test
|
|
|
|
Example:
|
|
|
|
- make generate-makefiles
|
|
- cd conformance/interfaces/pthread_create ; make all test
|
|
|
|
* Running tests for a specific focus can be done like so:
|
|
run-posix-option-group-test.sh [OPTION-GROUP]
|
|
|
|
* For additional information on how to build and run the tests in this
|
|
suite, see Documentation/HOWTO_RunTests.
|
|
|
|
==========================
|
|
Documentation & Resources
|
|
==========================
|
|
|
|
POSIX* Test Suite project page: http://posixtest.sf.net
|
|
|
|
BUILD - describes how to set up your developer machine to build and test
|
|
|
|
The following files give developers information on how to write test
|
|
cases for the project (under Documentation):
|
|
|
|
HOWTO_Assertions - describes format of the assertions files used to
|
|
map test case descriptions to test cases
|
|
HOWTO_BoundaryTest - information about testing boundary conditions
|
|
HOWTO_CodingGuidelines - describes coding guidelines for this project
|
|
HOWTO_Coverage - describes format of COVERAGE.<area> files
|
|
HOWTO_DefinitionsTest - ideas behind testing POSIX header files
|
|
HOWTO_ResultCodes - standardized return codes for tests
|
|
HOWTO_Tagging - describes how to tag files for inclusion in a release
|
|
HOWTO_RunTests - describes how to build and run the tests
|
|
|
|
** POSIX (R) is a registered trademark of the IEEE
|
|
|
|
Maintainer: Ling Yu (ling.l.yu@intel.com)
|