From 9b4f75ec0cc87517247b1ebf99f056808bc346b3 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Thu, 24 Jul 2008 20:44:47 +0000 Subject: 2008-07-24 Joel Sherrill PR 1291/cpukit * posix_users/mutex.t, posix_users/semaphores.t: Update tests to reflect changes required by POSIX blocking calls sometimes taking relative not absolute time. --- doc/ChangeLog | 7 +++++++ doc/posix_users/mutex.t | 4 ++++ doc/posix_users/semaphores.t | 18 ++++++++++-------- 3 files changed, 21 insertions(+), 8 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 1de9ca5831..03e87f0b3c 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2008-07-24 Joel Sherrill + + PR 1291/cpukit + * posix_users/mutex.t, posix_users/semaphores.t: Update tests to + reflect changes required by POSIX blocking calls sometimes taking + relative not absolute time. + 2008-07-15 Joel Sherrill * user/clock.t, user/dpmem.t, user/msg.t, user/part.t, user/region.t, diff --git a/doc/posix_users/mutex.t b/doc/posix_users/mutex.t index c818ee5ce2..502fa786f6 100644 --- a/doc/posix_users/mutex.t +++ b/doc/posix_users/mutex.t @@ -630,6 +630,10 @@ ceiling. @item EDEADLK The current thread already owns the mutex. +@item ETIMEDOUT +The calling thread was unable to obtain the mutex within the specified +timeout period. + @end table @subheading DESCRIPTION: diff --git a/doc/posix_users/semaphores.t b/doc/posix_users/semaphores.t index f58c1533dc..9ad7f24899 100644 --- a/doc/posix_users/semaphores.t +++ b/doc/posix_users/semaphores.t @@ -463,7 +463,7 @@ Multiprocessing is not supported in this implementation. @example int sem_timedwait( sem_t *sem, - const struct timespec *timeout + const struct timespec *abstime ); @end example @end ifset @@ -484,13 +484,15 @@ The @code{sem} argument does not refewr to a valid semaphore @end table @subheading DESCRIPTION: -This function attemtps to lock a semaphore specified by @code{sem}, and will -wait for the semaphore for an interval specified by @code{timeout}. If the -semaphore is available, then the semaphore is locked (i.e., the semaphore -value is decremented) and the function returns a value of 0. The semaphore -remains locked until released by a @code{sem_post()} call. If the semaphore -is unavailable, then the function will wait for the semaphore to become -available for the amount of time specified by @code{timeout}. + +This function attemtps to lock a semaphore specified by @code{sem}, +and will wait for the semaphore until the absolute time specified by +@code{abstime}. If the semaphore is available, then the semaphore is +locked (i.e., the semaphore value is decremented) and the function +returns a value of 0. The semaphore remains locked until released by +a @code{sem_post()} call. If the semaphore is unavailable, then the +function will wait for the semaphore to become available for the amount +of time specified by @code{timeout}. If the semaphore does not become available within the interval specified by @code{timeout}, then the function returns -1 and sets @code{errno} to EAGAIN. -- cgit v1.2.3