svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
pthread_mutex_consistent(3c)
Standard C Library Functions
pthread_mutex_consistent(3C)
NAME
pthread_mutex_consistent - mark state protected by robust mutex as con‐
sistent
SYNOPSIS
#include <pthread.h>
int pthread_mutex_consistent(pthread_mutex_t *mutex);
DESCRIPTION
The following applies only to mutexes that have been initialized with
the PTHREAD_MUTEX_ROBUST attribute. See pthread_mutexattr_getro‐
bust(3C).
If mutex is a robust mutex in an inconsistent state, the
pthread_mutex_consistent() function can be used to mark the state pro‐
tected by the mutex referenced by mutex as consistent again.
If the owner of a robust mutex terminates while holding the mutex, or
if the process containing the owner of the mutex unmaps the memory con‐
taining the mutex or performs one of the exec(2) functions, the mutex
becomes inconsistent and the next thread that acquires the mutex lock
is notified of the state by the return value EOWNERDEAD. In this case,
the mutex does not become normally usable again until the state is
marked consistent.
The pthread_mutex_consistent() function is only responsible for notify‐
ing the system that the state protected by the mutex has been recovered
and that normal operations with the mutex can be resumed. It is the
responsibility of the application to recover the state so it can be
reused. If the application is not able to perform the recovery, it can
notify the system that the situation is unrecoverable by a call to
pthread_mutex_unlock(3C) without a prior call to pthread_mutex_consis‐
tent(), in which case subsequent threads that attempt to lock the mutex
will fail to acquire the lock and be returned ENOTRECOVERABLE.
If the thread which acquired the mutex lock with the return value EOWN‐
ERDEAD terminates before calling either pthread_mutex_consistent() or
pthread_mutex_unlock(), the next thread that acquires the mutex lock is
notified about the state of the mutex by the return value EOWNERDEAD.
RETURN VALUES
Upon successful completion, the pthread_mutexattr_consistent() function
returns 0. Otherwise, an error value is returned to indicate the error.
ERRORS
The pthread_mutex_consistent() function will fail if:
EINVAL The current thread does not own the mutex or the mutex is not
a PTHREAD_MUTEX_ROBUST mutex having an inconsistent state
(EOWNERDEAD).
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Interface StabilityCommitted _ StandardSee stan‐
dards(7). _ MT-Level MT-Safe
SEE ALSO
exec(2), pthread_mutex_lock(3C), pthread_mutex_unlock(3C),
pthread_mutexattr_getrobust(3C), attributes(7), mutex(7), standards(7)
Oracle Solaris 11.4 16 May 2014
pthread_mutex_consistent(3C)