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. The pthread_mutex_trylock() function locks the mutex object when it is unlocked.
   
2. If the mutex is of type PTHREAD_MUTEX_RECURSIVE, and the calling thread already owns the mutex, the call is successful (the lock count is incremented).
   
3. If the mutex was already locked, the call returns EBUSY immediatly.
   
4. If the function acquired a lock, the return value is 0.
   
5. This function does not return an error code of [EINTR].
   

[tHeDoc]

Conformance Status

• Assertion 1 is tested only with default attribute mutex. A new testcase will be written.
  
• Assertion 2 is not tested yet. A new testcase will be written.
  
• Assertion 3 is tested only with default attribute mutex. A new testcase will be written.
  
• Assertion 4 can only be partially tested -- done in assertion 1. A new stress test will be written to check that the function does not return EBUSY and lock the mutex anyway.
  
• Assertion 5 is not tested yet. A new testcase will be written.
  

[tHeDoc]

Scalability Status

Scalability has no meaning for this particular routine. (The mutex general issues are already covered in other routines)

[tHeDoc]

Stress Status

A sample will be written to address the conformance issue for assertion 4. No additional sample is required for this routine.

[tHeDoc]

Conformance tests

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

• 1-2.c (tests for assertion 1)
  
• 2-1.c (tests for assertion 2)
  
• 4-2.c (tests for assertion 3)
  
• 4-3.c (tests for assertion 5)
  

[tHeDoc]

Stress test

A new stress test has been added to the Open POSIX TestSuite for this routine.

• stress.c