The
pthread_mutex_timedlock ();
function will lock
Fa mutex .
If it is already locked the calling thread will block until
the mutex becomes available or
the timeout,
specified by abs_timeout,
expires.
The time of the timeout is an absolute time and
is not relative to the current time.
RETURN VALUES
If successful,
pthread_mutex_timedlock ();
will return zero, otherwise an error number will be returned to
indicate the error.
ERRORS
The
pthread_mutex_timedlock ();
function will fail if:
Bq Er EINVAL
The
Fa mutex
was created with the protocol attribute having the
value PTHREAD_PRIO_PROTECT and
the calling thread's priority is higher than the
mutex's current priority ceiling.
Bq Er EINVAL
The process or thread would have blocked, and
Fa abs_timeout
specified a nanosecond value less than zero or
greater than or equal to 1 billion.
Bq Er EINVAL
The
Fa mutex
parameter is invalid.
Bq Er ETIMEDOUT
The
Fa mutex
could not be locked before the timeout expired.
Bq Er EAGAIN
The
Fa mutex
could not be acquired because the
maximum number of recursive locks for the
Fa mutex
has been exceeded.
