nptl.BullOpenSource.Org

[tHeDoc]

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:

1. sigwait selects a pending signal from set and clears this signal from the system.
   
2. sigwait selects a pending signal from set and returns this signal in sig.
   
3. If queued signals are supported, and multiple instance of the selected signal are pending, the first one is returned and others remain pending.
   
4. If no signal from set is pending, the thread is blocked until a signal from set becomes pending.
   
5. If several threads are blocked in a call to sigwait, only one is unblocked when the signal becomes pending.
   
6. If several threads are waiting for a signal and this signal is generated for a specific thread, only this thread is unblocked.
   
7. If RTS extension is supported, and several signals in the range SIGRTMIN-SIGRTMAX are selected, the lower numbered is returned first.
   
8. sigwait returns 0 when sucess.
   

[tHeDoc]

Conformance Status

Here is the coverage status in the current OPTS version:

• Assertion 1 is not tested yet. The 1-1.c testcase will be modified to check this assertion.
  
• Assertion 2 is not tested yet. The 1-1.c testcase will be modified to check this assertion also.
  
• Assertion 3 is tested in OPTS and does not need more testing.
  
• Assertion 4 is not tested yet. Test 4-1.c will be fixed to check that time has elapsed before sigwait returns.
  
• Assertion 5 is not tested yet. A new testcase will be written.
  
• Assertion 6 is not tested yet. A new testcase will be written.
  
• Assertion 7 is not tested yet. A new testcase will be written.
  
• Assertion 8 is already tested.
  

[tHeDoc]

Scalability & Stress Status

There is no need for a scalability test for this routine.

A stress test for signals subsystem is out-of-scope for our project.

[tHeDoc]

Conformance Status

The following testcases have been patched:

• 1-1.c
  
• 4-1.c
  

The following testcases have been added:

• 6-1.c
  
• 6-2.c
  
• 7-1.c