pthread_mutex_consistent(3c) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

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)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3