nptl.BullOpenSource.Org

tHeDoc · Posted: Tue Aug 17, 2004 9:10 am Post subject: pthread_create

POSIX

POSIX is a registered trademark from the IEEE. The following assertions are derived from copyrighted material. Original text and copyright information can be found at http://www.opengroup.org.

Here is what POSIX requires for this function:

The function creates a new thread within the process.
The new thread is created with the attr attribute, or default attribute if attr is NULL.
Once the thread is created, other changes to the attr object don't affect the thread.
The ID of the new thread is stored in the thread argument.
The new thread executes the start_routine function with arg as an argument.
The signal mask of the new thread is inherited from the calling thread.
The new thread has no pending signal.
If the current thread has an alternate stack, the new thread does not inherit this stack.
The floating-point environment is inherited from the creating thread.
If the system lacks a resource or PTHREAD_THREADS_MAX threads already exist in the process, EAGAIN shall be returned and no thread is created.
The function does not return EINTR.

tHeDoc · Posted: Tue Aug 17, 2004 10:09 am Post subject: Conformance Status

Conformance Status

Assertion 1 is partially tested in PTS. A new testcase will be written to test that the new thread really executes and is in the same process (but in a different thread).
Assertion 2 is partially tested in PTS. A new testcase will be written to check that schedparam (if supported), stack (size and address) and detachstate (already tested in PTS) are are conform to the default or to what have been specified (defaul value is read from a fresh-initialized pthread_attr_t object).
Assertion 3 is also partially tested in PTS. A new testcase will be written to check that changes to the detachstate, stack or schedparam in the attr object don't affect the thread previously created with those attributes.
Assertion 4 is already tested in PTS and does not need more testing.
Assertion 5 feature being widely used everywhere in the testsuite, additional testing is not useful (but the PTS tests for this feature are really suspicious ).
Assertions 6 and 7 are tested partially in PTS (8-1.c). A new testcase will be written to deal with non-default attribute threads.
Assertion 8 is not currently tested. A new testcase will be created.
Assertion 9 is not tested yet. Same comment as in PTS: "floating-point environment?"
Assertion 10 is not properly tested yet. It will be tested in a scalability test.
Assertion 11 is not tested yet in the PTS. A new test will be created.

tHeDoc · Posted: Fri Aug 20, 2004 4:03 pm Post subject: Scalability status

Scalability Status

A new scalability sample will be written to discover if the thread creation time depends on the # of threads running (with several threads attributes).

tHeDoc · Posted: Fri Aug 20, 2004 4:06 pm Post subject: Stress Status

Stress Status

As every other stress tests use this routine, a dedicated stress sample is not required.

tHeDoc · Posted: Tue Sep 14, 2004 8:55 am Post subject: Conformance tests

Conformance tests

The following tests have been added to the Open POSIX Testsuite:

1-4.c (tests for assertion 1)
1-5.c (tests for assertion 2)
1-6.c (tests for assertion 2)
3-2.c (tests for assertion 3)
8-2.c (tests for assertions 6 and 7)
14-1.c (tests for assertion 11)
15-1.c (tests for assertion 8 )

tHeDoc · Posted: Fri Sep 17, 2004 4:09 pm Post subject: Scalability test

Scalability test

A new scalability test has been submitted to Open POSIX Test Suite. It is located here:
s-c1.c

As usual, the test can be compiled with -DPLOT_OUTPUT to generate data suitable for the do_plot script. Below is an example of such output.